Attività GenerateBootstrapper
Aggiornamento: novembre 2007
Viene fornita una procedura per individuare, scaricare e installare in modo automatico 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 generazione. |
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. |
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 generato dei file del package del programma di avvio automatico. |
BootstrapperItems |
Parametro ITaskItem[] facoltativo. Specifica i prodotti da generare 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 generazione 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 generazione. |
BootstrapperKeyFile |
Parametro di output String facoltativo. Specifica il percorso generato 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 la lingua da utilizzare per l'interfaccia utente del programma di avvio automatico e i prerequisiti di installazione. Se la lingua specificata non è disponibile, verrà utilizzato il valore del parametro FallbackCulture. |
FallbackCulture |
Parametro String facoltativo. Specifica la lingua secondaria 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. |
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>