如何在Wix安装程序Finish按钮前展示README？及启动问题排查

问题场景 #

制作Wix安装程序时，希望通过退出对话框的复选框让用户选择是否在安装后打开README.txt，但勾选复选框后文件无法启动，已配置的代码如下：

自定义操作与触发代码 #

<!-- Custom Action to launch readme.txt with Notepad -->
<CustomAction Id="LaunchReadme" Directory="x64Folder" ExeCommand="notepad.exe readme.txt" Return="asyncNoWait" Execute="deferred" Impersonate="yes" />

<!-- Trigger the custom action if checkbox is checked -->
<Custom Action="LaunchReadme" Before="InstallFinalize" Condition="WIXUI_EXITDIALOGOPTIONALCHECKBOX = 1 AND NOT Installed" />

复选框文本配置 #

<Property Id="WIXUI_EXITDIALOGOPTIONALCHECKBOXTEXT" Value="View README file" />

问题原因 #

1. Deferred操作无法访问UI属性：Execute="deferred"的自定义操作属于执行序列阶段，无法直接读取UI阶段设置的WIXUI_EXITDIALOGOPTIONALCHECKBOX属性，该属性仅存在于UI会话中。
2. 路径写法不严谨：ExeCommand未使用完整路径，系统可能无法定位notepad.exe或readme.txt文件。
3. 执行时机过早：Before="InstallFinalize"是在安装完成前触发，此时readme.txt可能还未完全写入目标目录。

解决方案 #

方案一：改用Immediate执行的自定义操作（推荐，适合启动文件场景） #

将自定义操作改为Execute="immediate"，并调整到安装完成后触发，同时使用完整路径确保可执行文件和目标文件能被正确定位：

<!-- Custom Action to launch readme.txt with Notepad -->
<CustomAction Id="LaunchReadme" Directory="x64Folder" ExeCommand='"[SystemFolder]notepad.exe" "[x64Folder]readme.txt"' Return="asyncNoWait" Execute="immediate" Impersonate="yes" />

<!-- Trigger after installation completes when checkbox is checked -->
<Custom Action="LaunchReadme" After="InstallFinalize" Condition="WIXUI_EXITDIALOGOPTIONALCHECKBOX = 1 AND NOT Installed" />

方案二：保留Deferred操作（需传递属性） #

如果必须使用deferred操作（如需要系统权限），需通过CustomActionData传递UI阶段的属性值和目录路径：

1. 添加Immediate操作设置CustomActionData：

<CustomAction Id="SetLaunchReadmeData" Property="LaunchReadme" Value="CHECKBOX=[WIXUI_EXITDIALOGOPTIONALCHECKBOX];INSTALLFOLDER=[x64Folder]" Execute="immediate" />

2. 修改Deferred自定义操作：

<CustomAction Id="LaunchReadme" Directory="x64Folder" ExeCommand='"[SystemFolder]notepad.exe" "[INSTALLFOLDER]readme.txt"' Return="asyncNoWait" Execute="deferred" Impersonate="yes" />

3. 调整触发序列：

<Custom Action="SetLaunchReadmeData" Before="LaunchReadme" Condition="NOT Installed" />
<Custom Action="LaunchReadme" Before="InstallFinalize" Condition="CHECKBOX = 1" />

额外检查项 #

• 确认x64Folder是正确的目标安装目录，且已通过<File>元素将readme.txt部署到该目录。
• 确保使用的WixUI集（如WixUI_InstallDir）包含ExitDialog，否则复选框不会显示。

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