GenerateBootstrapper 任务

提供一种自动化方式来检测、下载和安装应用程序及其必备组件。 作为单个安装程序，它集成了组成应用程序的所有组件的各个不同安装程序。

任务参数

下表描述了 GenerateBootstrapper 任务的参数。

Parameter	说明
ApplicationFile	可选 String 参数。 指定引导程序在所有必备组件安装完以后开始安装应用程序时使用的文件。 如果 BootstrapperItems 和 ApplicationFile 参数均未指定，则会导致生成错误。
ApplicationName	可选 String 参数。 指定引导程序将安装的应用程序的名称。 此名称将出现在引导程序在安装过程中使用的用户界面中。
ApplicationRequiresElevation	可选 Boolean 参数。 如果为 true，则在目标计算机上安装组件时，该组件使用提升的权限运行。
ApplicationUrl	可选 String 参数。 指定承载应用程序的安装程序的 Web 位置。
BootstrapperComponentFiles	可选 String[] 输出参数。 指定引导程序包文件的生成位置。
BootstrapperItems	可选 ITaskItem[] 参数。 指定要生成到引导程序中的产品。 传递给此参数的项应当遵循以下语法： <BootstrapperItem Include="ProductCode"> <ProductName> ProductName </ProductName> </BootstrapperItem> Include 特性用于表示应安装的必备组件的名称。 ProductName 项元数据是可选的，它作为备用项供生成引擎在找不到包时用作用户友好名称。 除非未指定 ApplicationFile，否则这些项不是必选 MSBuild 输入参数。 对于必须为应用程序安装的每个必备组件，都应包含一个相应的项。 如果 BootstrapperItems 和 ApplicationFile 参数均未指定，则会导致生成错误。
BootstrapperKeyFile	可选 String 输出参数。 指定 setup.exe 的生成位置
ComponentsLocation	可选 String 参数。 指定引导程序寻找要安装的安装必备组件的位置。 此参数可具有下列值： HomeSite：指示必备组件由组件供应商托管。 Relative：指示必备组件与应用程序在同一个位置。 Absolute：指示所有组件都将在一个集中的 URL 下找到。 该值应当与 ComponentsUrl 输入参数结合使用。 如果未指定 ComponentsLocation，将默认使用 HomeSite。
ComponentsUrl	可选 String 参数。 指定包含安装必备组件的 URL。
CopyComponents	可选 Boolean 参数。 如果为 true，则引导程序会将所有输出文件复制到 OutputPath 参数指定的路径。 BootstrapperComponentFiles 参数的值都应当基于此路径。 如果为 false，则不复制文件，而且 BootstrapperComponentFiles 值将基于 Path 参数的值。 此参数的默认值为 true。
Culture	可选 String 参数。 指定用于引导程序用户界面和安装必备组件的区域性。 如果指定的区域性不可用，任务将使用 FallbackCulture 参数的值。
FallbackCulture	可选 String 参数。 指定用于引导程序用户界面和安装必备组件的次要区域性。
OutputPath	可选 String 参数。 指定 setup.exe 和所有包文件要复制到的位置。
Path	可选 String 参数。 指定所有可用的必备组件包的位置。
SupportUrl	可选 String 参数。 指定当引导程序安装失败时提供的 URL
Validate	可选 Boolean 参数。 如果为 true，则引导程序将对指定的输入引导程序项执行 XSD 验证。 此参数的默认值为 false。

备注

除了上面列出的参数，此任务还将从 TaskExtension 类继承参数，此类本身从 Task 类继承。 有关这些附加参数及其说明的列表，请参见 TaskExtension 基类。

示例

下面的示例使用 GenerateBootstrapper 任务安装一个应用程序，该应用程序必须将 .NET Framework 2.0 作为必备组件安装。

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

请参见

概念

MSBuild 任务

其他资源

MSBuild 任务参考