驗證相容架構
包含相容架構的封裝必須確保,針對其中一個架構編譯的程式碼可以針對另一個架構執行。 相容架構配對的範例如下:
- .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]
您發現,您應該為 .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.
}
您嘗試再次封裝該專案,並且成功。
Strict 模式
您可以在專案檔中設定 EnableStrictModeForCompatibleFrameworksInPackage
屬性來針對此驗證程式啟用嚴格模式。 啟用嚴格模式會改變一些規則,並在發現不同時執行一些其他規則。 當您希望比較的兩邊在表面部分和識別上完全相同時,這非常有用。 如需詳細資訊,請參閱嚴格模式。