如何在Bundle.wxs中引用组件内定义的[PRODUCTNAME]变量？

问题背景 #

Bootstrapper项目需通过注册表搜索判断已安装程序的32/64位架构，以安装对应驱动。希望在注册表搜索路径SOFTWARE\MyCompany\[PRODUCTNAME]中使用[PRODUCTNAME]变量——该变量在Registry.wxs的Component内通过RegistryValue定义，且已在多个Product.wxs中复用。

此前尝试在Bundle标签内添加组件组引用代码：

<util:ComponentGroupRef Id="RegistryComponents" />

并在Bundle下的Fragment中定义组件组：

<Fragment>
     <ComponentGroup Id="RegistryComponents">
          <ComponentGroupRef Id="Registry" />
     </ComponentGroup>
</Fragment>

但触发错误：

The Bundle element contains an unexpected child element 'util:ComponentGroupRef'.

核心原因 #

WiX中**Bundle（引导程序）与MSI Product（安装包）**属于不同层级：Component/ComponentGroup是MSI安装包的专属组件集合，仅适用于Product上下文，Bundle的XML结构不支持直接引用这些MSI元素，因此报错。

正确解决方案：抽离全局预处理器变量 #

将PRODUCTNAME抽为全局预处理器变量，让Bundle和所有Product项目共享，步骤如下：

1. 创建全局变量文件
   新建GlobalVariables.wxi文件，定义预处理器变量：

<?xml version="1.0" encoding="utf-8"?>
<Include>
  <?define PRODUCTNAME = "你的产品名称"?>
</Include>

2. 在所有相关文件中引入变量文件
   在Registry.wxs、所有Product.wxs以及Bundle.wxs的顶部添加引用：

<?include GlobalVariables.wxi?>

3. 在Registry.wxs中使用预处理器变量
   修改RegistryValue的路径，用$(var.PRODUCTNAME)替代原变量：

<Component Id="RegistryComponent" Guid="*">
  <RegistryValue 
    Root="HKLM" 
    Key="SOFTWARE\MyCompany\$(var.PRODUCTNAME)" 
    Name="Platform" 
    Value="x64" 
    Type="string" 
    KeyPath="yes" />
</Component>

4. 在Bundle.wxs的注册表搜索中使用变量
   修改util:RegistrySearch的路径，同样使用$(var.PRODUCTNAME)：

<util:RegistrySearch
  Id="DetectInstalledPlatform"
  Root="HKLM"
  Key="SOFTWARE\MyCompany\$(var.PRODUCTNAME)"
  Name="Platform"
  Result="value"
  Variable="InstalledPlatform"
  Win64="yes" <!-- 按需启用，用于64位注册表路径搜索 -->
/>

动态编译扩展方案 #

若需在编译时动态指定PRODUCTNAME，无需修改wxi文件，可通过MSBuild参数传递：

msbuild YourSolution.sln /p:DefineConstants="PRODUCTNAME=你的动态产品名"

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