针对不同的运行时验证包

可为 NuGet 包中的不同运行时选择不同的实现程序集。 在这种情况下,需要确保这些程序集彼此兼容并与编译时程序集兼容。

例如,考虑以下情况。 你正在开发一个库,该库涉及分别对 Unix 和 Windows API 的一些互操作调用。 你已经编写了以下代码:

#if Unix
    public static void Open(string path, bool securityDescriptor)
    {
        // Call Unix specific stuff.
    }
#else
    public static void Open(string path)
    {
        // Call Windows specific stuff.
    }
#endif

生成的包结构如下所示。

lib/net6.0/A.dll
runtimes/unix/lib/net6.0/A.dll

无论基础操作系统是哪种,都请在编译时使用 lib\net6.0\A.dll。 对于非 Unix 系统,也会在运行时使用 lib\net6.0\A.dll。 但是,对于 Unix 系统,将在运行时使用 runtimes\unix\lib\net6.0\A.dll

当你尝试打包此项目时,会遇到以下错误:

D:\demo>dotnet pack
Microsoft (R) Build Engine version 17.0.0-preview-21460-01+8f208e609 for .NET
Copyright (C) Microsoft Corporation. All rights reserved.

  Determining projects to restore...
  All projects are up-to-date for restore.
  You are using a preview version of .NET. See: https://aka.ms/dotnet-core-preview
  PackageValidationThrough -> D:\demo\bin\Debug\net6.0\PackageValidationThrough.dll
  Successfully created package 'D:\demo\bin\Debug\PackageValidationThrough.1.0.0.nupkg'.
C:\Program Files\dotnet\sdk\6.0.100-rc.1.21463.6\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Compatibility.Common.targets(32,5): error CP0002: Member 'A.B.Open(string)' exists on lib/net6.0/PackageValidationThrough.dll but not on runtimes/unix/lib/net6.0/PackageValidationThrough.dll [D:\demo\PackageValidationThrough.csproj]
C:\Program Files\dotnet\sdk\6.0.100-rc.1.21463.6\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Compatibility.Common.targets(32,5): error CP0002: Member 'A.B.Open(string, bool)' exists on runtimes/unix/lib/net6.0/PackageValidationThrough.dll but not on lib/net6.0/PackageValidationThrough.dll [D:\demo\PackageValidationThrough.csproj]

MultipleRuntimes

你发现了错误并将 A.B.Open(string) 添加到 Unix 运行时。

#if Unix
    public static void Open(string path, bool securityDescriptor)
    {
        // Call Unix specific stuff.
    }

    public static void Open(string path)
    {
        throw new PlatformNotSupportedException();
    }
#else
    public static void Open(string path)
    {
        // Call Windows specific stuff.
    }

    public static void Open(string path, bool securityDescriptor)
    {
        throw new PlatformNotSupportedException();
    }
#endif

你尝试再次打包该项目,然后就成功了。

MultipleRuntimesSuccessful

严格模式

可以通过在项目文件中设置 EnableStrictModeForCompatibleTfms 属性,为此验证程序启用“严格模式”。 启用严格模式后,将更改一些规则,并在存在差异时执行一些其他规则。 如果希望所比较的双方在领域和标识方面完全相同,这十分有用。 有关详细信息,请参阅严格模式