.NET Standard 2.0项目遇WindowsAPICodePack兼容报错求助

问题场景 #

我有一个.NET Standard 2.0项目，它依赖另一个目标框架为net6.0-windows;net48的项目，该依赖项目使用了WindowsAPICodePack 7.0.4 NuGet包。构建解决方案时，依赖项目可正常构建，但当前项目触发了以下警告转错误：

Warning As Error: Package 'WindowsAPICodePack 7.0.4' was restored using '.NETFramework,Version=v4.6.1, .NETFramework,Version=v4.6.2, .NETFramework,Version=v4.7, .NETFramework,Version=v4.7.1, .NETFramework,Version=v4.7.2, .NETFramework,Version=v4.8, .NETFramework,Version=v4.8.1' instead of the project target framework '.NETStandard,Version=v2.0'. This package may not be fully compatible with your project.

解决方法 #

1. 针对特定包禁用警告转错误 #

如果确认该包在你的业务场景下可以正常工作，可直接在.NET Standard 2.0项目的.csproj文件中添加配置，忽略WindowsAPICodePack的兼容警告：

<Project Sdk="Microsoft.NET.Sdk">
  <!-- 保留原有项目配置 -->
  <PropertyGroup>
    <!-- 若不需要全局禁用警告转错误，可跳过此配置 -->
    <!-- <TreatWarningsAsErrors>false</TreatWarningsAsErrors> -->
  </PropertyGroup>

  <ItemGroup>
    <!-- 仅屏蔽WindowsAPICodePack的NU1701兼容警告 -->
    <PackageReference Include="WindowsAPICodePack" Version="7.0.4">
      <NoWarn>NU1701</NoWarn>
    </PackageReference>
  </ItemGroup>
</Project>

2. 优化依赖项目的多框架引用配置 #

由于依赖项目是多目标框架（net6.0-windows;net48），可以调整其.csproj文件，确保WindowsAPICodePack仅在对应框架下被引用，让.NET Standard 2.0项目匹配兼容的输出：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFrameworks>net6.0-windows;net48</TargetFrameworks>
  </PropertyGroup>

  <!-- 按目标框架分别引用包 -->
  <ItemGroup Condition="'$(TargetFramework)' == 'net48'">
    <PackageReference Include="WindowsAPICodePack" Version="7.0.4" />
  </ItemGroup>
  <ItemGroup Condition="'$(TargetFramework)' == 'net6.0-windows'">
    <PackageReference Include="WindowsAPICodePack" Version="7.0.4" />
  </ItemGroup>
</Project>

这样.NET Standard 2.0项目在引用依赖时，会自动匹配对应框架的输出，避免直接处理WindowsAPICodePack的兼容问题。

3. 强制指定包的还原框架 #

如果需要强制为.NET Standard 2.0还原该包，可以在项目根目录的NuGet.Config文件中添加框架重定向配置：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageRestore>
    <add key="enabled" value="True" />
    <add key="automatic" value="True" />
  </packageRestore>
  <packageSources>
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
  </packageSources>
  <frameworks>
    <!-- 强制将.NET Standard 2.0映射到.NET Framework 4.8进行包还原 -->
    <framework name=".NETStandard,Version=v2.0" targetFramework=".NETFramework,Version=v4.8" />
  </frameworks>
</configuration>

注意：这种方式可能引入潜在兼容风险，仅在确认包功能不受影响时使用。

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