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 等关键元素。示例结构如下：
<?xml version="1.0" encoding="UTF-8"?>
<Wix xmlns="http://wixtoolset.org/schemas/v4/wxs">
<Product Id="*" UpgradeCode="YOUR-GUID-HERE" Version="1.0.0.0" Language="1033" Name="MyApp" Manufacturer="MyCompany">
<Package InstallerVersion="200" Compressed="yes" InstallScope="perMachine" />
<MajorUpgrade DowngradeErrorMessage="A newer version is already installed." />
<Directory Id="TARGETDIR" Name="SourceDir">
<Directory Id="ProgramFilesFolder">
<Directory Id="INSTALLFOLDER" Name="MyApp" />
</Directory>
</Directory>
<Feature Id="ProductFeature" Title="Main Application" Level="1">
<ComponentGroupRef Id="ProductComponents" />
</Feature>
</Product>
<Fragment>
<DirectoryRef Id="INSTALLFOLDER">
<Component Id="MyAppExe" Guid="ANOTHER-GUID-HERE">
<File Source="dist\MyApp.exe" KeyPath="yes" />
</Component>
</DirectoryRef>
</Fragment>
<Fragment>
<ComponentGroup Id="ProductComponents" Directory="INSTALLFOLDER">
<ComponentRef Id="MyAppExe" />
</ComponentGroup>
</Fragment>
</Wix>
注意点：
– 每个 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 片段即可：
-
开始菜单快捷方式：
<Component Id="StartMenuShortcut" Guid="...">
<Shortcut Id="StartMenuShortcut" Name="MyApp" Target="[INSTALLFOLDER]MyApp.exe" />
<RemoveFolder Id="StartMenuFolder" On="uninstall" />
</Component>
再在DirectoryRef中引用StartMenuFolder（通常放在ProgramMenuFolder下） -
注册表项：
<Component Id="RegEntries" Guid="...">
<RegistryKey Root="HKLM" Key="Software\MyCompany\MyApp">
<RegistryValue Type="string" Name="InstallPath" Value="[INSTALLFOLDER]" KeyPath="yes" />
</RegistryKey>
</Component> -
静默安装支持：MSI 天然支持
msiexec /i MyApp.msi /quiet，无需额外配置；如需自定义日志，加/l*v install.log
WiX 的 XML 不是编程语言，而是声明式描述——你告诉它“要什么”，它负责生成符合 Windows Installer 规范的 MSI。起步稍陡，但结构清晰、可控性强，适合需要精细控制安装行为的场景。
