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

从零到专业：WiX Toolset打造WPF应用安装包的全流程实战

每次完成WPF应用开发后，最让人头疼的莫过于如何将代码变成用户能轻松安装的软件包。传统打包工具要么功能简陋，要么配置复杂得让人望而却步。而WiX Toolset作为微软官方推荐的安装包制作工具，完美解决了这个痛点——它既保持了Windows Installer(MSI)的专业级功能，又提供了XML配置的灵活性。

1. 环境准备与项目初始化

在开始之前，我们需要确保开发环境已经就绪。WiX Toolset v3.11是目前最稳定的版本，兼容性也最好。安装过程非常简单：

从WiX Toolset官网下载wix311.exe安装包
运行安装程序，选择默认选项完成安装
在Visual Studio中安装"WiX Toolset Visual Studio Extension"插件

提示：如果遇到插件安装问题，可以尝试关闭所有Visual Studio实例后以管理员身份重新运行安装程序。

创建WiX项目时，建议采用以下最佳实践：

在解决方案资源管理器中右键点击解决方案
选择"添加"→"新建项目"
搜索"wix"并选择"Setup Project for WiX v3"
命名为"YourProductName.Setup"这样的清晰名称

项目创建后会生成一个Product.wxs文件，这是整个安装包的核心配置文件。初始模板已经包含了基本结构，我们需要在此基础上进行定制化修改。

2. 产品基础信息配置

Product.wxs中的 <Product> 元素是整个安装包的根节点，需要仔细配置以下关键属性：

<Product Id="*" 
         Name="MyWPFApp" 
         Language="2052" 
         Version="1.0.0.0"
         Manufacturer="YourCompany"
         UpgradeCode="PUT-GUID-HERE">

属性说明表：

属性名	说明	示例值
Id	产品唯一标识，使用*表示自动生成GUID	*
Name	产品名称，会显示在控制面板的"程序和功能"中	MyWPFApp
Language	语言代码，2052表示简体中文	2052
Version	产品版本号，遵循主版本.次版本.修订号.构建号的格式	1.0.0.0
Manufacturer	制造商名称，建议使用公司或组织名称	YourCompany
UpgradeCode	升级标识符，不同版本应保持相同，使用固定GUID	自行生成的GUID

对于中文环境，还需要特别注意Codepage的设置：

<Product ... Codepage="936">

936是简体中文的代码页，确保安装包能正确处理中文字符。

3. 文件部署与目录结构设计

合理的文件组织是专业安装包的重要特征。WiX使用 <Directory> 元素定义安装目录结构：

<Directory Id="TARGETDIR" Name="SourceDir">
  <Directory Id="ProgramFilesFolder">
    <Directory Id="INSTALLFOLDER" Name="MyWPFApp">
      <Directory Id="ConfigFolder" Name="Config"/>
      <Directory Id="PluginsFolder" Name="Plugins"/>
    </Directory>
  </Directory>
</Directory>

添加项目文件时，推荐使用变量引用而非硬编码路径：

<ComponentGroup Id="ProductComponents" Directory="INSTALLFOLDER">
  <Component Guid="*">
    <File Source="$(var.MyWPFApp.TargetDir)MyWPFApp.exe"/>
    <File Source="$(var.MyWPFApp.TargetDir)MyWPFApp.exe.config"/>
  </Component>
</ComponentGroup>

对于辅助文件（如配置文件、插件等），建议单独分组：

<ComponentGroup Id="ConfigComponents" Directory="ConfigFolder">
  <Component Guid="*">
    <File Source="$(var.MyWPFApp.TargetDir)appsettings.json"/>
  </Component>
</ComponentGroup>

4. 用户界面定制与本地化

WiX提供了多种预定义的安装界面风格，最常用的是 WixUI_InstallDir ，它包含了目录选择和基本安装进度界面：

<UIRef Id="WixUI_InstallDir"/>

要自定义界面文本，需要创建本地化文件(.wxl)：

右键项目→添加→新建项→选择"Localization File"
命名为 WixUI_zh-cn.wxl
编辑内容如下：

<WixLocalization Culture="zh-cn" Codepage="936" xmlns="http://schemas.microsoft.com/wix/2006/localization">
  <String Id="WixUINext">下一步(&N)</String>
  <String Id="WixUIBack">上一步(&B)</String>
  <String Id="WixUICancel">取消</String>
  <String Id="WixUIFinish">完成</String>
  <!-- 更多中文字符串 -->
</WixLocalization>

常见界面定制需求：

跳过许可协议页面：

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

设置安装完成后的选项：

<Property Id="WIXUI_EXITDIALOGOPTIONALCHECKBOXTEXT" Value="启动应用程序"/>
<Property Id="WixShellExecTarget" Value="[INSTALLFOLDER]MyWPFApp.exe"/>

5. 快捷方式与注册表配置

专业的安装包应该为用户创建合理的快捷方式。桌面快捷方式配置示例：

<Directory Id="DesktopFolder" Name="Desktop">
  <Component Id="DesktopShortcut" Guid="*">
    <Shortcut Id="DesktopShortcut"
              Name="MyWPFApp"
              Description="我的WPF应用程序"
              Target="[INSTALLFOLDER]MyWPFApp.exe"
              WorkingDirectory="INSTALLFOLDER"/>
    <RemoveFolder Id="DesktopFolder" On="uninstall"/>
    <RegistryValue Root="HKCU" Key="Software\MyWPFApp" Name="installed" Type="integer" Value="1" KeyPath="yes"/>
  </Component>
</Directory>

开始菜单快捷方式需要更复杂的结构：

<Directory Id="ProgramMenuFolder">
  <Directory Id="ApplicationProgramsFolder" Name="MyWPFApp">
    <Component Id="StartMenuShortcut" Guid="*">
      <Shortcut Id="ApplicationStartMenuShortcut"
                Name="MyWPFApp"
                Description="启动MyWPFApp"
                Target="[INSTALLFOLDER]MyWPFApp.exe"
                WorkingDirectory="INSTALLFOLDER"/>
      <Shortcut Id="UninstallShortcut"
                Name="卸载MyWPFApp"
                Description="从计算机移除MyWPFApp"
                Target="[SystemFolder]msiexec.exe"
                Arguments="/x [ProductCode]"/>
      <RemoveFolder Id="ApplicationProgramsFolder" On="uninstall"/>
      <RegistryValue Root="HKCU" Key="Software\MyWPFApp" Name="installed" Type="integer" Value="1" KeyPath="yes"/>
    </Component>
  </Directory>
</Directory>

6. 高级功能实现

6.1 安装条件检查

WiX允许在安装前检查系统条件，例如.NET Framework版本：

<PropertyRef Id="WIX_IS_NETFRAMEWORK_48_OR_LATER_INSTALLED"/>
<Condition Message="需要安装.NET Framework 4.8或更高版本">
  <![CDATA[Installed OR WIX_IS_NETFRAMEWORK_48_OR_LATER_INSTALLED]]>
</Condition>

6.2 自定义操作

有时需要在安装过程中执行特定操作，比如安装后启动服务：

<CustomAction Id="StartService" 
              FileKey="MyService.exe" 
              ExeCommand="-start" 
              Execute="deferred" 
              Return="check"/>

<InstallExecuteSequence>
  <Custom Action="StartService" After="InstallFinalize">NOT Installed</Custom>
</InstallExecuteSequence>

6.3 文件关联设置

如果需要让你的应用成为特定文件类型的默认打开程序：

<Component Id="FileAssociation" Guid="*">
  <ProgId Id="MyWPFApp.Document" Description="MyWPFApp Document">
    <Extension Id="myapp" ContentType="application/myapp">
      <Verb Id="open" Command="Open" TargetFile="MyWPFApp.exe" Argument=""%1""/>
    </Extension>
  </ProgId>
</Component>

7. 构建与测试

完成所有配置后，构建WiX项目会生成.msi安装包。为了简化分发，可以：

在项目属性中启用"CAB嵌入"选项：

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

禁用调试符号生成以减小体积：
- 项目属性→Build→勾选"Suppress output of the wixpdb files"

测试安装包时，建议：

在干净的虚拟机环境中测试
验证所有文件是否正确安装到指定位置
检查快捷方式和文件关联是否正常工作
测试升级和卸载流程是否顺畅

遇到问题时，可以查看安装日志获取详细信息：

msiexec /i MyWPFApp.msi /l*v install.log