WiX多版本安装包配置：如何定义多个HarvestPaths？

我使用WiX构建安装程序，软件提供V23、V22、V21等多个版本的更新，借助Heat工具动态收集各版本所需的库文件（含自研库）。需要实现两个核心需求：

• 单个安装程序将所有版本内容安装至同一根目录的对应子文件夹，支持用户同时使用不同版本的软件；
• 构建安装程序时能正确获取各年度版本的编译产物。

原本计划为每个Heat生成的DLL列表设置不同的HarvestPath，但WiX/Heat不允许自定义HarvestPath名称，导致原有写法失效。以下是我尝试的配置代码，寻求可行的实现方案：

尝试的Installer.wixproj配置 #

<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|x86' ">
    <OutputPath>bin\$(Configuration)\</OutputPath>
    <IntermediateOutputPath>obj\$(Configuration)\</IntermediateOutputPath>
    <DefineConstants>HarvestPath23=..\MySoftware\bin\REL23\</DefineConstants>
    <DefineConstants>HarvestPath22=..\MySoftware\bin\REL22\</DefineConstants>
    <DefineConstants>HarvestPath21=..\MySoftware\bin\REL21\</DefineConstants>
    <Cultures>en-US</Cultures>
</PropertyGroup>

<ItemGroup>
    <Compile Include="Product.wxs"/>
    <!-- This is the Heat created one for 23 -->
    <Compile Include="HeatGeneratedFileList23.wxs"/>
    <!-- This is the Heat created one for 22 -->
    <Compile Include="HeatGeneratedFileList22.wxs"/>
    <!-- This is the Heat created one for 21 -->
    <Compile Include="HeatGeneratedFileList21.wxs"/>

</ItemGroup>

<Target Name="BeforeBuild">
    <HeatDirectory Directory="..\MySoftware\bin\REL23\" PreprocessorVariable="var.HarvestPath23" OutputFile="HeatGeneratedFileList23.wxs" ComponentGroupName="HeatGenerated23" RunAsSeparateProcess="$(RunWixToolsOutOfProc)" DirectoryRefId="INSTALLFOLDER23" AutogenerateGuids="true" ToolPath="$(WixToolPath)" SuppressFragments="true" SuppressRegistry="true" SuppressRootDirectory="true"/>
    <HeatDirectory Directory="..\MySoftware\bin\REL22\" PreprocessorVariable="var.HarvestPath22" OutputFile="HeatGeneratedFileList22.wxs" ComponentGroupName="HeatGenerated22" RunAsSeparateProcess="$(RunWixToolsOutOfProc)" DirectoryRefId="INSTALLFOLDER22" AutogenerateGuids="true" ToolPath="$(WixToolPath)" SuppressFragments="true" SuppressRegistry="true" SuppressRootDirectory="true"/>
    <HeatDirectory Directory="..\MySoftware\bin\REL21\" PreprocessorVariable="var.HarvestPath21" OutputFile="HeatGeneratedFileList21.wxs" ComponentGroupName="HeatGenerated21" RunAsSeparateProcess="$(RunWixToolsOutOfProc)" DirectoryRefId="INSTALLFOLDER21" AutogenerateGuids="true" ToolPath="$(WixToolPath)" SuppressFragments="true" SuppressRegistry="true" SuppressRootDirectory="true"/>
</Target>

尝试的Product.wxs配置 #

<Feature Id="ProductFeature23" Title="My super software 2023" Level="1"
         ConfigurableDirectory="INSTALLFOLDER23">
    <ComponentGroupRef Id="HeatGenerated23"/>
    <ComponentGroupRef Id="ProductContents"/>
</Feature>
<Feature Id="ProductFeature22" Title="My super software 2022" Level="1"
         ConfigurableDirectory="INSTALLFOLDER22">
    <ComponentGroupRef Id="HeatGenerated22"/>
</Feature>
<Feature Id="ProductFeature21" Title="My super software 2021" Level="1"
         ConfigurableDirectory="INSTALLFOLDER21">
    <ComponentGroupRef Id="HeatGenerated21"/>
</Feature>
</Product>

<Fragment>
    <Directory Id="TARGETDIR" Name="SourceDir">
        <Directory Id="CommonAppDataFolder" Name="MyAppDataFolder">
            <Directory Id="DIR_FOO" Name="FOO">
                <Directory Id="DIR_Contents" Name="Contents">
                    <Directory Id="INSTALLFOLDER23" Name="2023"/>
                    <Directory Id="INSTALLFOLDER22" Name="2022"/>
                    <Directory Id="INSTALLFOLDER21" Name="2021"/>
                </Directory>
            </Directory>
        </Directory>
    </Directory>
</Fragment>

可行解决方案 #

1. 修复预处理器变量定义错误 #

你当前重复定义了<DefineConstants>，MSBuild会覆盖前面的变量值，导致只有最后一个HarvestPath21生效。需要将所有变量合并到同一个<DefineConstants>节点，用分号分隔：

<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|x86' ">
    <OutputPath>bin\$(Configuration)\</OutputPath>
    <IntermediateOutputPath>obj\$(Configuration)\</IntermediateOutputPath>
    <DefineConstants>HarvestPath23=..\MySoftware\bin\REL23\;HarvestPath22=..\MySoftware\bin\REL22\;HarvestPath21=..\MySoftware\bin\REL21\</DefineConstants>
    <Cultures>en-US</Cultures>
</PropertyGroup>

2. 确认Heat命令的核心参数正确性 #

你设置的DirectoryRefId、SuppressRootDirectory="true"、AutogenerateGuids="true"都是正确的：

• DirectoryRefId将Heat收集的文件关联到对应版本的安装子目录
• SuppressRootDirectory="true"避免生成多余的根目录组件，直接将文件放入指定的子目录
• AutogenerateGuids="true"确保每个版本的组件GUID唯一，避免冲突

3. 可选：批量简化Heat命令（适用于多版本场景） #

如果后续还要添加更多版本，可以用MSBuild的ItemGroup批量管理版本信息，减少重复代码：

<ItemGroup>
    <VersionHarvest Include="23">
        <SourceDir>..\MySoftware\bin\REL23\</SourceDir>
        <OutputFile>HeatGeneratedFileList23.wxs</OutputFile>
        <ComponentGroup>HeatGenerated23</ComponentGroup>
        <InstallDir>INSTALLFOLDER23</InstallDir>
    </VersionHarvest>
    <VersionHarvest Include="22">
        <SourceDir>..\MySoftware\bin\REL22\</SourceDir>
        <OutputFile>HeatGeneratedFileList22.wxs</OutputFile>
        <ComponentGroup>HeatGenerated22</ComponentGroup>
        <InstallDir>INSTALLFOLDER22</InstallDir>
    </VersionHarvest>
    <VersionHarvest Include="21">
        <SourceDir>..\MySoftware\bin\REL21\</SourceDir>
        <OutputFile>HeatGeneratedFileList21.wxs</OutputFile>
        <ComponentGroup>HeatGenerated21</ComponentGroup>
        <InstallDir>INSTALLFOLDER21</InstallDir>
    </VersionHarvest>
</ItemGroup>

<Target Name="BeforeBuild">
    <HeatDirectory Directory="%(VersionHarvest.SourceDir)" 
                   PreprocessorVariable="var.HarvestPath%(VersionHarvest.Identity)" 
                   OutputFile="%(VersionHarvest.OutputFile)" 
                   ComponentGroupName="%(VersionHarvest.ComponentGroup)" 
                   RunAsSeparateProcess="$(RunWixToolsOutOfProc)" 
                   DirectoryRefId="%(VersionHarvest.InstallDir)" 
                   AutogenerateGuids="true" 
                   ToolPath="$(WixToolPath)" 
                   SuppressFragments="true" 
                   SuppressRegistry="true" 
                   SuppressRootDirectory="true"/>
</Target>

4. 验证组件与目录的关联一致性 #

确保Product.wxs中的ComponentGroupRefID和Heat命令中指定的ComponentGroupName完全匹配，同时每个Feature对应的ConfigurableDirectory与目录结构中的ID一致——你当前的配置已经满足这一点，无需修改。

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