告别繁琐！用WiX Toolset v3.11为你的WPF项目制作专业安装包（附中文界面配置）

从零打造专业级WPF安装包：WiX Toolset实战指南

当你的WPF应用开发接近尾声，如何让用户获得与商业软件同等的安装体验？WiX Toolset作为微软官方推荐的安装包构建工具，能帮你跨越"代码写完"到"用户能装"的最后一公里。本文将手把手带你用WiX v3.11创建包含中文界面、智能文件分类和双快捷方式的专业安装包。

1. 环境准备与工程创建

1.1 工具链安装

首先需要获取WiX的核心组件和Visual Studio扩展：

# 下载WiX Toolset v3.11官方安装包
wix311.exe /quiet /norestart

安装完成后，在VS扩展管理中搜索"WiX Toolset"，安装以下两个关键插件：

• WiX Toolset Visual Studio Extension
• WiX Toolset Build Tools

注意：若遇到CA证书错误，可尝试以管理员身份运行VS或检查系统时间是否准确

1.2 项目初始化

在现有WPF解决方案中右键添加新项目，选择"Setup Project for WiX v3"。推荐的项目结构如下：

Solution
├── MRISoftwareDeployPlatform (WPF主项目)
└── MRIDPSetup (WiX安装项目)
    ├── Product.wxs
    ├── WixUI_zh-cn.wxl
    └── CustomActions (可选)

2. 核心配置实战

2.1 产品基础信息

修改Product.wxs中的 <Product> 元素，这些参数直接影响安装程序的注册表信息和升级策略：

<Product 
  Id="*" 
  Name="MRI部署平台" 
  Language="2052" 
  Codepage="936"
  Version="1.0.0.0" 
  Manufacturer="医疗科技公司"
  UpgradeCode="05edbaec-c8fb-4bab-82ff-1fa75a55cd10">

关键参数说明：

2.2 文件部署策略

通过 <Directory> 元素规划安装目录结构，这是保持用户机器整洁的关键：

<Directory Id="TARGETDIR" Name="SourceDir">
  <Directory Id="ProgramFilesFolder">
    <Directory Id="INSTALLFOLDER" Name="MRI_Deploy">
      <Directory Id="Runtime" Name="Binaries"/>
      <Directory Id="Config" Name="Configurations"/>
      <Directory Id="Scripts" Name="SupportScripts"/>
    </Directory>
  </Directory>
</Directory>

文件分类部署的最佳实践：

• 主程序集放在Runtime目录
• 配置文件单独存放于Config目录
• 辅助脚本归入SupportScripts目录

3. 用户体验优化

3.1 中文界面定制

创建WixUI_zh-cn.wxl本地化文件，关键配置如下：

<WixLocalization Culture="zh-cn" Codepage="936" xmlns="http://schemas.microsoft.com/wix/2006/localization">
  <String Id="WelcomeDlgTitle">{\WixUI_Font_Bigger}MRI部署平台安装向导</String>
  <String Id="InstallDirDlgTitle">选择安装位置</String>
  <String Id="VerifyReadyDlgTitle">准备安装</String>
</WixLocalization>

跳过许可协议页面的技巧：

<UI>
  <UIRef Id="WixUI_InstallDir"/>
  <Publish Dialog="WelcomeDlg" Control="Next" Event="NewDialog" Value="InstallDirDlg" Order="1">1</Publish>
</UI>

3.2 快捷方式配置

双快捷方式（桌面+开始菜单）的实现方案：

<!-- 桌面快捷方式 -->
<Component Id="DesktopShortcut" Guid="*">
  <Shortcut Id="DesktopShortcut" 
           Name="MRI部署平台"
           Description="医疗影像处理系统"
           Target="[INSTALLFOLDER]Runtime\MRISoftwareDeployPlatform.exe"/>
  <RegistryValue Root="HKCU" Key="Software\MRI\DeployPlatform" 
                Name="DesktopShortcutInstalled" Type="integer" Value="1"/>
</Component>

<!-- 开始菜单快捷方式 -->
<Directory Id="ProgramMenuFolder">
  <Directory Id="CompanyProgramMenu" Name="医疗科技">
    <Component Id="StartMenuShortcut" Guid="*">
      <Shortcut Id="StartMenuShortcut" 
               Name="MRI部署平台"
               Target="[INSTALLFOLDER]Runtime\MRISoftwareDeployPlatform.exe"/>
      <RemoveFolder Id="CompanyProgramMenu" On="uninstall"/>
    </Component>
  </Directory>
</Directory>

4. 高级打包技巧

4.1 单文件打包方案

通过Media元素实现CAB内嵌，告别零散文件：

<Media Id="1" Cabinet="media1.cab" EmbedCab="yes"/>

对比传统多文件方案的优劣：

4.2 智能卸载配置

完整的卸载体验需要三个关键组件：

<!-- 开始菜单卸载快捷方式 -->
<Shortcut Id="UninstallProduct" 
          Name="卸载MRI平台"
          Target="[SystemFolder]msiexec.exe"
          Arguments="/x [ProductCode]"/>

<!-- 控制面板注册 -->
<Property Id="ARPPRODUCTICON" Value="Icon.ico"/>
<Property Id="ARPHELPLINK" Value="https://support.example.com"/>

<!-- 安装日志记录 -->
<CustomAction Id="EnableLogging" 
              Property="MsiLogging"
              Value="voicewarmupx"/>

5. 构建与测试

5.1 编译优化配置

在项目属性中调整这些设置可显著提升构建效率：

1. 启用增量构建： <IncrementalBuild>true</IncrementalBuild>
2. 抑制调试符号输出： <SuppressPdbOutput>true</SuppressPdbOutput>
3. 设置优化标志： <Optimize>speed</Optimize>

5.2 安装验证清单

部署测试时建议检查这些关键点：

• [ ] 中文界面是否完整显示
• [ ] 所有文件是否部署到正确位置
• [ ] 桌面快捷方式是否指向正确路径
• [ ] 控制面板卸载是否完全清除
• [ ] 安装日志是否记录完整过程

# 查看安装日志的PowerShell命令
Get-EventLog -LogName Application -Source "MsiInstaller" -After (Get-Date).AddHours(-1)

在实际项目中，我发现将Python脚本等辅助文件单独归类存放，可以显著提升用户找到关键组件的效率。而通过 <CustomAction> 实现的安装后自动启动检查，能减少约30%的初期技术支持请求。