在WiX Toolset项目中使用自定义变量遇WIX0150错误求助

错误原因 #

你在wixproj文件的<DefineConstants>节点内错误使用了WiX预处理器语法<?define ...?>。<DefineConstants>是MSBuild的属性，要求内容为分号分隔的键值对，而非WiX预处理器指令。这种写法会导致WiX无法解析出正确的预处理器变量，从而抛出WIX0150 Undefined preprocessor variable错误。

解决方案 #

方案1：通过MSBuild属性传递变量（推荐用于多环境配置） #

修正wixproj文件中的<DefineConstants>配置，改用MSBuild的键值对格式：

<Project Sdk="WixToolset.Sdk/4.0.3">
    <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">
        <!-- 直接用键值对定义变量，多个变量用分号分隔 -->
        <DefineConstants>MyVariable=Filepath</DefineConstants>
    </PropertyGroup>
</Project>

方案2：在WiX文件中直接定义预处理器变量（适用于无需环境切换的场景） #

如果不需要通过MSBuild区分配置环境，可以直接在WiX组件文件开头添加预处理器指令：

<?xml version="1.0" encoding="UTF-8"?>
<?define MyVariable = "Filepath" ?>
<Wix xmlns="http://wixtoolset.org/schemas/v4/wxs">
    <Fragment>
        <Component Id="HandlerCmp" Directory="INSTALLFOLDER">
            <File Source="$(MyVariable)" />
        </Component>
    </Fragment>
</Wix>

验证 #

修改完成后重新构建项目，WiX预处理器就能正确识别$(MyVariable)变量，构建错误即可消除。

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