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: 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:
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>