wix toolset 使用 xml（.wxs 文件）声明式定义安装资源，通过 candle 编译和 light 链接生成 msi；需配置环境、编写含 product/component/file 等元素的 .wxs，指定 guid、keypath 和 majorupgrade，并可扩展 ui、快捷方式、注册表等功能。
WiX Toolset 使用 XML（即 .wxs 文件）定义安装逻辑，核心是把文件、注册表、快捷方式、服务等资源“声明”出来，再通过工具链编译链接成 MSI 安装包。它不写代码，而是用结构化 XML 描述“要装什么、装到哪、怎么装”。
1. 安装 WiX 并配置环境
从 wixtoolset.org 下载最新稳定版（如 v4.x），安装时勾选“Add WiX to PATH”。安装后在命令行运行 candle -help 和 light -help 验证是否可用。v4 默认使用 wix 命令统一入口，但底层仍依赖 candle（编译器）和 light（链接器）。
2. 编写基础 .wxs 文件
一个最小可运行的 Product.wxs 需包含 Product、Package、Directory、Component、File 等关键元素。示例结构如下：
注意点：
– 每个 Component 必须有唯一 GUID（可用 uuidgen 或在线生成器）
– File 的 Source 是相对路径，指向实际文件位置
– KeyPath="yes" 标识该文件为组件主键，用于检测安装状态
– MajorUpgrade 启用自动升级/卸载旧版本能力
3. 编译与链接生成 MSI
在项目目录下执行两步命令：
-
编译（candle）：将
.wxs转为对象文件.wixobjcandle Product.wxs -out Product.wixobj -
链接（light）：将
.wixobj打包为 MSIlight Product.wixobj -ext WixUIExtension -o MyApp.msi
常用扩展（-ext）：
– WixUIExtension：启用内置 UI（如 WixUI_Minimal）
– WixUtilExtension：支持自定义操作、服务安装、环境变量等
– WixFirewallExtension：配置防火墙例外
4. 添加常用功能（简明写法）
只需在对应 Fragment 或 Product 内添加对应 XML 片段即可：
-
开始菜单快捷方式：
再在DirectoryRef中引用StartMenuFolder（通常放在ProgramMenuFolder下） -
注册表项：
-
静默安装支持：MSI 天然支持
msiexec /i MyApp.msi /quiet，无需额外配置；如需自定义日志，加/l*v install.log
WiX 的 XML 不是编程语言，而是声明式描述——你告诉它“要什么”，它负责生成符合 Windows Installer 规范的 MSI。起步稍陡，但结构清晰、可控性强，适合需要精细控制安装行为的场景。
