GenerateBootstrapper (attività)

  • Articolo

Consente di rilevare, scaricare e installare automaticamente un'applicazione e i relativi prerequisiti. Funge da programma di installazione singolo che integra i programmi di installazione separati per tutti i componenti che costituiscono un'applicazione.

Parametri dell'attività

Di seguito vengono descritti i parametri dell'attività GenerateBootstrapper.

  • ApplicationFile

    Parametro String facoltativo.

    Specifica il file che verrà usato dal programma di avvio automatico per iniziare l'installazione dell'applicazione dopo l'installazione di tutti i prerequisiti. Se non si specifica il parametro BootstrapperItems o ApplicationFile, si verificherà un errore di compilazione.

  • ApplicationName

    Parametro String facoltativo.

    Specifica il nome dell'applicazione che verrà installata dal programma di avvio automatico. Questo nome verrà visualizzato nell'interfaccia utente usata dal programma di avvio automatico durante l'installazione.

  • ApplicationRequiresElevation

    Parametro Boolean facoltativo.

    Se true, il componente viene eseguito con autorizzazioni elevate quando viene installato in un computer di destinazione.

  • ApplicationUrl

    Parametro String facoltativo.

    Specifica il percorso Web che ospita il programma di installazione dell'applicazione.

  • BootstrapperComponentFiles

    Parametro di output String[] facoltativo.

    Specifica il percorso predefinito dei file di pacchetto del programma di avvio automatico.

  • BootstrapperItems

    Parametro ITaskItem[] facoltativo.

    Specifica i prodotti da compilare nel programma di avvio automatico. Gli elementi passati a questo parametro devono avere la sintassi seguente:

    <BootstrapperItem
    Include="ProductCode">
    <ProductName>
        ProductName
    </ProductName>
</BootstrapperItem>

    L'attributo Include rappresenta il nome di un prerequisito che deve essere installato. I metadati dell'elemento ProductName sono facoltativi e vengono usati dal motore di compilazione come nome descrittivo se non è possibile trovare il pacchetto. Questi elementi non sono obbligatori per i parametri di input di MSBuild, a meno che non non sia specificato alcun elemento ApplicationFile . È consigliabile includere un elemento per ogni prerequisito che deve essere installato per l'applicazione.

    Se non si specifica il parametro BootstrapperItems o ApplicationFile, si verificherà un errore di compilazione.

  • BootstrapperKeyFile

    Parametro di output String facoltativo.

    Specifica il percorso di compilazione del file setup.exe

  • ComponentsLocation

    Parametro String facoltativo.

    Specifica il percorso in cui il programma di avvio automatico esegue la ricerca dei prerequisiti di installazione. Per il parametro è possibile specificare i valori seguenti:

    • HomeSite: indica che il prerequisito è ospitato dal fornitore del componente.

    • Relative: indica che il prerequisito è nella stessa posizione dell'applicazione.

    • Absolute: indica che tutti i componenti devono trovarsi in un URL centralizzato. Questo valore deve essere usato con il parametro di input ComponentsUrl.

      Se ComponentsLocation non è specificato, per impostazione predefinita viene usato HomeSite.

  • ComponentsUrl

    Parametro String facoltativo.

    Specifica l'URL che contiene i prerequisiti di installazione.

  • CopyComponents

    Parametro Boolean facoltativo.

    Se true, il programma di avvio automatico copia tutti i file di output nel percorso specificato nel parametro OutputPath. I valori del parametro BootstrapperComponentFiles devono essere tutti basati su questo percorso. Se false, i file non vengono copiati e i valori di BootstrapperComponentFiles si basano sul valore del parametro Path. Il valore predefinito di questo parametro è true.

  • Culture

    Parametro String facoltativo.

    Specifica le impostazioni cultura da usare per i prerequisiti relativi all'interfaccia utente del programma di avvio automatico e all'installazione. Se le impostazioni cultura specificate non sono disponibili, l'attività usa il valore del parametro FallbackCulture.

  • FallbackCulture

    Parametro String facoltativo.

    Specifica le impostazioni cultura secondarie da usare per l'interfaccia utente di avvio e i prerequisiti di installazione.

  • OutputPath

    Parametro String facoltativo.

    Specifica il percorso in cui copiare setup.exe e tutti i file di pacchetto.

  • Path

    Parametro String facoltativo.

    Specifica il percorso di tutti i pacchetti dei prerequisiti disponibili.

  • SupportUrl

    Parametro String facoltativo.

    Specifica l'URL da implementare se l'installazione del programma di avvio automatico ha esito negativo.

  • Validate

    Parametro Boolean facoltativo.

    Se true, il programma di avvio automatico esegue la convalida XSD sugli elementi del programma di avvio automatico di input specificati. Il valore predefinito di questo parametro è false.

Osservazioni:

Oltre ai parametri elencati sopra, questa attività eredita i parametri dalla classe TaskExtension, che a sua volta eredita dalla classe Task. Per un elenco di questi parametri aggiuntivi e le rispettive descrizioni, vedere TaskExtension Base Class.

Esempio

L'esempio seguente usa l'attività GenerateBootstrapper per installare un'applicazione che deve avere .NET Framework 2.0 installato come prerequisito.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

    <ItemGroup>
        <BootstrapperFile Include="Microsoft.Net.Framework.2.0">
            <ProductName>Microsoft .NET Framework 2.0</ProductName>
        </BootstrapperFile>
    </ItemGroup>

    <Target Name="BuildBootstrapper">
        <GenerateBootstrapper
            ApplicationFile="WindowsApplication1.application"
            ApplicationName="WindowsApplication1"
            ApplicationUrl="http://mycomputer"
            BootstrapperItems="@(BootstrapperFile)"
            OutputPath="C:\output" />
    </Target>

</Project>

Vedi anche