在.NET 6 WPF中使用C++/WinRT组件的CsWinRT配置异常求助

问题背景 #

开发基于.NET 6及以上版本的WPF应用，计划通过CsWinRT集成现有C++代码（采用WinRT组件模型替代P/Invoke）。该方案在WinUI3应用中已成功落地，但在WPF项目中出现异常：

• 未在C#代码中添加目标WinRT组件的using指令及调用代码时，C#投影文件可正常生成在obj\Debug\net6.0-windows\Generated Files\CsWinRT路径下；
• 添加using指令并重建项目后，上述投影文件直接消失。

已知背景：早期非打包桌面应用不支持WinRT组件，2019年推出免注册WinRT方案，但.NET 5移除了直接引用.winmd文件的能力，必须依赖CsWinRT包。官方文档提到需将WinRT组件打包为NuGet包后引用，但有微软员工说明CsWinRT支持直接引用项目的简化流程。

可能原因 #

1. 框架机制差异：WinUI3基于UWP生态，对WinRT组件的加载逻辑与传统WPF桌面应用存在本质区别，CsWinRT在处理WPF项目的代码引用时，触发了投影生成的条件逻辑错误。
2. 直接项目引用的兼容性bug：当前版本的CsWinRT对WPF项目的直接项目引用支持存在缺陷，当代码中出现using引用时，构建过程误判为无需生成投影，或自动清理了已生成的投影文件。
3. 免注册WinRT适配问题：非打包WPF应用的免注册WinRT机制与CsWinRT的投影生成流程未完全适配，代码引用触发后，构建环节错误地删除了投影文件。

解决方法 #

1. 切换为NuGet包引用（官方稳定方案） #

尽管有直接项目引用的简化流程说明，但当前CsWinRT对WPF的直接引用支持存在不稳定情况，建议将C++ WinRT组件打包为NuGet包后引用：

• 在C++ WinRT项目中配置NuGet打包，确保包内包含.winmd文件及必要的原生依赖文件；
• 在WPF项目中安装该NuGet包，CsWinRT会自动处理投影生成和依赖加载逻辑。

2. 手动强制CsWinRT生成投影 #

在WPF项目的.csproj文件中添加显式配置，强制CsWinRT生成投影文件，不受代码中using引用的影响：

<PropertyGroup>
  <!-- 强制生成投影 -->
  <CsWinRTGenerateProjection>true</CsWinRTGenerateProjection>
  <!-- 指定要生成投影的WinRT组件.winmd路径，可使用项目相对路径或变量 -->
  <CsWinRTIncludeWinMDs>..\YourCppWinRTProject\bin\Debug\x64\YourComponent.winmd</CsWinRTIncludeWinMDs>
</PropertyGroup>

3. 检查并调整自定义构建事件 #

查看WPF项目是否存在自定义构建事件（如预生成/后生成事件），确认是否有逻辑在重建时删除了Generated Files\CsWinRT目录下的文件，若有则修改事件脚本，保留投影文件。

4. 升级CsWinRT到最新版本 #

检查当前使用的Microsoft.Windows.CsWinRT包版本，升级到最新稳定版，该问题可能已在后续版本中被修复。

5. 配置免注册WinRT兼容项 #

在WPF项目的.csproj中添加免注册WinRT的配置，确保组件能被正确加载：

<PropertyGroup>
  <EnableRegistrationFreeWinRT>true</EnableRegistrationFreeWinRT>
</PropertyGroup>

同时在C++ WinRT组件项目的属性中，将"Registration Free WinRT"设置为true，保证组件支持免注册加载。

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