WixToolset从4.0.1升级到6.0.1：旧Heat配置能否与新高级收割1:1映射？

问题 #

将WixToolset从4.0.1版本升级至6.0.1版本后，尝试将.wixproj文件中的旧Heat配置替换为官方推荐的高级收割（Advanced Harvesting）配置。以下是旧配置示例：

旧HarvestDirectory配置 #

<!--Harvest Java Begin -->
<ItemGroup>
  <HarvestDirectory Include="bin/Debug/Ressources/java">
    <ComponentGroupName>JavaComponentGroup</ComponentGroupName>
    <SuppressRootDirectory>true</SuppressRootDirectory>
    <KeepEmptyDirectories>true</KeepEmptyDirectories>
    <DirectoryRefId>JavaDir</DirectoryRefId>
    <PreprocessorVariable>var.javares</PreprocessorVariable>
    <Transforms>$(SolutionDir)SymmetriXCentral\JavaWxsTransform.xslt</Transforms>
    <SuppressRegistry>true</SuppressRegistry>
  </HarvestDirectory>
  <BindPath Include="bin/Debug/Ressources/java" />
</ItemGroup>
<PropertyGroup>
  <!-- <HarvestDirectorySuppressFragments>true</HarvestDirectorySuppressFragments> -->
  <HarvestDirectoryGenerateGuidsNow>true</HarvestDirectoryGenerateGuidsNow>
  <HarvestDirectoryAutogenerateGuids>false</HarvestDirectoryAutogenerateGuids>
  <HarvestDirectoryTreatWarningsAsErrors>false</HarvestDirectoryTreatWarningsAsErrors>
</PropertyGroup>
<!--Harvest Java End -->

DefineConstants配置 #

<DefineConstants>Debug;javares=bin\Debug\Ressources\java;ProductVersion=1.0.0.0</DefineConstants>

PackageReference配置 #

<PackageReference Include="WixToolset.Heat" Version="6.0.1" />

请问旧配置能否与新的高级收割配置实现1:1映射？初步看来似乎完全不可能，因为HarvestFolder元素并不具备类似的属性或子元素。

回答 #

旧的HarvestDirectory配置无法和新的HarvestFolder（高级收割）实现完全1:1映射，但大部分核心功能都能通过新配置的属性、全局参数或间接方式实现，具体对应关系如下：

1. 基础收割目标与绑定路径 #

• 旧<HarvestDirectory Include="..."> → 新<HarvestFolder Include="...">，路径指定逻辑完全一致
• 旧<BindPath> → 新配置无需单独声明，HarvestFolder会自动识别收割路径作为绑定路径的一部分，也可继续保留原<BindPath>配置（兼容）

2. 旧HarvestDirectory子元素的对应处理 #

• ComponentGroupName → 新配置直接使用同名属性声明：

  <HarvestFolder Include="bin/Debug/Ressources/java" ComponentGroupName="JavaComponentGroup" />
  

• SuppressRootDirectory → 新配置无直接属性，可通过XSLT转换调整收割后的目录结构，或缩短收割路径层级来实现相同效果
• KeepEmptyDirectories → 新配置直接使用同名属性声明
• DirectoryRefId → 新配置直接使用同名属性声明
• PreprocessorVariable → 新配置无直接属性，可在指定的XSLT转换中引用预处理变量，或手动调整收割生成的WXS内容完成变量替换
• Transforms → 新配置直接使用同名属性声明，支持指定XSLT文件路径
• SuppressRegistry → 新配置直接使用同名属性声明

3. 旧PropertyGroup全局参数的对应处理 #

• HarvestDirectoryGenerateGuidsNow → 新配置使用GenerateGuidsNow全局属性（作用于所有HarvestFolder），或在单个HarvestFolder上声明同名属性
• HarvestDirectoryAutogenerateGuids → 新配置使用AutogenerateGuids全局属性或单个HarvestFolder的同名属性
• HarvestDirectoryTreatWarningsAsErrors → 新配置使用TreatWarningsAsErrors全局属性或单个HarvestFolder的同名属性

关键差异说明 #

新的高级收割（HarvestFolder）设计更偏向模块化和灵活扩展，部分旧属性没有直接对应项（如PreprocessorVariable），需要通过XSLT转换或其他间接方式补全功能。但整体核心收割逻辑、组件组管理、目录映射等核心功能都能覆盖，不存在无法替代的关键功能缺失。

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