Partilhar via

Tarefa GenerateBootstrapper

Fornece uma maneira automatizada de detetar, 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 uma aplicação.

Parâmetros da tarefa

A seguir descrevem-se os GenerateBootstrapper parâmetros da tarefa.

  • ApplicationFile

    Parâmetro opcional String .

    Especifica o arquivo que o bootstrapper usará para iniciar a instalação do aplicativo depois que todos os pré-requisitos tiverem sido instalados. Um erro de compilação resultará se nem o BootstrapperItems parâmetro nem o ApplicationFile parâmetro for especificado.

  • ApplicationName

    Parâmetro opcional String .

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

  • ApplicationRequiresElevation

    Parâmetro opcional Boolean .

    Se true, o componente é executado com permissões elevadas quando instalado em um computador de destino.

  • ApplicationUrl

    Parâmetro opcional String .

    Especifica o local da Web que está hospedando o instalador do aplicativo.

  • BootstrapperComponentFiles

    Parâmetro de saída opcional String[] .

    Especifica o local criado dos arquivos de pacote do bootstrapper.

  • BootstrapperItems

    Parâmetro opcional ITaskItem[] .

    Especifica os produtos a serem criados no bootstrapper. Os itens passados para este parâmetro devem ter a seguinte sintaxe:

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

    O Include atributo representa o nome de um pré-requisito que deve ser instalado. Os ProductName metadados do item são opcionais e serão usados pelo mecanismo de compilação como um nome amigável se o pacote não puder ser encontrado. Esses itens não são parâmetros de entrada necessários do MSBuild, a menos que nenhum ApplicationFile seja especificado. Você deve incluir um item para cada pré-requisito que deve ser instalado para seu aplicativo.

    Um erro de compilação resultará se nem o BootstrapperItems parâmetro nem o ApplicationFile parâmetro for especificado.

  • BootstrapperKeyFile

    Parâmetro de saída opcional String .

    Especifica o local interno do setup.exe

  • ComponentsLocation

    Parâmetro opcional String .

    Especifica um local para o bootstrapper procurar os pré-requisitos de instalação a serem instalados. 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 pré-requisito está no mesmo local do aplicativo.

    • Absolute: Indica que todos os componentes devem ser encontrados em uma URL centralizada. Este 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

    Parâmetro opcional String .

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

  • CopyComponents

    Parâmetro opcional Boolean .

    Se true, o bootstrapper copia todos os arquivos de saída para o caminho especificado no OutputPath parâmetro. Os valores do BootstrapperComponentFiles parâmetro devem ser todos baseados neste caminho. Se false, os arquivos não são copiados e os BootstrapperComponentFiles valores são baseados no valor do Path parâmetro. O valor padrão desse parâmetro é true.

  • Culture

    Parâmetro opcional String .

    Especifica a cultura a ser usada para a interface do usuário do bootstrapper e os pré-requisitos de instalação. Se a cultura especificada não estiver disponível, a tarefa usará o valor do FallbackCulture parâmetro.

  • FallbackCulture

    Parâmetro opcional String .

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

  • OutputPath

    Parâmetro opcional String .

    Especifica o local para copiar setup.exe e todos os arquivos de pacote.

  • Path

    Parâmetro opcional String .

    Especifica o local de todos os pacotes de pré-requisitos disponíveis.

  • SupportUrl

    Parâmetro opcional String .

    Especifica a URL a ser fornecida se a instalação do bootstrapper falhar.

  • Validate

    Parâmetro opcional Boolean .

    Se true, o bootstrapper executa a validação XSD nos itens de bootstrapper de entrada especificados. O valor padrão desse parâmetro é false.

Observações

Além dos parâmetros listados acima, essa tarefa herda parâmetros da TaskExtension classe, que herda da Task classe. Para obter uma lista desses parâmetros adicionais e suas descrições, consulte Classe base TaskExtension.

Example

O exemplo a seguir usa a GenerateBootstrapper tarefa para instalar um aplicativo que deve ter o .NET Framework 4.8 instalado como pré-requisito.

<ItemGroup>
  <BootstrapperFile Include="Microsoft.Net.Framework.4.8">
    <ProductName>.NET Framework 4.8</ProductName>
  </BootstrapperFile>
</ItemGroup>

<Target Name="CustomBootstrapper">
  <GenerateBootstrapper
    ApplicationFile="MyApp.exe"
    BootstrapperItems="@(BootstrapperFile)"
    OutputPath="$(OutputPath)"
    ComponentsLocation="Relative" />
</Target>

Consulte também

  • Last updated on