Бөлісу құралы:

Анализ зависимостей для переноса кода из .NET Framework в .NET

Чтобы определить неподдерживаемые сторонние зависимости в проекте, необходимо сначала разобраться с зависимостями. Внешние зависимости - это пакеты NuGet или файлы .dll, на которые вы ссылаетесь в своем проекте, но не собираете сами.

Перенос кода в .NET Standard 2.0 или более ранней версии гарантирует, что его можно будет использовать как с .NET Framework, так и с .NET. Но если вам не нужно использовать библиотеку с .NET Framework, рекомендуется ориентироваться на последнюю версию .NET.

Перенос пакетов NuGet в PackageReference

.NET не может использовать файл packages.config для ссылок NuGet. Как .NET, так и .NET Framework могут использовать PackageReference для указания зависимостей пакета. Если вы используете файл packages.config для указания пакетов в проекте, преобразуйте его в формат PackageReference.

Сведения о том, как выполнить миграцию, см. в статье Преобразование packages.config в PackageReference.

Обновление пакетов NuGet

После переноса проекта в формат PackageReference проверьте, совместимы ли пакеты с .NET.

Сначала обновите свои пакеты до последней доступной версии. Это можно сделать с помощью пользовательского интерфейса диспетчера пакетов NuGet в Visual Studio. Скорее всего, новые версии зависимостей пакета уже совместимы с .NET Core.

Анализ зависимостей пакета

Если вы еще не проверили, что преобразованные и обновленные зависимости пакетов работают в .NET Core, это можно сделать двумя способами:

Используйте nuget.org

Вы можете просмотреть идентификаторы целевой платформы (TFM), которые поддерживаются каждым пакетом, на сайте nuget.org в разделе Зависимости на странице пакета.

С помощью этого сайта легко проверить совместимость, однако информация о зависимостях доступна не для всех пакетов.

Использование обозревателя пакетов NuGet

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

Проще всего просматривать папки пакета NuGet с помощью инструмента Обозреватель пакетов NuGet. После установки выполните следующие действия, чтобы увидеть имена папок:

  1. Откройте обозреватель пакетов NuGet.
  2. Щелкните Открыть пакет из онлайн-канала.
  3. Выполните поиск по имени пакета.
  4. Выберите имя пакета в результатах поиска и нажмите кнопку Открыть.
  5. Разверните папку lib в правой части окна и просмотрите имена папок.

Найдите папку с именами, используя один из следующих шаблонов: netstandardX.Y, netX.Y или netcoreappX.Y.

Эти значения — моникеры целевых платформ (TFM), соответствующие версиям .NET Standard, .NET и .NET Core, которые совместимы с .NET.

Внимание

Рассматривая TFM'ы, которые поддерживает пакет, обратите внимание, что TFM'ы, отличающиеся от netstandard*, нацелены на определённую реализацию .NET, например .NET 5, .NET Core или .NET Framework. Начиная с .NET 5, net* (без указания операционной системы) фактически заменяет netstandard* как переносимая цель. Например, net5.0 ориентируется на область API .NET 5 и поддерживает разные платформы, но net5.0-windows ориентируется на область API .NET 5, реализованную в операционной системе Windows.

Режим совместимости .NET Framework

После анализа пакетов NuGet можно обнаружить, что они предназначены только для платформа .NET Framework.

Начиная с .NET Standard 2.0, доступен режим совместимости .NET Framework. Этот режим совместимости позволяет проектам .NET Standard и .NET Core ссылаться на библиотеки .NET Framework. Хотя создание ссылок на библиотеки .NET Framework не работает для всех проектов, например, если библиотека использует API Windows Presentation Foundation (WPF), это позволяет разблокировать множество сценариев переноса.

Ссылаясь в своем проекте на пакеты NuGet, ориентирующиеся на .NET Framework, например Huitian.PowerCollections, вы получаете предупреждение об откате пакета (NU1701), как в следующем примере:

NU1701: Package ‘Huitian.PowerCollections 1.0.0’ was restored using ‘.NETFramework,Version=v4.6.1’ instead of the project target framework ‘.NETStandard,Version=v2.0’. This package may not be fully compatible with your project.

Это предупреждение отображается при добавлении пакета и каждый раз при выполнении сборки, чтобы вы обязательно протестировали этот пакет в своем проекте. Если проект работает надлежащим образом, можно отключить это предупреждение, изменив свойства пакета в Visual Studio или путем редактирования файла проекта в привычном редакторе кода вручную.

Чтобы отключить это предупреждение путем редактирования файла проекта, найдите запись PackageReference для пакета, предупреждение для которого требуется отключить, и добавьте атрибут NoWarn. Атрибут NoWarn принимает разделенный запятыми список всех идентификаторов предупреждений. В следующем примере показано отключение предупреждения NU1701 для пакета Huitian.PowerCollections путем редактирования файла проекта вручную:

<ItemGroup>
  <PackageReference Include="Huitian.PowerCollections" Version="1.0.0" NoWarn="NU1701" />
</ItemGroup>

Дополнительные сведения о том, как отключить предупреждения компилятора в Visual Studio, см. в разделе Подавление предупреждений для пакетов NuGet.

Если пакеты NuGet не запускаются в .NET

Если пакет NuGet, от которого зависит ваш проект, не работает в .NET Core, можно предпринять ряд мер:

  • Если проект имеет открытый исходный код и размещается на каком либо ресурсе, наподобие GitHub, вы можете обратиться к разработчикам напрямую.
  • Вы можете связаться с автором непосредственно на nuget.org. Найдите пакет и щелкните Связаться с владельцами в левой части страницы пакета.
  • Можно найти другой пакет, который работает на платформе .NET Core и выполняет те же функции, что и используемый вами пакет.
  • Вы можете попытаться самостоятельно написать код, выполняющий то, что делал пакет.
  • Вы можете устранить зависимость от пакета, изменив функциональность приложения, по крайней мере до тех пор пока не станет доступна совместимая версия пакета.

Помните, что обслуживанием проектов с открытым исходным кодом и выпуском пакетов NuGet часто занимаются волонтеры. Они делают эту работу, потому что им важна соответствующая область деятельности, причем безвозмездно, часто в свободное от основной занятости время. Помните об этом, обращаясь к ним за поддержкой .NET Core.

Если ни один из этих способов не помог решить проблему, возможно, придется отложить перенос кода в .NET Core на более позднюю дату.

Команда разработчиков .NET хотела бы узнать, поддержку каких библиотек в .NET Core следует реализовать в первую очередь. Сообщить о нужных вам библиотеках можно в электронном сообщении по адресу dotnet@microsoft.com.

Анализ зависимостей, не относящихся к NuGet

Возможно, у вас есть зависимость, которая не является пакетом NuGet, например библиотекой DLL в файловой системе. Вы можете определить переносимость этой зависимости с помощью агента модернизации GitHub Copilot.

Следующие шаги

  • Last updated on