如何用Wix Toolset 5打包含多文件工具的Bundle并执行其EXE？

需求 #

• 将多个独立MSI打包到主安装程序中；
• 安装一个包含多文件的独立工具：该工具含EXE及带依赖文件（含EXE调用的MSI）的子文件夹，要求安装程序将这些文件提取到临时文件夹后执行EXE，由EXE完成后续安装。

现有项目结构 #

Bundle.wxs #

<Wix xmlns="http://wixtoolset.org/schemas/v4/wxs" xmlns:bal="http://wixtoolset.org/schemas/v4/wxs/bal">
    <Bundle>
        <Chain>
            <PackageGroupRef Id="PackageWithMsi"/>
            <PackageGroupRef Id="PackageWithMultipleFiles"/>
        </Chain>
    </Bundle>
</Wix>

PackageWithMsi.wxs #

<Wix xmlns="http://wixtoolset.org/schemas/v4/wxs">
    <Fragment>
        <PackageGroup Id="PackageWithMsi">
            <MsiPackage>
                <!-- ... -->
            </MsiPackage>
        </PackageGroup>
    </Fragment>
</Wix>

遇到的问题 #

针对PackageWithMultipleFiles，希望用WiX v5推荐的<Files>元素替代旧版Heat工具收集多文件，但<Files>父元素有限制，无法正确关联到Bundle。

尝试过的方法 #

1. 添加到FeatureGroup #

<Wix xmlns="http://wixtoolset.org/schemas/v4/wxs">
    <Fragment>
      <FeatureGroup Id="FilesFeatureGroup">
          <Files Include="..\bin\Setup\**" />
      </FeatureGroup>
    </Fragment>
</Wix>

问题：无法关联到Bundle，因为Bundle需要PackageGroup，而PackageGroup不能引用FeatureGroup。

2. 独立Fragment #

<Wix xmlns="http://wixtoolset.org/schemas/v4/wxs">
    <Fragment Id="FilesFragment">
        <Property Id="DummyProp" Value="1"/>
        <Files Include="..\bin\Setup\**" />
    </Fragment>
</Wix>

问题：需引用Fragment中的Property才能纳入Bundle，但不清楚如何在Bundle.wxs中引用。

解决方案 #

要实现将多文件提取到临时目录并执行EXE的需求，需用**ExePackage配合Payload元素**，同时利用WiX v5的<Files>批量导入文件，具体实现如下：

1. 创建包含多文件的PackageGroup #

在PackageWithMultipleFiles.wxs中，通过<PackageGroup>包裹ExePackage，并将<Files>作为PayloadGroup的子元素批量添加依赖文件：

<Wix xmlns="http://wixtoolset.org/schemas/v4/wxs">
    <Fragment>
        <PackageGroup Id="PackageWithMultipleFiles">
            <ExePackage
                Id="ToolSetupExe"
                SourceFile="..\bin\Setup\YourTool.exe" <!-- 指定要执行的目标EXE路径 -->
                InstallCommand="" <!-- 可选：添加EXE需要的执行参数 -->
                DetectCondition="false" <!-- 无需检测工具是否已安装 -->
                Permanent="yes" <!-- 不将该工具纳入WiX的卸载管理 -->
                Vital="yes" <!-- 该步骤失败则终止整个安装流程 -->
                Compressed="yes">

                <!-- 批量导入所有依赖文件，排除已作为SourceFile的EXE避免重复打包 -->
                <PayloadGroup>
                    <Files Include="..\bin\Setup\**" Exclude="..\bin\Setup\YourTool.exe" />
                </PayloadGroup>
            </ExePackage>
        </PackageGroup>
    </Fragment>
</Wix>

2. 关键说明 #

• <ExePackage>会自动将所有关联的Payload文件提取到WiX创建的临时目录，随后执行指定的EXE；
• <Files>在PayloadGroup下可通过通配符批量匹配文件，完全替代Heat的文件收集功能；
• 通过Exclude属性排除已作为SourceFile的EXE，避免重复打包；
• 设置DetectCondition="false"和Permanent="yes"，因为该工具仅临时执行安装逻辑，无需WiX管理其生命周期。

3. 关联到Bundle #

现有Bundle.wxs中已通过<PackageGroupRef Id="PackageWithMultipleFiles"/>完成引用，无需额外修改。

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