WiX Toolset v4 项目启动与配置教程

1. 项目的目录结构及介绍

WiX Toolset 是一个用于创建 Windows 安装程序的工具集，它的目录结构通常如下所示：

wix4-archive/
├── bin/              # 存放编译后的可执行文件和库文件
├── build/            # 构建脚本和相关文件
├── doc/              # 项目文档
├── examples/         # 项目示例
├── include/          # 头文件和资源文件
├── src/              # 源代码目录
│   ├── candle/       # WiX 编译器（C#）
│   ├── dark/         # WiX 反编译器（C#）
│   ├── heat/         # WiX 资源抓取工具（C#）
│   ├── light/        # WiX 链接器（C++）
│   ├── pyro/         # WiX 设置生成器（C++）
│   └── setup/        # 安装程序示例
└── test/             # 测试用例和测试脚本

• bin/ 目录包含编译后的WiX Toolset的可执行文件和库。
• build/ 目录包含构建项目所需的脚本和文件。
• doc/ 目录存储项目文档。
• examples/ 目录包含使用WiX Toolset构建安装程序的示例。
• include/ 目录包含编译WiX Toolset所需的头文件和资源文件。
• src/ 目录是WiX Toolset的源代码存放地，包含了不同的组件和工具。
• test/ 目录包含项目的测试用例和测试脚本。

2. 项目的启动文件介绍

WiX Toolset 的启动主要是通过命令行工具进行的。以下是一些主要的启动文件：

• candle.exe：WiX 的编译器，用于将WiX源代码编译为中间文件。
• dark.exe：WiX 的反编译器，用于将编译后的WiX中间文件反编译为源代码。
• light.exe：WiX 的链接器，用于将编译后的WiX中间文件链接成安装程序。

例如，要编译一个WiX源代码文件，你可以在命令行中使用以下命令：

candle path\to\your\sourcefile.wxs

这会生成一个编译后的文件，随后可以使用以下命令进行链接：

light path\to\your\compiledfile.wixobj

3. 项目的配置文件介绍

WiX Toolset 的配置主要是通过修改项目文件或构建脚本来进行的。以下是一些常见的配置文件：

• build.wixproj：WiX Toolset 的项目文件，它定义了构建过程的各种属性和任务。
• build.xml：Ant 构建脚本，用于自动化构建过程。
• wix.ico：WiX Toolset 的图标文件，通常用于WiX生成的安装程序界面。

build.wixproj 文件可能包含如下内容：

<Project DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <!-- 配置项目属性 -->
  <PropertyGroup>
    <Configuration>Debug</Configuration>
    <Platform>AnyCPU</Platform>
  </PropertyGroup>

  <!-- 定义构建任务 -->
  <Target Name="Build">
    <MakeDir Directories="bin\$(Configuration)" />
    <Candle Sources="src\*.wxs" OutputDirectory="bin\$(Configuration)" />
    <Light Inputs="bin\$(Configuration)\*.wixobj" OutputFile="bin\$(Configuration)\setup.exe" />
  </Target>
</Project>

在这个文件中，可以配置编译的配置（例如Debug或Release）、平台（例如AnyCPU或x86）、以及定义构建任务的步骤，如创建目录、编译源文件和链接中间文件。

通过修改这些配置文件，可以自定义WiX Toolset的构建过程和最终生成的安装程序。