WiX安装器：保留TARGETDIR支持并默认指向ProgramFilesFolder

我之前从Visual Studio Install Projects迁移到WiX时，完完全全碰到了和你一样的棘手问题——既要保住TARGETDIR的命令行支持（毕竟旧版本MSI升级全靠它），又得让安装UI的默认路径乖乖指向ProgramFilesFolder，试了各种方法都踩坑：用WiXUI_Advanced会覆盖命令行参数、硬编码路径不够灵活、直接改属性导致TARGETDIR和UI选择的路径不同步，最后靠自定义操作完美解决了，分享一下我的方案：

先明确核心需求：

• 必须保留TARGETDIR参数支持，否则旧版MSI升级会大幅增加维护成本
• 安装UI默认路径要为ProgramFilesFolder，且用户在UI中选择的路径要同步到TARGETDIR，避免程序装错位置
• 不能硬编码路径，必须动态使用WiX的文件夹变量

这个方案分三步：配置自定义动作、加入安装序列、编写C#动作逻辑，完美兼顾兼容性和UI需求。

1. 在WiX项目中配置自定义动作 #

首先在你的.wxs文件里，定义自定义动作依赖的二进制文件和动作本身：

<!-- 替换成你的自定义动作DLL实际路径 -->
<Binary Id="CustomActionsBinary" SourceFile="$(var.CustomActions.TargetDir)CustomActions.dll" />

<!-- 定义自定义动作，指定DLL中的入口方法 -->
<CustomAction Id="SetINSTALLDIR" BinaryKey="CustomActionsBinary" DllEntry="SetInstallDir" />

2. 将自定义动作加入安装序列 #

要把这个动作加到InstallExecuteSequence和InstallUISequence中，确保在AppSearch之前执行，并且只针对全新安装（避免影响升级流程）：

<InstallExecuteSequence>
  <Custom Action="SetINSTALLDIR" Before="AppSearch">Not Installed</Custom>
</InstallExecuteSequence>

<InstallUISequence>
  <Custom Action="SetINSTALLDIR" Before="AppSearch">Not Installed</Custom>
</InstallUISequence>

3. 编写C#自定义动作逻辑 #

在你的自定义动作类库项目中，实现SetInstallDir方法，核心逻辑是同步TARGETDIR和WiX UI默认使用的APPLICATIONFOLDER属性：

using Microsoft.Deployment.WindowsInstaller;
using System;

namespace YourCustomActionsNamespace
{
    public static class CustomActions
    {
        [CustomAction]
        public static ActionResult SetInstallDir(Session session)
        {
            session.Log($"Starting custom action: {nameof(SetInstallDir)}");
            
            string applicationFolder = session["APPLICATIONFOLDER"];
            string targetDir = string.Empty;

            try
            {
                targetDir = session["TARGETDIR"];
            }
            catch (Exception ex)
            {
                session.Log($"Failed to read TARGETDIR: {ex.Message}");
            }

            // 如果UI文件夹为空但命令行指定了TARGETDIR，同步两者的值
            if (string.IsNullOrEmpty(applicationFolder) && !string.IsNullOrEmpty(targetDir))
            {
                session["APPLICATIONFOLDER"] = targetDir;
                session.Log($"Synced APPLICATIONFOLDER to TARGETDIR value: {targetDir}");
            }

            return ActionResult.Success;
        }
    }
}

• WiX的默认UI（比如WiXUI_FeatureTree）用APPLICATIONFOLDER作为显示和用户选择的路径属性，我们通过自定义动作让它和TARGETDIR保持一致
• 自定义动作在安装流程早期执行（AppSearch之前），此时WiX还没确定最终安装路径：如果用户通过命令行指定了TARGETDIR，就把这个值同步给APPLICATIONFOLDER，UI会直接显示命令行指定的路径；如果没指定命令行参数，APPLICATIONFOLDER会默认使用ProgramFilesFolder的值，后续安装逻辑会自动关联到TARGETDIR
• 动作只在全新安装时执行，升级流程不受影响，完美保留了旧版本MSI的兼容性

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