Compartilhar via

Tarefa GenerateBootstrapper

Fornece uma maneira automatizada de 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 de tarefa

A seguir, descreva os parâmetros da GenerateBootstrapper 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 build 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 será exibido na interface do usuário que o bootstrapper usa durante a instalação.

  • ApplicationRequiresElevation

    Parâmetro opcional Boolean .

    Se trueo componente for executado com permissões elevadas quando estiver instalado em um computador de destino.

  • ApplicationUrl

    Parâmetro opcional String .

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

  • BootstrapperComponentFiles

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

    Especifica o local interno dos arquivos do pacote bootstrapper.

  • BootstrapperItems

    Parâmetro opcional ITaskItem[] .

    Especifica os produtos a serem compilados no bootstrapper. Os itens passados para esse 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 build como um nome amigável se o pacote não puder ser encontrado. Esses itens não são necessários para parâmetros de entrada 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 build 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. Esse 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. Esse valor deve ser usado em conjunto com o ComponentsUrl parâmetro de entrada.

      Se ComponentsLocation não for especificado, HomeSite será 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 copiará todos os arquivos de saída para o caminho especificado no OutputPath parâmetro. Todos os valores do BootstrapperComponentFiles parâmetro devem ser baseados nesse caminho. Se falseos arquivos não forem copiados e os BootstrapperComponentFiles valores forem 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é-requisito 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 executará 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 a 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 um 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