WiX 5：移除WixUI_InstallDir.wxs许可证对话框遇编译错误求助

问题根源 #

复制WixUI_InstallDir源码并修改UI元素ID后出现WIX0130主键重复错误，原因是自定义UI中的BrowseDlg控件事件与WiX内置BrowseDlg的ControlEvent表主键重复——默认WiX库已包含BrowseDlg的定义，重复定义导致主键冲突。另外，修改_BrowseProperty会破坏WiX内置的文件夹浏览逻辑，导致MSI运行出错。

解决方案 #

方法1：直接跳过许可证对话框（推荐） #

无需复制完整的WixUI_InstallDir源码，直接在项目中定义自定义UI序列，基于WixUI_InstallDir跳过LicenseDlg：

<UI>
  <!-- 引用WiX通用对话框资源 -->
  <UIRef Id="WixUI_Common" />

  <!-- 自定义UI流程：欢迎页直接跳转到文件夹选择页 -->
  <Publish Dialog="WelcomeDlg" Control="Next" Event="NewDialog" Value="InstallDirDlg">1</Publish>

  <!-- 文件夹选择页的浏览按钮逻辑 -->
  <Publish Dialog="InstallDirDlg" Control="ChangeFolder" Property="_BrowseProperty" Value="[INSTALLDIR]" Order="1">1</Publish>
  <Publish Dialog="InstallDirDlg" Control="ChangeFolder" Event="SpawnDialog" Value="BrowseDlg" Order="2">1</Publish>

  <!-- 文件夹选择页下一步跳转至确认页 -->
  <Publish Dialog="InstallDirDlg" Control="Next" Event="SetTargetPath" Value="[INSTALLDIR]" Order="1">1</Publish>
  <Publish Dialog="InstallDirDlg" Control="Next" Event="NewDialog" Value="VerifyReadyDlg">1</Publish>

  <!-- 确认页返回按钮逻辑 -->
  <Publish Dialog="VerifyReadyDlg" Control="Back" Event="NewDialog" Value="InstallDirDlg">1</Publish>

  <!-- 完成页结束逻辑 -->
  <Publish Dialog="ExitDialog" Control="Finish" Event="EndDialog" Value="Return">1</Publish>
</UI>

这种方式直接复用WiX内置对话框，避免了重复定义冲突，同时精准跳过许可证步骤。

方法2：正确复制并修改WixUI_InstallDir源码 #

如果必须通过复制源码自定义，需彻底避免与内置对话框冲突：

• 将复制的BrowseDlg重命名为唯一ID（如CustomBrowseDlg）
• 同步修改所有引用该对话框的ControlEvent和跳转逻辑
• 保留_BrowseProperty不变，它是WiX处理文件夹浏览的核心属性

示例修改点：

<!-- 重命名对话框ID -->
<Dialog Id="CustomBrowseDlg" ...>
  <!-- 对话框内容保持不变 -->
</Dialog>

<!-- 修改浏览按钮的跳转目标 -->
<Publish Dialog="InstallDirDlg" Control="ChangeFolder" Event="SpawnDialog" Value="CustomBrowseDlg" Order="2">1</Publish>

<!-- 对应修改ControlEvent中的对话框名称 -->
<Control Id="OK" Type="PushButton" X="236" Y="243" Width="56" Height="17" Default="yes" Text="!(loc.WixUIOK)">
  <Publish Event="SetTargetPath" Value="[_BrowseProperty]" Order="1">1</Publish>
  <Publish Event="EndDialog" Value="Return" Order="2">1</Publish>
</Control>

关键注意事项 #

• 禁止修改_BrowseProperty，这是WiX内置的专用属性，修改会导致路径选择逻辑失效
• 自定义对话框ID必须与WiX内置对话框（如WelcomeDlg、BrowseDlg等）不重复，避免主键冲突

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