根據不同的執行階段來驗證套件

您可以選擇在 NuGet 套件中針對不同的執行階段擁有不同的實作組件。 在該情況下，您必須確定這些組件彼此相容，而且也與編譯時間組件相容。

例如，考量下列案例。 您正在個別處理涉及一些對 Unix 和 Windows API 的 interop 呼叫的程式庫。 您已撰寫下列程式碼：

#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 始終會在編譯時使用。 lib\net6.0\A.dll 也將在執行階段用於非 Unix 系統。 不過，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]

您知道自己的錯誤，並將 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

您嘗試再次封裝該專案，並且成功。

Strict 模式

您可以在專案檔中設定 EnableStrictModeForCompatibleTfms 屬性來針對此驗證程式啟用嚴格模式。 啟用嚴格模式會改變一些規則，並在發現不同時執行一些其他規則。 當您希望比較的兩邊在表面部分和識別上完全相同時，這非常有用。 如需詳細資訊，請參閱嚴格模式。