如何为Wix v4（VS2022 FireGiant HeatWave）安装程序添加UI

Wix v4 的扩展机制和v3完全不同，不能沿用v3的dll引用方式，正确操作步骤如下：

1. 通过NuGet安装UI扩展 #

Wix v4 所有扩展均通过NuGet管理，具体操作：

• 右键你的Wix项目，选择「管理NuGet程序包」
• 切换到「浏览」标签，搜索WixToolset.UI.wixext，安装与你的Wix v4版本一致的包

2. 在WXS文件中引用UI模板 #

安装完成后，打开你的Product.wxs文件，在<Product>标签内部添加UI引用，比如最简界面：

<UIRef Id="WixUI_Minimal" />

常用的UI模板还有：

• WixUI_InstallDir：支持自定义安装目录的标准界面
• WixUI_FeatureTree：允许用户选择要安装的功能模块
• WixUI_Mondo：包含完整功能选择、目录设置的全量界面

3. 关于你遇到的问题说明 #

• 「添加Wix库引用页面为空」是正常现象：Wix v4的HeatWave插件已废弃旧的库引用方式，全部迁移到NuGet，该页面不再使用
• 直接引用v3的wixuiextension.dll失败：v4与v3的扩展文件结构不兼容，必须使用v4专属的NuGet包

内容的提问来源于stack exchange，提问作者MoonLight