如何在.NET 5 Windows应用中正确引用uap10.0.x版本的UWP SDK

核心结论 #

• 普通Windows桌面应用（WinForms、WPF、.NET 5+控制台等）可以直接调用适配uap10.0.x的Windows SDK能力，不需要单独创建独立UWP项目、通过跨进程启动的方式间接调用。
• 你此前遇到的所有编译、运行时报错，本质是SDK引用方式、框架配置不匹配导致的，并非场景本身不支持。

此前踩坑的问题根因 #

• 引入Microsoft.Windows.SDK.Contracts触发CLR编译失败：该包是为旧版.NET Framework非打包应用设计的早期UWP SDK适配组件，和.NET 5+环境、新版Microsoft.Windows.CsWinRT存在版本冲突，硬引入必然触发CLR解析错误。
• 在TargetFrameworks中加入uap目标框架后，WinForms等依赖库编译报错：uap目标框架是专为MSIX打包的UWP/桌面桥应用设计的，只要把它加入普通桌面项目的目标框架列表，整个项目的依赖解析逻辑会切换到UWP专属包体系，自然找不到WinForms这类桌面框架库的适配版本，直接触发编译失败。
• 搭建.NET Standard类库引用UWP SDK，被.NET 5.0应用引用后运行时抛「Platform not supported」报错：.NET Standard框架本身没有WinRT类型投影的解析能力，哪怕通过自定义编译常量把代码限制在Windows分支，运行时也加载不到对应的WinRT互操作组件，必然抛出平台不支持错误。

正确的落地配置步骤 #

• 第一步：清理所有试错产生的冗余配置
  • 移除项目中引用的Microsoft.Windows.SDK.Contracts包
  • 从TargetFrameworks配置中删掉所有新增的uap专属目标框架条目，保留项目原本的桌面框架目标
  • 移除那个引用了UWP SDK的.NET Standard类库项目，避免跨项目的类型解析冲突
• 第二步：配置正确的目标框架标识
  • SDK风格的桌面项目不需要额外加uap目标框架，直接把现有-windows后缀的目标框架升级为带具体SDK版本的标识即可，比如从net8.0-windows改成net8.0-windows10.0.19041.0，这个配置等价于适配对应版本的uap10.0.x SDK，同时不会影响WinForms、WPF等桌面库的正常引用。
  • 按需引入匹配版本的Microsoft.Windows.CsWinRT包，版本和项目的.NET版本、目标SDK版本匹配即可，不要使用跨大版本的过新/过旧包。
• 第三步：正确处理条件编译逻辑
  • 不需要手动自定义编译常量，配置完带SDK版本的-windows10.0.x目标框架后，编译器会自动生成内置条件，比如WINDOWS10_0_19041_0_OR_GREATER，直接把所有调用UAP SDK API的代码块包在这个条件判断里，就能避免非Windows平台下的编译、运行错误。

什么时候需要单独创建UWP项目调用 #

• 只有当你需要调用的UAP SDK API明确要求应用必须在MSIX打包的沙箱容器内运行时，才需要考虑单独搭建UWP项目、通过跨进程通信的方式实现调用。
• 绝大多数uap10.0.x版本的公开SDK能力，普通非打包的桌面应用都可以通过上面的配置直接调用，完全不需要绕跨进程的弯路。

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