创建引导程序包

  • 项目

安装程序是可配置为检测并安装可再发行组件（如 Windows Installer (.msi) 文件和可执行程序）的一般安装程序。 安装程序也称为“引导程序”。 它通过一组 XML 清单进行编程，这些清单指定用于管理组件安装的元数据。 ClickOnce“先决条件”对话框中显示的每个可再发行组件或必备项都是引导程序包。 一个引导程序包是一组目录和文件，其中包含用于说明系统必备组件的安装方式的清单文件。

引导程序首先检测是否已安装所有系统必备组件。 如果未安装系统必备组件，引导程序将首先显示相关许可协议。 接着，在最终用户接受许可协议后，将开始安装相应的系统必备组件。 否则，如果检测到所有的系统必备组件，引导程序将直接启动应用程序的安装程序。

创建自定义引导程序包

可使用 Visual Studio 中的 XML 编辑器来生成引导程序清单。 若要查看创建引导程序包的示例，请参阅演练：创建带有隐私提示的自定义引导程序。

若要创建引导程序包，必须创建产品清单，并针对组件的每个本地化版本创建一个包清单。

  • 产品清单 product.xml，包含程序包的所有非特定语言的元数据。 它包含可再发行组件的所有本地化版本通用的元数据。 若要创建此文件，请参阅如何：创建产品清单。

  • 程序包清单 package.xml，包含特定语言的元数据；它通常包含本地化的错误消息。 必须至少为组件的每个本地化版本提供一个程序包清单。 若要创建此文件，请参阅如何：创建包清单。

在创建这两个文件之后，请将产品清单文件放置在一个依据自定义引导程序命名的文件夹中。 程序包清单文件将放置到一个依据区域设置命名的文件夹中。 例如，如果程序包清单文件针对的是英语版的再发行程序，请将该文件放置在一个名为 en 的文件夹中。 对于每个区域设置（如 ja 代表日语，de 代表德语）重复此过程。 最终的自定义引导程序包的文件夹结构将如下所示。

CustomBootstrapperPackage
  product.xml
  CustomBootstrapper.msi
  de
    eula.rtf
    package.xml
  en
    eula.rtf
    package.xml
  ja
    eula.rtf
    package.xml

下一步，将可再发行的文件复制到引导程序文件夹位置。 有关详细信息，请参阅如何：创建本地化的引导程序包。

*\Program Files (x86)\Microsoft SDKs\ClickOnce Bootstrapper\Packages*

或

*<VS Install Path>\MSBuild\Microsoft\VisualStudio\BootstrapperPackages*

注意

从 Visual Studio 2019 Update 7 版本开始，上面 Visual Studio 安装路径下列出的路径有效。

也可根据以下注册表项中的“Path”值找到引导程序文件夹位置：

*HKLM\Software\Microsoft\GenericBootstrapper*

在 64 位系统上，请使用以下注册表项：

*HKLM\Software\Wow6432Node\Microsoft\GenericBootstrapper*

每个可再发行组件均位于程序包目录下它们自己的子文件夹中。 必须将产品清单和可再发行文件放置到此子文件夹中。 必须将组件的本地化版本以及程序包清单放置到根据区域性名称命名的子文件夹中。

在将这些文件复制到引导程序文件夹中之后，相应的引导程序包将自动出现在 Visual Studio 的“系统必备”对话框中。 如果自定义引导程序包未显示，请关闭并重新打开“系统必备”对话框。 有关详细信息，请参阅 “系统必备”对话框。

下表显示由引导程序自动填充的属性。

属性 说明
ApplicationName 应用程序的名称。
ProcessorArchitecture 可执行文件的目标平台的处理器和每字位数。 包括以下值：

- Intel
- IA64
- AMD64
VersionNT Windows 操作系统的版本号。 版本的语法是 Major.Minor.ServicePack。
VersionMSI 安装期间运行的 Windows Installer 程序集 (msi.dll) 的版本。
AdminUser 如果用户具有管理员特权，则设置此属性。 值为 true 或 false。
InstallMode 安装模式指示需要安装组件的位置。 包括以下值：

- HomeSite - 从供应商的网站安装系统必备组件。
- SpecificSite - 从选定的位置安装系统必备组件。
- SameSite - 从与应用程序相同的位置安装系统必备组件。

使可再发行文件与应用程序安装分离

你可以阻止在安装项目中部署可再发行文件。 为此，请在 .NET Framework 目录的 RedistList 文件夹中创建一个可再发行文件列表：

%ProgramFiles%\Microsoft.NET\RedistList

可再发行文件列表是一个 XML 文件，你应采用下面的格式命名该文件：<公司名称>.<组件名称>.RedistList.xml。 举例来说，如果组件名为 DataWidgets 且由 Acme 开发，则使用 Acme.DataWidgets.RedistList.xml。 可再发行文件列表的内容的示例可能像下面这样：

<?xml version="1.0" encoding="UTF-8"?>
<FileList Redist="Acme.DataWidgets" >
<File AssemblyName="Acme.DataGrid" Version="1.0.0.0" PublicKeyToken="b03f5f7f11d50a3a" Culture="neutral" ProcessorArchitecture="MSIL" InGAC="true" />
</FileList>

相关内容