UAP应用能否调用.NET 8类库？遇NU1701兼容性警告

问题本质 #

NU1701警告的核心是NuGet无法确认你的自定义类库与UAP目标框架（UAP,Version=v10.0.22000）的兼容性。第三方库比如Microsoft.Extensions.Logging没触发警告，是因为它们在打包时明确声明了对UAP（或等效的Windows平台兼容框架）的支持，而你的自定义类库缺少这些兼容性配置。

修复步骤 #

1. 修正自定义类库的.csproj配置 #

打开类库的项目文件，确保目标框架指定为带对应Windows版本的.NET，同时明确最小平台版本：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <!-- 匹配UAP项目的Windows版本，指定带平台约束的目标框架 -->
    <TargetFramework>net8.0-windows10.0.22000</TargetFramework>
    <!-- 如需兼容多版本，可替换为多框架声明 -->
    <!-- <TargetFrameworks>net6.0-windows10.0.22000;net7.0-windows10.0.22000;net8.0-windows10.0.22000</TargetFrameworks> -->
    <TargetPlatformMinVersion>10.0.22000.0</TargetPlatformMinVersion>
    <!-- 无需WinForms/WPF时可删除以下两行 -->
    <UseWindowsForms>false</UseWindowsForms>
    <UseWpf>false</UseWpf>
  </PropertyGroup>
</Project>

2. 添加NuGet兼容性元数据 #

如果你的类库是打包为NuGet包使用的，必须在.csproj中声明兼容框架，让NuGet识别其适配UAP项目：

<PropertyGroup>
  <!-- 明确列出支持的框架，包含UAP和对应.NET版本 -->
  <PackageSupportedFrameworks>net6.0-windows;net7.0-windows;net8.0-windows;uap10.0.22000</PackageSupportedFrameworks>
  <!-- 也可通过PackageTargetFallback设置兼容 fallback -->
  <!-- <PackageTargetFallback>$(PackageTargetFallback);uap10.0.22000;netcoreapp3.1</PackageTargetFallback> -->
</PropertyGroup>

3. 清理重建项目 #

完成配置后，执行以下操作确保变更生效：

• 删除类库和UAP项目的bin、obj文件夹
• 在UAP项目根目录运行命令：dotnet restore
• 重新编译整个解决方案

4. 排查API兼容性问题 #

若警告仍存在，检查类库是否使用了UAP不支持的API：

• 右键类库项目 → 属性 → 调试 → 勾选「启用API兼容性检查」
• 目标平台选择UAP 10.0.22000，运行分析后修复不兼容的API调用

第三方库无警告的原因 #

像Microsoft.Extensions.Logging这类官方库，在打包时已经通过PackageSupportedFrameworks明确标注了对UAP的兼容性，且经过官方兼容性测试，NuGet可直接确认其适配性，因此不会触发警告。

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