共用方式為


驗證相容架構

包含相容架構的封裝必須確保,針對其中一個架構編譯的程式碼可以針對另一個架構執行。 相容架構配對的範例如下:

  • .NET Standard 2.0 和 .NET 7
  • .NET 6 和 .NET 7

在這兩種情況下,取用者可以針對 .NET Standard 2.0 或 .NET 6 進行建置,並在 .NET 7 上執行。 如果您的二進位檔在這些架構之間不相容,取用者最終可能會發生編譯時間或執行階段錯誤。

封裝驗證會在封裝時攔截這些錯誤。 以下是範例案例:

假設您正在撰寫操作字串的遊戲。 您必須同時支援 .NET Framework 和 .NET (.NET Core) 取用者。 最初,您的專案是以 .NET Standard 2.0 為目標,但現在您想要利用 .NET 6 中的 Span<T> 優勢,來避免不必要的字串配置。 為了這麼做,您想要針對 .NET Standard 2.0 和 .NET 6 採用多目標方式。

您已撰寫下列程式碼:

#if NET6_0_OR_GREATER
    public void DoStringManipulation(ReadOnlySpan<char> input)
    {
        // use spans to do string operations.
    }
#else
    public void DoStringManipulation(string input)
    {
        // Do some string operations.
    }
#endif

然後,您嘗試封裝專案 (使用 dotnet pack 或 Visual Studio),但發生失敗並出現下列錯誤:

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
  You are using a preview version of .NET. See: https://aka.ms/dotnet-core-preview
  PackageValidationThrough -> D:\demo\bin\Debug\netstandard2.0\PackageValidationThrough.dll
  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.DoStringManipulation(string)' exists on lib/netstandard2.0/PackageValidationThrough.dll but not on lib/net6.0/PackageValidationThrough.dll [D:\demo\PackageValidationThrough.csproj]

CompatibleFrameworks

您發現,您應該為 .NET 6 提供額外的 DoStringManipulation(ReadOnlySpan<char>) 方法,而不是排除 .NET 6 的 DoStringManipulation(string)

#if NET6_0_OR_GREATER
    public void DoStringManipulation(ReadOnlySpan<char> input)
    {
        // use spans to do string operations.
    }
#endif
    public void DoStringManipulation(string input)
    {
        // Do some string operations.
    }

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

CompatibleFrameworksSuccessful

Strict 模式

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