基于Wix实现：从命令行/对话框复制用户配置文件到ProgramData

我之前做过类似的需求，给你拆解几个核心实现步骤，分两种场景来处理：

一、通过msiexec命令行参数指定配置文件路径 #

这种方式适合静默安装或者自动化部署场景，核心是通过自定义属性传递路径，再用自定义动作完成文件复制：

• 步骤1：定义可传递的自定义属性
  在Wix项目的Product元素里添加一个全大写的公开属性（Wix约定），加上Secure="yes"避免UAC权限导致的属性丢失：

  <Property Id="CONFIGFILEPATH" Secure="yes" />
  

• 步骤2：编写C#自定义动作处理复制逻辑
  推荐用C#写自定义动作（比VBScript更可靠），读取属性值后复制文件到ProgramData目录：

  [CustomAction]
  public static ActionResult CopyConfigFile(Session session)
  {
      string configPath = session["CONFIGFILEPATH"];
      string targetDir = Path.Combine(session["CommonAppDataFolder"], "YourAppName");
      
      if (!string.IsNullOrEmpty(configPath) && File.Exists(configPath))
      {
          Directory.CreateDirectory(targetDir);
          // 允许覆盖已存在的配置文件，可根据需求调整
          File.Copy(configPath, Path.Combine(targetDir, "app.config"), overwrite: true);
          return ActionResult.Success;
      }
      return ActionResult.SkipRemainingActions; // 未指定路径则跳过动作
  }
  

• 步骤3：在Wix中注册并调度自定义动作
  把编译好的自定义动作DLL加入项目，然后在安装序列中安排执行时机（比如在InstallFiles之后）：

  <Binary Id="CustomActions.dll" SourceFile="..\CustomActions\bin\Debug\CustomActions.dll" />
  <CustomAction Id="CopyConfigFromCommandLine" BinaryKey="CustomActions.dll" DllEntry="CopyConfigFile" Execute="deferred" Impersonate="no" />
  
  <InstallExecuteSequence>
      <!-- 仅当CONFIGFILEPATH有值时执行动作 -->
      <Custom Action="CopyConfigFromCommandLine" After="InstallFiles">CONFIGFILEPATH</Custom>
  </InstallExecuteSequence>
  

• 用户使用方式
  运行安装包时通过命令行传递参数：

  msiexec /i YourInstaller.msi CONFIGFILEPATH="C:\Users\user\config\app.config" /qn
  

二、通过UI对话框让用户选择配置文件 #

如果是交互式安装场景，需要扩展Wix的默认UI，添加文件选择对话框：

• 步骤1：自定义文件选择对话框
  基于Wix的UI框架添加一个带路径选择控件的对话框：

  <Dialog Id="ConfigFileSelectionDlg" Width="370" Height="270" Title="[ProductName] 安装向导">
      <Control Id="Next" Type="PushButton" X="236" Y="243" Width="56" Height="17" Default="yes" Text="!(loc.WixUINext)" />
      <Control Id="Back" Type="PushButton" X="180" Y="243" Width="56" Height="17" Text="!(loc.WixUIBack)" />
      <Control Id="Cancel" Type="PushButton" X="304" Y="243" Width="56" Height="17" Cancel="yes" Text="!(loc.WixUICancel)">
          <Publish Event="SpawnDialog" Value="CancelDlg">1</Publish>
      </Control>
      <Control Id="ConfigFileLabel" Type="Text" X="20" Y="60" Width="330" Height="15" NoPrefix="yes" Text="请选择您的配置文件：" />
      <Control Id="ConfigFileEdit" Type="PathEdit" X="20" Y="80" Width="320" Height="18" Property="CONFIGFILEPATH" />
      <Control Id="BrowseButton" Type="PushButton" X="296" Y="100" Width="44" Height="17" Text="浏览...">
          <Publish Event="Browse" Value="CONFIGFILEPATH">1</Publish>
      </Control>
  </Dialog>
  

• 步骤2：将对话框插入UI序列
  修改默认UI的跳转逻辑，把自定义对话框插入到欢迎页之后：

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

• 步骤3：复用复制逻辑
  直接用第一部分的自定义动作即可，用户在UI中选择文件后，CONFIGFILEPATH属性会自动填充，安装时就会触发文件复制。

三、两种方式的兼容与优化 #

• 条件控制：保持自定义动作的执行条件为CONFIGFILEPATH，不管是命令行传递还是UI选择，只要属性有值就执行复制。
• 强制校验（可选）：如果需要用户必须提供配置文件，可以在对话框的Next按钮上加校验条件：

  <Control Id="Next" Type="PushButton" X="236" Y="243" Width="56" Height="17" Default="yes" Text="!(loc.WixUINext)">
      <Publish Event="NewDialog" Value="InstallDirDlg">CONFIGFILEPATH AND FileExists(CONFIGFILEPATH)</Publish>
  </Control>
  

• 权限注意：ProgramData是系统目录，自定义动作要设置Impersonate="no"，确保以系统权限执行复制。

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