Attività GenerateBootstrapper

Offre un metodo automatico per individuare, scaricare e installare un'applicazione e i relativi prerequisiti. L'attività funge da programma di installazione unico che integra i programmi di installazione separati di tutti i componenti che costituiscono un'applicazione.

Parametri dell'attività

Nella tabella riportata di seguito sono descritti i parametri dell'attività GenerateBootstrapper.

Parametro	Descrizione
ApplicationFile	Parametro String facoltativo. Specifica il file che verrà utilizzato dal programma di avvio automatico per iniziare l'installazione dell'applicazione dopo che sono stati installati tutti i prerequisiti. Se non sono stati specificati né il parametro BootstrapperItems né il parametro ApplicationFile, si verificherà un errore di compilazione.
ApplicationName	Parametro String facoltativo. Specifica il nome dell'applicazione che verrà installata dal programma di avvio automatico. Tale nome verrà visualizzato nell'interfaccia utente utilizzata dal programma di avvio automatico durante l'installazione.
ApplicationRequiresElevation	Parametro Boolean facoltativo. Se true, il componente viene eseguito con autorizzazioni elevate quando è installato in un computer di destinazione.
ApplicationUrl	Parametro String facoltativo. Specifica il percorso Web in cui si trova il programma di installazione dell'applicazione.
BootstrapperComponentFiles	Parametro di output String[] facoltativo. Specifica il percorso compilato dei file del package 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 viene utilizzato per rappresentare il nome di un prerequisito che dovrebbe essere installato. I metadati dell'elemento ProductName sono facoltativi e verranno utilizzati dal modulo di gestione della compilazione come nome descrittivo nel caso in cui non si riesca a trovare il package. Tali elementi non sono parametri di input MSBuild obbligatori, a meno che non venga specificato alcun ApplicationFile. È necessario includere un solo elemento per ogni prerequisito che deve essere installato per l'applicazione. Se non sono stati specificati né il parametro BootstrapperItems né il parametro ApplicationFile, si verificherà un errore di compilazione.
BootstrapperKeyFile	Parametro di output String facoltativo. Specifica il percorso compilato 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 i prerequisiti si trovano nel fornitore del componente. Relative: indica che i prerequisiti si trovano nello stesso percorso dell'applicazione. Absolute: indica che tutti i componenti si trovano in un URL centralizzato. Questo valore deve essere utilizzato insieme al parametro di input ComponentsUrl. Se ComponentsLocation non è specificato, viene utilizzato HomeSite per impostazione predefinita.
ComponentsUrl	Parametro String facoltativo. Specifica l'URL contenente i prerequisiti di installazione.
CopyComponents	Parametro Boolean facoltativo. Se questo parametro è true, il programma di avvio automatico copia tutti i file di output nel percorso specificato nel parametro OutputPath. I valori del parametro BootstrapperComponentFiles si devono basare tutti su questo percorso. Se il parametro è false, i file non vengono copiati e i valori BootstrapperComponentFiles si basano sul valore del parametro Path. Il valore predefinito del parametro è true.
Culture	Parametro String facoltativo. Specifica le impostazioni cultura da utilizzare per l'interfaccia utente del programma di avvio automatico e i prerequisiti di installazione. Se le impostazioni cultura specificate non sono disponibili, verrà utilizzato il valore del parametro FallbackCulture.
FallbackCulture	Parametro String facoltativo. Specifica le impostazioni cultura secondarie da utilizzare per l'interfaccia utente del programma di avvio automatico e i prerequisiti di installazione.
OutputPath	Parametro String facoltativo. Specifica il percorso in cui copiare setup.exe e tutti i file del package.
Path	Parametro String facoltativo. Specifica il percorso di tutti i package prerequisiti disponibili.
SupportUrl	Parametro String facoltativo. Specifica l'URL da fornire nel caso in cui l'installazione del programma di avvio automatico non riesca.
Validate	Parametro Boolean facoltativo. Se il parametro è true, il programma di avvio automatico esegue la convalida XSD sugli elementi del programma di avvio automatico di input specificati. Il valore predefinito del parametro è false.

Note

Oltre ai parametri sopra elencati, questa attività eredita i parametri dalla classe TaskExtension, che eredita dalla classe Task. Per un elenco di tali parametri aggiuntivi e le relative descrizioni, vedere Classe di base TaskExtension.

Esempio

Nell'esempio riportato di seguito l'attività GenerateBootstrapper viene utilizzata per l'installazione di un'applicazione per cui l'installazione di .NET Framework 2.0 costituisce un prerequisito.

<Project xmlns="https://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>

Vedere anche

Concetti

Attività di MSBuild

Altre risorse

Riferimenti delle attività MSBuild