Compartilhar via


Tarefa GenerateBootstrapper

Fornece uma maneira automatizada para detectar, baixar e instalar um aplicativo e seus pré-requisitos. Ela serve sistema autônomo um único instalador que integra sistema autônomo instaladores para todos sistema autônomo componentes que compõem um aplicativo separados.

Parâmetros da tarefa

A tabela a seguir descreve os parâmetros do GenerateBootstrapper tarefa.

Parâmetro

Descrição

ApplicationFile

Opcional String parâmetro.

Especifica o arquivo que usará o bootstrapper para começar a instalação do aplicativo depois que todos os pré-requisitos foram instalados. Isso resultará em um erro de compilação se nenhuma do BootstrapperItems nem o ApplicationFile parâmetro especificado.

ApplicationName

Opcional String parâmetro.

Especifica o nome do aplicativo que instalará o bootstrapper. Esse nome será exibido na interface do usuário usa o bootstrapper durante a instalação.

ApplicationUrl

Opcional String parâmetro.

Especifica o local da Web que hospeda o instalador do aplicativo.

BootstrapperComponentFiles

Opcional String[] parâmetro de saída.

Especifica o local dos arquivos de pacote de bootstrapper interno.

BootstrapperItems

Opcional ITaskItem[] parâmetro.

Especifica os produtos para promover o bootstrapper. Os itens passados para esse parâmetro devem ter a seguinte sintaxe:

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

The Include atributo é usado para representar o nome de um pré-requisito que deve ser instalado. The ProductName metadados de item é opcional e serão usado pelo mecanismo de compilação sistema autônomo um nome amigável do usuário caso o pacote não foi encontrado. Esses itens não são necessários MSBuild parâmetros de entrada, a menos que nenhum ApplicationFile foi especificado. Você deve incluir um item para cada pré-requisito que deve ser instalado para o seu aplicativo.

Isso resultará em um erro de compilação se nenhuma do BootstrapperItems nem o ApplicationFile parâmetro especificado.

BootstrapperKeyFile

Opcional String parâmetro de saída.

Especifica o local interno de setup.exe

ComponentsLocation

Opcional String parâmetro.

Especifica um local para o bootstrapper Procurar pré-requisitos de instalação instalar. Este parâmetro pode ter os seguintes valores:

  • HomeSite: Indica que o pré-requisito está sendo hospedado pelo fornecedor do componente.

  • Relative: Indica que o preqrequisite está no mesmo local do aplicativo.

  • Absolute: Indica que todos os componentes devem ser encontradas em uma URL centralizada. Esse valor deve ser usado em conjunto com o ComponentsUrl parâmetro de entrada.

If ComponentsLocation não for especificado, HomeSite é usado por padrão.

ComponentsUrl

Opcional String parâmetro.

Especifica a URL que contém os pré-requisitos de instalação.

CopyComponents

Opcional Boolean parâmetro.

If true, o bootstrapper copia todos os arquivos de saída para o caminho especificado na OutputPath parâmetro. Os valores do BootstrapperComponentFiles parâmetro deve todos ser baseado nesse caminho. If false, os arquivos não são copiados e o BootstrapperComponentFiles valores são com base no valor da Path parâmetro. O valor padrão deste parâmetro é true.

Culture

Opcional String parâmetro.

Especifica a cultura a ser usado para o bootstrapper UI e pré-requisitos de instalação. Se a cultura especificada é unavailabe, a tarefa usa o valor do FallbackCulture parâmetro.

FallbackCulture

Opcional String parâmetro.

Especifica a cultura a ser usado para a interface do usuário bootstraper e pré-requisitos de instalação secundária.

OutputPath

Opcional String parâmetro.

Especifica o local de cópia setup.exe e todos os arquivos de pacote.

Path

Opcional String parâmetro.

Especifica o local de todos os pacotes pré-requisito disponível.

SupportUrl

Opcional String parâmetro.

Especifica a URL para fornecer a instalação bootstrapper falhar

Validate

Opcional Boolean parâmetro.

If true, o bootstrapper executa a validação XSD nos itens bootstrapper entrada especificada. O valor padrão deste parâmetro é false.

Exemplo

O exemplo a seguir utiliza o GenerateBootstrapper tarefa de instalar um aplicativo deve ter o .NET Framework 2,0 instalado sistema autônomo um pré-requisito.

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

Consulte também

Conceitos

Tarefas do MSBuild

Outros recursos

Referência de tarefa do MSBuild