如何通过Wix 4与HEAT成功注册.NET 6 COM DLL？

我有一个32位DLL，需要在Windows中注册其中所有公共类以用于COM，计划通过Wix4构建的MSI安装程序部署。为了通过Regsvr32.exe注册该DLL，我在.csproj文件中添加如下配置生成配套的comhost DLL：

<PropertyGroup>
    <EnableComHosting>true</EnableComHosting>
</PropertyGroup>

手动使用Regsvr32.exe注册comhost后，原DLL可正常用于COM，但通过Wix的HEAT工具采集该comhost DLL并纳入安装程序时，目标机器上无法完成注册。HEAT采集配置如下：

<ItemGroup>
  <HarvestFile Include="path\to\dll\dllToDeploy.comhost.dll">
    <ComponentGroupName>DllToDeployComHost</ComponentGroupName>
    <DirectoryRefId>INSTALLFOLDER</DirectoryRefId>
    <SuppressRootDirectory>true</SuppressRootDirectory>
  </HarvestFile>
</ItemGroup>

生成的注册表项与其他正常工作的COM DLL类似，请问该如何解决？

1. 指定32位采集平台 #

Heat工具默认会以当前系统位数（如64位）采集注册表项，但你的comhost是32位，会导致生成的注册表项写入64位注册表路径（HKLM\Software\Classes），而非32位专属的HKLM\Software\Wow6432Node\Classes。在HarvestFile配置中添加<Platform>属性指定x86：

<HarvestFile Include="path\to\dll\dllToDeploy.comhost.dll">
    <ComponentGroupName>DllToDeployComHost</ComponentGroupName>
    <DirectoryRefId>INSTALLFOLDER</DirectoryRefId>
    <SuppressRootDirectory>true</SuppressRootDirectory>
    <Platform>x86</Platform>
</HarvestFile>

2. 修正组件的64位标记 #

打开Heat生成的.wxs文件，检查对应Component元素是否包含Win64="yes"属性。32位组件不能标记为64位，否则MSI会在64位系统上跳过注册逻辑，需删除该属性或设置为Win64="no"。

3. 改用自定义动作调用Regsvr32（备选方案） #

如果Heat采集的注册表项仍有缺失，可直接在Wix组件中添加自定义动作调用Regsvr32完成注册：

<Component Id="DllToDeployComHost" Guid="*" Directory="INSTALLFOLDER">
    <File Id="DllToDeployComHostFile" Source="path\to\dll\dllToDeploy.comhost.dll" KeyPath="yes" />
    <!-- 注册动作 -->
    <CustomAction Id="RegisterComHost" Execute="deferred" Impersonate="no" 
                  ExeCommand='C:\Windows\SysWOW64\regsvr32.exe /s "[INSTALLFOLDER]dllToDeploy.comhost.dll"' 
                  Return="check" />
    <!-- 卸载时反注册 -->
    <CustomAction Id="UnregisterComHost" Execute="deferred" Impersonate="no" 
                  ExeCommand='C:\Windows\SysWOW64\regsvr32.exe /u /s "[INSTALLFOLDER]dllToDeploy.comhost.dll"' 
                  Return="check" />
    <!-- 绑定动作到安装序列 -->
    <InstallExecuteSequence>
        <Custom Action="RegisterComHost" After="InstallFiles">NOT Installed</Custom>
        <Custom Action="UnregisterComHost" Before="RemoveFiles">Installed</Custom>
    </InstallExecuteSequence>
</Component>

注：64位系统中必须调用C:\Windows\SysWOW64\regsvr32.exe（32位版本），避免误调用64位的C:\Windows\System32\regsvr32.exe。

4. 检查依赖项完整性 #

用Dependency Walker工具扫描comhost DLL，确认所有依赖项（如VC++运行时、第三方DLL）都已纳入MSI安装包。手动注册时依赖可能已存在于本地系统，但干净机器上会因缺失依赖导致注册失败。

5. 分析MSI安装日志 #

生成安装日志定位具体错误：

msiexec /i YourInstaller.msi /l*v install.log

在日志中搜索COM、regsvr32、error等关键词，可找到注册失败的直接原因（如注册表写入权限、文件缺失、依赖错误等）。

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