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