Tarefa GenerateBootstrapper

Fornece uma maneira automatizada para detectar, baixar e instalar um aplicativo e seus pré-requisitos.Ele serve como um único instalador que integra os instaladores separados para todos os componentes que compõem um aplicativo.

Parâmetros da tarefa

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

Parâmetro	Descrição
ApplicationFile	Opcional String parâmetro. Especifica o arquivo que o bootstrapper usará para iniciar a instalação do aplicativo depois que todos os pré-requisitos foram instalados.Um erro de compilação resultará caso nem a BootstrapperItems nem a ApplicationFile parâmetro for especificado.
ApplicationName	Opcional String parâmetro. Especifica o nome do aplicativo que instalará o bootstrapper.Esse nome aparecerá na interface de usuário o bootstrapper usa durante a instalação.
ApplicationRequiresElevation	Opcional Boolean parâmetro. Se true, o componente é executado com permissões elevadas quando ele é instalado em um computador de destino.
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 interno dos arquivos de pacote bootstrapper.
BootstrapperItems	Opcional ITaskItem[] parâmetro. Especifica os produtos para promover o bootstrapper.Os itens passados para este parâmetro devem ter a seguinte sintaxe: <BootstrapperItem Include="ProductCode"> <ProductName> ProductName </ProductName> </BootstrapperItem> O Include atributo é usado para representar o nome de um pré-requisito que deve ser instalado.O ProductName metadados do item é opcional e será usado pelo mecanismo de compilação como um nome amigável no caso do pacote não foi encontrado.Esses itens não são necessários MSBuild parâmetros de entrada, a menos que não ApplicationFile é especificado.Você deve incluir um item para cada pré-requisito que deve ser instalado para o seu aplicativo. Um erro de compilação resultará caso nem a BootstrapperItems nem a ApplicationFile parâmetro for especificado.
BootstrapperKeyFile	Opcional String parâmetro de saída. Especifica o local interno do Setup. exe
ComponentsLocation	Opcional String parâmetro. Especifica um local para o bootstrapper procurar os 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. Se 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. Se true, o bootstrapper copia todos os arquivos de saída para o caminho especificado na OutputPath parâmetro.Os valores da BootstrapperComponentFiles parâmetro deve ser baseado no caminho.Se false, os arquivos não são copiados e o BootstrapperComponentFiles valores baseiam-se 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 interface do usuário e os pré-requisitos de instalação.Se a cultura especificada não disponível, a tarefa usa o valor da FallbackCulture parâmetro.
FallbackCulture	Opcional String parâmetro. Especifica a cultura secundária a ser usado para o bootstraper da interface do usuário e os pré-requisitos de instalação.
OutputPath	Opcional String parâmetro. Especifica o local para o arquivo Setup. exe de cópia e todos os arquivos de pacote.
Path	Opcional String parâmetro. Especifica o local de todos os pacotes de pré-requisito disponíveis.
SupportUrl	Opcional String parâmetro. Especifica a URL para fornecer a instalação bootstrapper falhar
Validate	Opcional Boolean parâmetro. Se true, o bootstrapper executa a validação XSD nos itens bootstrapper entrada especificada.O valor padrão deste parâmetro é false.

Comentários

Com os parâmetros listados acima, esta tarefa herda os parâmetros da TaskExtension herda de classe, que por si só a Task classe.Para obter uma lista desses parâmetros adicionais e suas descrições, consulte Classe Base TaskExtension.

Exemplo

O exemplo a seguir usa a GenerateBootstrapper tarefa para instalar um aplicativo que deve ter o .NET Framework 2.0 instalado como 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