如何将WixToolset与GitHub Actions集成？解决预处理器变量未定义错误

核心问题原因 #

$(var.i2vPatchApplier.TargetPath)是WiX依赖项目引用自动生成的预处理器变量，在CI环境中如果没有正确构建依赖项目、或者WiX项目未正确关联依赖项目，就会出现变量未定义的错误。以下是三种直接传递exe路径的解决方法：

方法1：通过MSBuild参数传递自定义变量 #

在GitHub Actions的构建步骤中，直接给WiX项目传递exe的输出路径：

- name: 构建WiX安装包
  run: |
    msbuild YourWixProject.wixproj /p:Configuration=Release /p:DefineConstants="ExeTargetPath=../i2vPatchApplier/bin/Release/i2vPatchApplier.exe"

然后修改Product.wxs中的Source属性，使用自定义变量：

<Component Id="MainApplication" Guid="YOUR-GUID-HERE">
  <File Source="$(var.ExeTargetPath)" KeyPath="yes" />
</Component>

方法2：直接指定exe的相对/绝对路径 #

如果明确知道CI环境中exe的输出位置，直接写死路径（注意匹配构建后的目录结构）：

<Component Id="MainApplication" Guid="YOUR-GUID-HERE">
  <File Source="../i2vPatchApplier/bin/Release/net6.0/i2vPatchApplier.exe" KeyPath="yes" />
</Component>

注意：要确保主项目先完成构建，exe文件已经生成在指定路径。

方法3：修复项目引用并按顺序构建 #

如果想继续使用$(var.i2vPatchApplier.TargetPath)，需要确保：

• WiX项目已在本地添加对i2vPatchApplier项目的引用（Visual Studio中右键WiX项目→添加→项目引用）
• GitHub Actions中先构建主项目，再构建WiX项目：

- name: 构建主应用程序
  run: msbuild i2vPatchApplier/i2vPatchApplier.csproj /p:Configuration=Release

- name: 构建WiX安装包
  run: msbuild YourWixProject/YourWixProject.wixproj /p:Configuration=Release

这样WiX构建时就能自动获取到依赖项目的TargetPath变量。

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