如何在WiX中管理自定义引导程序应用程序的Payload？

嘿，我太懂你这种困扰了——自定义WPF引导程序应用程序（BA）的输出文件一堆，还要手动一个个写Payload不仅麻烦，文件更新后还要同步修改WXS，完全是重复劳动！下面给你两个实用的解决办法，帮你摆脱手动维护的噩梦：

方法一：用WiX通配符递归匹配所有文件 #

WiX 4本身支持通配符匹配，如果你只是想快速把BA输出目录下的所有文件（包括子文件夹里的）都打包成Payload，直接用**递归通配符就行，不用一个个列文件：

<Wix xmlns="http://wixtoolset.org/schemas/v4/wxs">
  <Bundle Name="Setup.Sample.Bootstrapper"
          Manufacturer="Sample Ltd."
          Version="1.0.0.0"
          UpgradeCode="ffffcf4d-b3e4-4eba-a850-ab8ab3fe501d">
        
    <BootstrapperApplication SourceFile="Setup.Sample.Bootstrapper.WPF.exe">
        <!-- 递归匹配目标目录下所有文件（含子文件夹） -->
        <Payload SourceFile="$(Setup.Sample.Bootstrapper.WPF.TargetDir)**" />
    </BootstrapperApplication>

    <!-- 其他Bundle配置内容 -->
  </Bundle>
</Wix>

这个写法会自动包含BA输出目录下的所有文件和子文件夹结构，不管文件怎么新增或删除，只要输出目录变了，Payload就会同步更新。

方法二：用Heat工具自动生成Payload片段（适合文件频繁变动的场景） #

如果你的BA项目文件变动特别频繁，或者需要排除某些不必要的文件（比如调试pdb、文档xml），用WiX自带的Heat工具自动生成Payload片段是更靠谱的方案——它会在每次构建前自动扫描BA输出目录，生成对应的WXS代码，完全不用你手动维护。

步骤1：添加预构建事件 #

在你的WiX Bundle项目里添加预构建事件，调用Heat.exe扫描BA的输出目录，生成包含所有Payload的WXS文件。预构建命令可以这么写：

heat dir "$(Setup.Sample.Bootstrapper.WPF.TargetDir)" -cg BAPayloadGroup -dr BOOTSTRAPPER_APPLICATION -gg -g1 -sfrag -srd -x "$(Setup.Sample.Bootstrapper.WPF.TargetDir)*.pdb" -x "$(Setup.Sample.Bootstrapper.WPF.TargetDir)*.xml" -out "$(ProjectDir)GeneratedBAPayloads.wxs"

给你解释下关键参数：

• -cg BAPayloadGroup：把所有生成的Payload归到一个组件组里，方便后续引用
• -dr BOOTSTRAPPER_APPLICATION：指定这些Payload属于引导程序应用程序的目录
• -x：用来排除不需要打包的文件，比如上面的命令排除了pdb调试文件和xml文档文件
• -out：指定生成的WXS文件的输出路径（建议放在WiX项目目录下）

步骤2：导入生成的Payload片段 #

在你的主Bundle.wxs文件里，导入刚才Heat生成的WXS文件，然后在BootstrapperApplication里引用这个Payload组：

<Wix xmlns="http://wixtoolset.org/schemas/v4/wxs">
  <!-- 导入自动生成的Payload片段 -->
  <?include GeneratedBAPayloads.wxs?>

  <Bundle Name="Setup.Sample.Bootstrapper"
          Manufacturer="Sample Ltd."
          Version="1.0.0.0"
          UpgradeCode="ffffcf4d-b3e4-4eba-a850-ab8ab3fe501d">
        
    <BootstrapperApplication SourceFile="Setup.Sample.Bootstrapper.WPF.exe">
        <!-- 引用自动生成的Payload组 -->
        <PayloadGroupRef Id="BAPayloadGroup" />
    </BootstrapperApplication>

    <!-- 其他Bundle配置内容 -->
  </Bundle>
</Wix>

这样每次构建WiX Bundle前，Heat都会自动扫描BA的最新输出目录，同步更新Payload列表，你再也不用手动修改WXS了！

额外注意点 #

• 如果你用的是WiX 3，通配符递归需要用-r参数配合Heat，而不是WiX 4里的**写法，记得调整对应的命令和配置
• 确保预构建事件里的路径是正确的，特别是如果你的项目结构比较复杂，最好用绝对路径或者项目宏来避免路径错误

备注：内容来源于stack exchange，提问作者roli09