Wix 5中Heat采集异常：无法识别命名空间组件

错误分析与逐个解决 #

1. WIX0200：未处理扩展元素HarvestProjectOutput #

hbt:HarvestProjectOutput是HeatWave Build Tools提供的扩展元素，不能嵌套在<Component>标签内，它需要直接作为<Feature>的子元素使用，用于自动收割指定项目的输出文件并生成对应的Component。

2. WIX0230 & WIX0330：Component缺少Id且Guid无效 #

• 当Component没有指定Id且没有文件作为KeyPath时，Wix无法自动生成默认Id；
• 若Component以目录作为KeyPath（即内部没有文件），不能使用自动Guid（*），必须显式指定Guid；
• 你原本用于包裹hbt:HarvestProjectOutput的Component完全多余，因为hbt:HarvestProjectOutput会自动生成所需的Components。

修正后的Wix代码（Package.wxs） #

<?xml version="1.0" encoding="UTF-8"?>
<Wix xmlns="http://wixtoolset.org/schemas/v4/wxs"
     xmlns:hbt="http://www.firegiant.com/schemas/v4/wxs/heatwave/buildtools">
    <Package Manufacturer="Denis Ivanov" 
             Name="Adjustrix Desktop" 
             UpgradeCode="5e40079f-d71d-4357-8339-bea315159720"
             Version="0.1">
        <StandardDirectory Id="ProgramFilesFolder">
            <Directory Id="PFRoot" Name="Adjustrix">
                <Directory Id="DesktopRoot" Name="Desktop">
                    <Directory Id="AppearanceFolder" Name="appearance"/>
                    <Directory Id="RuntimeFolder" Name="runtime"/>
                </Directory>
            </Directory>
        </StandardDirectory>

        <Feature Id="AppearanceInstall" Title="Appearance Files" Level="1">
            <Component Id="LogoComponent" Directory="AppearanceFolder" Guid="*">
                <File Source="C:\Users\denis\source\repos\Adjustrix\Logo3.ico" KeyPath="yes"/>
            </Component>
        </Feature>

        <Feature Id="ProgramInstall" Title="Main Application" Level="1">
            <!-- 直接收割WPF项目的发布输出到RuntimeFolder -->
            <hbt:HarvestProjectOutput Id="AdjustrixWPFHarvest"
                                      Project="AdjustrixWPF"
                                      Directory="RuntimeFolder"/>
            
            <!-- 单独添加主EXE到DesktopRoot（如果需要和runtime分离的话） -->
            <Component Id="MainExeComponent" Directory="DesktopRoot" Guid="*">
                <File Source="C:\Users\denis\source\repos\Adjustrix\AdjustrixWPF\bin\Release\net8.0-windows\AdjustrixWPF.exe" KeyPath="yes"/>
            </Component>
        </Feature>
    </Package>
</Wix>

修正后的Wix项目文件（.wixproj） #

<Project Sdk="WixToolset.Sdk/5.0.2">
  <ItemGroup>
    <PackageReference Include="FireGiant.HeatWave.BuildTools.wixext" Version="5.0.3" />
    <PackageReference Include="WixToolset.Heat" Version="5.0.2" />
  </ItemGroup>
  <ItemGroup>
    <ProjectReference Include="..\AdjustrixWPF\AdjustrixWPF.csproj" 
                      Publish="true" 
                      HarvestOutputGroup="PublishedItemsOutputGroup" />
  </ItemGroup>
</Project>

额外说明 #

• hbt:HarvestProjectOutput的Project属性要和你的WPF项目名称一致（确保项目引用已经正确添加）；
• 每个Component都显式指定了Id和Guid="*"（因为这些Component都包含文件作为KeyPath，符合自动生成Guid的条件）；
• 如果不需要把主EXE和runtime分离，可以移除单独的MainExeComponent，让hbt:HarvestProjectOutput自动收割所有发布文件到DesktopRoot或RuntimeFolder。

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