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:

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

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

Vedere anche

Concetti

Attività di MSBuild

Altre risorse

Riferimenti delle attività MSBuild