Поделиться через

Проверка совместимых платформ

  • Статья

Пакеты, содержащие совместимые платформы, должны гарантировать, что код, скомпилированный для одной платформы, может выполняться на другой. Примеры совместимых пар платформ:

  • .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, но теперь вы хотите использовать преимущества Span<T> в .NET 6, чтобы избежать ненужных выделений строк. Для этого необходимо использовать несколько целевых версий для .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

Вы понимаете, что вместо того, чтобы исключить DoStringManipulation(string) для .NET 6, следует просто предоставить дополнительный метод DoStringManipulation(ReadOnlySpan<char>) для .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.
    }

Вы снова пытаетесь упаковать проект, на этот раз успешно.

CompatibleFrameworksSuccessful

Строгий режим

Вы можете включить строгий режим для этого проверяющего элемента, задав EnableStrictModeForCompatibleFrameworksInPackage свойство в файле проекта. При включении строгого режима будут изменены некоторые правила, а другие правила будут выполняться при получении различий. Это полезно, если нужно, чтобы обе стороны сравнения были строго одинаковыми по контактной зоне и идентификатору. Дополнительные сведения см. в разделе "Строгий режим".