Tarefa de GenerateBootstrapper

Fornece uma maneira automatizada para detectar, baixar e instalar um aplicativo e seus pré-requisitos. Ela 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 de tarefas.

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 o 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 de 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 os metadados de 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 o ApplicationFile parâmetro for 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 os pré-requisitos de instalação instalar. Este parâmetro pode ter os seguintes valores: HomeSite: Indica que o pré-requisito que está sendo hospedado pelo fornecedor do componente. Relative: Indica que o preqrequisite está no mesmo local do aplicativo. Absolute: Indica que todos os componentes são 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 de BootstrapperComponentFiles parâmetro deve ser baseado nesse 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 de pré-requisitos de instalação. Se a cultura especificada não disponível, a tarefa usa o valor de FallbackCulture parâmetro.
FallbackCulture	Opcional String parâmetro. Especifica a cultura secundária para uso 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 de 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 realiza a validação XSD no itens bootstrapper de entrada especificada. O valor padrão deste parâmetro é false.

Comentários

Além de para os parâmetros listados acima, esta tarefa herda os parâmetros da TaskExtension , a própria classe herda o Task classe. Para obter uma lista desses parâmetros adicionais e suas descrições, consulte Classe Base de TaskExtension.

Exemplo

O exemplo a seguir usa a GenerateBootstrapper a tarefa de 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