Ověření kompatibilních architektur

Balíčky obsahující kompatibilní architektury musí zajistit, aby kód zkompilovaný proti jednomu mohl běžet proti jinému. Mezi příklady kompatibilních párů rozhraní patří:

• .NET Standard 2.0 a .NET 7
• .NET 6 a .NET 7

V obou těchto případech můžou spotřebitelé sestavovat pro .NET Standard 2.0 nebo .NET 6 a spouštět v .NET 7. Pokud vaše binární soubory nejsou mezi těmito architekturami kompatibilní, můžou uživatelé skončit s chybami doby kompilace nebo doby běhu.

Ověření balíčku tyto chyby zachytává v době balení. Tady je ukázkový scénář:

Předpokládejme, že píšete hru, která manipuluje s řetězci. Potřebujete podporovat uživatele rozhraní .NET Framework i .NET (.NET Core). Projekt původně cílil na .NET Standard 2.0, ale teď chcete využít výhod Span<T> v .NET 6, abyste se vyhnuli zbytečným přidělením řetězců. Chcete-li to provést, chcete více cílů pro .NET Standard 2.0 a .NET 6.

Napsali jste následující kód:

#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

Pak se pokusíte projekt zabalit (pomocí sady dotnet pack Visual Studio) a selže s následující chybou:

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]

Uvědomujete si, že místo vyloučení DoStringManipulation(string) pro .NET 6 byste měli pouze poskytnout další DoStringManipulation(ReadOnlySpan<char>) metodu pro .NET 6:

#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.
    }

Zkusíte projekt znovu zabalit a bude úspěšný.

Striktní režim

Pro tento validátor můžete povolit striktní režim nastavením EnableStrictModeForCompatibleFrameworksInPackage vlastnosti v souboru projektu. Povolení striktního režimu změní některá pravidla a provede některá další pravidla při získávání rozdílů. To je užitečné, když chcete, aby obě strany byly přesně stejné na jejich povrchu a identitě. Další informace naleznete v tématu Striktní režim.