Wix Toolset V4捆绑包项目内置变量使用方法咨询

问题原因 #

Wix4对Bundle变量的解析逻辑做了调整：<Variable>的Value属性在编译时被当作字面量处理，不会自动解析Burn内置变量（如[ProgramFiles64Folder]），而Wix3中存在隐式的运行时解析逻辑，导致迁移后原有写法失效。

可行解决方案 #

方案1：使用SetVariable在运行时解析内置变量

通过SetVariable动作在Bundle启动阶段动态拼接路径，确保内置变量在目标机器上被正确解析：

<?include Variables.wxi ?>
<Wix xmlns:bal="http://wixtoolset.org/schemas/v4/wxs/bal" xmlns="http://wixtoolset.org/schemas/v4/wxs">
  <Bundle Name="$(var.ProductName)" Version="$(var.ProductVersion)" Manufacturer="$(var.ManufacturerName)"
          UpgradeCode="39FA01F0CAD240169A99464AD20176DF">
    <BootstrapperApplication>
      <bal:WixStandardBootstrapperApplication LicenseFile="$(var.ResourceDir)License.rtf" LogoFile="Logo.png"
                                              Theme="rtfLicense" />
    </BootstrapperApplication>

    <!-- 运行时动态设置安装路径，Sequence=1确保在链执行前完成 -->
    <SetVariable Name="InstallFolder" Value="[ProgramFiles64Folder]$(var.ManufacturerName)\$(var.ProductName)" Sequence="1" />

    <Chain>
      <MsiPackage SourceFile="$(var.MsiInstaller.TargetDir)Installer.msi" ForcePerMachine="yes">
        <MsiProperty Name="INSTALLDIR" Value="[InstallFolder]" />
      </MsiPackage>
    </Chain>

    <!-- 初始值设为空，由SetVariable覆盖 -->
    <Variable Name="InstallFolder" Type="string" Value="" />
    <Variable Name="LaunchTarget" Value="[InstallFolder]\Installer.exe" />
  </Bundle>
</Wix>

方案2：通过RegistrySearch获取目标机器的Program Files路径

如果需要更灵活的路径探测，可通过注册表搜索获取目标机器的64位Program Files目录：

<?include Variables.wxi ?>
<Wix xmlns:bal="http://wixtoolset.org/schemas/v4/wxs/bal" xmlns="http://wixtoolset.org/schemas/v4/wxs">
  <Bundle Name="$(var.ProductName)" Version="$(var.ProductVersion)" Manufacturer="$(var.ManufacturerName)"
          UpgradeCode="39FA01F0CAD240169A99464AD20176DF">
    <BootstrapperApplication>
      <bal:WixStandardBootstrapperApplication LicenseFile="$(var.ResourceDir)License.rtf" LogoFile="Logo.png"
                                              Theme="rtfLicense" />
    </BootstrapperApplication>

    <!-- 注册表搜索获取目标机器的64位Program Files路径 -->
    <Variable Name="TargetProgramFiles64" Type="string" />
    <RegistrySearch Id="FindProgramFiles64"
                    Root="HKLM"
                    Key="SOFTWARE\Microsoft\Windows\CurrentVersion"
                    Name="ProgramFilesDir"
                    Variable="TargetProgramFiles64"
                    Win64="yes" />

    <!-- 拼接最终安装路径 -->
    <SetVariable Name="InstallFolder" Value="[TargetProgramFiles64]$(var.ManufacturerName)\$(var.ProductName)" Sequence="1" />

    <Chain>
      <MsiPackage SourceFile="$(var.MsiInstaller.TargetDir)Installer.msi" ForcePerMachine="yes">
        <MsiProperty Name="INSTALLDIR" Value="[InstallFolder]" />
      </MsiPackage>
    </Chain>

    <Variable Name="InstallFolder" Type="string" Value="" />
    <Variable Name="LaunchTarget" Value="[InstallFolder]\Installer.exe" />
  </Bundle>
</Wix>

注意事项 #

• 避免使用编译时变量（如$(env.ProgramW6432)）：这类变量会使用构建机器的路径，而非目标安装机器的实际路径，导致跨机器部署时路径错误。
• SDK风格项目的差异：Wix4 SDK项目对变量作用域和解析时机的限制更严格，必须显式通过运行时动作处理动态路径。

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