如何在WixLib中定义HarvestDirectory及解决组件组引用未解析问题

1. 如何在WixLib中定义HarvestDirectory，让关联项目无需自行实现？ #

首先得明确：WiX的HarvestDirectory本质是调用Heat工具的预编译步骤，不能直接在.wxs文件中定义后打包进WixLib——因为WixLib是编译后的二进制库，而Harvest是在编译前生成WiX片段的过程。正确的做法是把Harvest的逻辑放在WixLib的项目文件（.wixproj）中，让库项目自己执行Heat生成所需的组件组，然后把这些生成的片段编译进库，这样主项目引用库后就能直接用，不用再跑Harvest。

具体步骤：

• 打开你的WixLib项目的.wixproj文件，添加一个自定义MSBuild任务，在编译前执行HeatDirectory（对应HarvestDirectory的MSBuild版本）。比如针对你的场景，配置类似这样：

  <Target Name="HarvestSaludosAssets" BeforeTargets="Compile">
    <HeatDirectory
      Directory="$(ProjectDir)sistema\saludos"
      DirectoryRefId="SaludosDir"
      ComponentGroupName="SaludosCompGroup"
      PreprocessorVariable="var.preVar"
      OutputFile="$(ProjectDir)Generated\HarvestedSaludos.wxs"
      AutogenerateGuids="true"
      SuppressCom="true"
      SuppressFragments="true"
      SuppressRegistry="true"
      SuppressRootDirectory="true"
      ToolPath="$(WixToolPath)"
    />
  </Target>
  

• 确保生成的HarvestedSaludos.wxs文件被包含在WixLib项目中（可以手动添加到项目，或者用<Content Include="Generated\*.wxs" />让MSBuild自动包含）。这样编译WixLib时，Heat生成的组件组就会被打包进库文件。
• 主项目只需要引用这个WixLib，然后直接用<ComponentGroupRef Id="SaludosCompGroup" />就能访问到捕获的目录组件，无需自己配置Harvest。

2. 解决ComponentGroupName引用未解析的问题 #

从你的代码来看，问题大概率出在Harvest生成的组件组没有被正确编译进WixLib，或者主项目没有正确引用到库中的组件组。这里给你几个排查和解决的方向：

检查WixLib的Heat执行配置 #

• 确认你的WixLib项目中确实配置了HeatDirectory任务（像上面第一步的配置），并且这个任务在编译前执行了。可以查看输出日志，看是否有Heat运行的记录，以及是否生成了对应的.wxs文件。
• 检查生成的.wxs文件中，是否存在<ComponentGroup Id="SaludosCompGroup">的定义——如果Heat没生成这个，那肯定会提示引用未解析。

确认组件组的作用域和引用链 #

• 你在WixLib中定义的fooLibraryItems组件组引用了SaludosCompGroup，要确保fooLibraryItems本身是公开的（WiX组件组默认是公开的，除非加了Private="yes"），这样主项目引用库后才能访问到。
• 主项目中引用fooLibraryItems的代码要确保正确：<ComponentGroupRef Id="fooLibraryItems"/>，同时主项目必须正确引用了你的WixLib（在主项目的.wixproj里添加<ProjectReference>或者引用编译好的.wixlib文件）。

验证预处理器变量和路径 #

• 你的Harvest配置中用到了var.preVar，要确保主项目中定义了这个变量（比如在主项目的.wixproj或者预处理器定义中设置var.preVar=xxx），如果变量未定义，可能导致Heat生成的路径有问题，间接导致组件组无法被正确识别。

清理缓存并重新生成 #

• 有时候Visual Studio的缓存会导致引用异常，尝试清理整个解决方案的bin/obj目录，然后先重新生成WixLib项目，再生成主项目。

内容的提问来源于stack exchange，提问作者Yopy Hi del Cano