Целевые платформы

NuGet использует ссылки на целевую платформу в различных местах для определения и изоляции компонентов, зависимых от платформы пакета:

• файл проекта: для проектов в стиле SDK CSPROJ содержит ссылки на целевую платформу.
• Манифест nuspec: пакет может указывать на отдельные пакеты, которые должны быть включены в проект в зависимости от целевой платформы проекта.
• Имя папки .nupkg: папки внутри папки пакета lib можно назвать в соответствии с целевой платформой, каждой из которых содержатся библиотеки DLL и другое содержимое, соответствующее этой платформе.
• packages.config: targetframework атрибут зависимости указывает вариант устанавливаемого пакета.

Список канонических всех поддерживаемых целевых платформ и их синтаксиса TFM см. в разделе "Целевые платформы" в проектах в стиле SDK.

Значения TargetFramework — это псевдонимы

Свойство TargetFramework в файле проекта — это понятное имя — псевдоним, который преобразуется в каноническое удостоверение платформы. Пакет SDK для .NET выполняет этот перевод, задав TargetFrameworkMoniker (TFM) и при необходимости TargetPlatformMoniker свойства.

Например, при написании <TargetFramework>net10.0-windows</TargetFramework>пакет SDK для .NET преобразует это в:

• TargetFrameworkMoniker = .NETCoreApp,Version=v10.0
• TargetPlatformMoniker = Windows,Version=7.0

NuGet использует эти свойства моникера , а не TargetFramework строку для проверок совместимости пакетов. Это означает, что TargetFramework само значение может быть любой строкой, если свойства моникера заданы правильно. Например, следующий проект действителен:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>banana</TargetFramework>
  </PropertyGroup>

  <PropertyGroup Condition=" '$(TargetFramework)' == 'banana' ">
    <TargetFrameworkIdentifier>.NETCoreApp</TargetFrameworkIdentifier>
    <TargetFrameworkVersion>v10.0</TargetFrameworkVersion>
    <TargetFrameworkMoniker>.NETCoreApp,Version=v10.0</TargetFrameworkMoniker>
  </PropertyGroup>
</Project>

Этот проект восстанавливает и создает сборки для .NET 10.0, даже если TargetFramework значение равно banana. Пакет SDK для .NET уже использует этот механизм псевдонима для TFM для конкретной ОС, например net8.0-ios , где net8.0-androidкороткий TFM преобразуется в полный моникер с информацией о платформе.

Многоцелевой выбор с повторяющимися платформами

Начиная с NuGet 7.6 / .NET SDK 10.0.300, несколько TargetFrameworks псевдонимов могут разрешаться в одной эффективной платформе. Это позволяет сценариям, таким как сборки с несколькими версиями и целевые расширения с несколькими версиями. Дополнительные сведения о том, как это работает с восстановлением, пакетом, блокировкой файлов и ссылками на проекты, см. в статье "Назначение нескольких платформ".

Поддерживаемые платформы

Платформа обычно ссылается на короткий моникер целевой платформы или TFM. В .NET Standard это также обобщено в TxM , чтобы разрешить одну ссылку на несколько платформ.

Клиенты NuGet поддерживают платформы в таблице ниже. Эквиваленты отображаются в скобках []. Обратите внимание, что некоторые средства, например dotnet, могут использовать варианты канонических TFM в некоторых файлах. Например, dotnet pack используется .NETCoreApp2.0 в .nuspec файле, а не netcoreapp2.0. Различные клиентские средства NuGet правильно обрабатывают эти варианты, но при редактировании файлов всегда следует использовать канонические TFMs.

Устаревшие платформы

Следующие платформы устарели. Пакеты, предназначенные для этих платформ, должны перейти на указанные замены.

Приоритет

Ряд платформ связаны друг с другом и совместимы друг с другом, но не обязательно эквивалентны:

.NET Standard

.NET Standard упрощает ссылки между двоичными платформами, что позволяет одной целевой платформе ссылаться на сочетание других платформ. (В фоновом режиме см. приложение .NET Primer.)

Средство NuGet Get Ближайшей платформы имитирует то, что NuGet использует для выбора одной платформы из многих доступных ресурсов платформы в пакете на основе платформы проекта.

Ряд dotnet моникеров следует использовать в NuGet 3.3 и более ранних версиях. netstandard Синтаксис моникера должен использоваться в версии 3.4 и более поздних версиях.

Переносимые библиотеки классов

Чтобы определить целевую платформу, которая ссылается на несколько дочерних целевых платформ, portable ключевое слово, используемое для префикса списка ссылочных платформ. Избегайте искусственного включения дополнительных платформ, которые не компилируются напрямую против, так как это может привести к непреднамеренных побочных эффектов в этих платформах.

Дополнительные платформы, определенные третьими сторонами, обеспечивают совместимость с другими средами, доступными таким образом. Кроме того, существуют короткие номера профилей, доступные для ссылки на эти сочетания связанных платформ, как Profile#, но это не рекомендуется использовать эти числа, так как это снижает удобочитаемость папок и .nuspec.

Кроме того, пакеты NuGet, предназначенные для Xamarin, могут использовать дополнительные платформы, определенные Xamarin: