Platformy docelowe

NuGet używa odwołań do platform docelowych w różnych miejscach, aby w szczególności identyfikować i izolować składniki zależne od struktury pakietu:

• plik projektu: w przypadku projektów w stylu zestawu SDK plik csproj zawiera odwołania do platformy docelowej.
• Manifest .nuspec: pakiet może wskazywać różne pakiety, które mają być uwzględnione w projekcie w zależności od struktury docelowej projektu.
• Nazwa folderu .nupkg: foldery w folderze pakietu lib mogą być nazwane zgodnie z platformą docelową, z których każda zawiera biblioteki DLL i inną zawartość odpowiednią dla tej struktury.
• packages.config: targetframework atrybut zależności określa wariant pakietu do zainstalowania.

Aby uzyskać listę kanoniczną wszystkich obsługiwanych platform docelowych i ich składni programu TFM, zobacz Platformy docelowe w projektach w stylu zestawu SDK.

Wartości targetFramework to aliasy

Właściwość TargetFramework w pliku projektu to przyjazna nazwa — alias — który jest tłumaczony na tożsamość platformy kanonicznej. Zestaw .NET SDK wykonuje to tłumaczenie, ustawiając TargetFrameworkMoniker (TFM) i, jeśli ma to zastosowanie, TargetPlatformMoniker właściwości.

Na przykład podczas pisania zestaw <TargetFramework>net10.0-windows</TargetFramework>SDK platformy .NET tłumaczy to na:

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

Narzędzie NuGet używa tych właściwości moniker — a nie TargetFramework ciągu — do sprawdzania zgodności pakietu. Oznacza to, że TargetFramework sama wartość może być dowolnym ciągiem, o ile właściwości moniker są ustawione poprawnie. Na przykład następujący projekt jest prawidłowy:

<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>

Ten projekt przywraca i kompiluje dla platformy .NET 10.0, mimo że TargetFramework wartość to banana. Zestaw SDK platformy .NET korzysta już z tego mechanizmu aliasowania dla systemów operacyjnych, takich jak net8.0-ios i net8.0-android, gdzie krótki program TFM jest tłumaczony na pełną nazwę z informacjami o platformie.

Wielowersyjność z zduplikowanymi strukturami

Począwszy od nuGet 7.6 / .NET SDK 10.0.300, wiele TargetFrameworks aliasów może rozpoznać tę samą efektywną strukturę. Umożliwia to korzystanie ze scenariuszy, takich jak kompilacje z wieloma identyfikatorami RID i określanie docelowych rozszerzeń z wieloma wersjami. Aby uzyskać szczegółowe informacje na temat sposobu pracy z przywracaniem, pakowaniem, blokowaniem plików i odwołaniami do projektu, zobacz Określanie kierowania wielu struktur.

Obsługiwane platformy

Struktura jest zwykle przywoływała krótka nazwa platformy docelowej lub TFM. W programie .NET Standard jest to również uogólnione do TxM , aby umożliwić pojedyncze odwołanie do wielu platform.

Klienci NuGet obsługują struktury w poniższej tabeli. Odpowiedniki są wyświetlane w nawiasach []. Należy pamiętać, że niektóre narzędzia, takie jak dotnet, mogą używać odmian kanonicznych programu TFM w niektórych plikach. Na przykład dotnet pack używa elementu .NETCoreApp2.0 w .nuspec pliku, a nie netcoreapp2.0. Różne narzędzia klienckie NuGet obsługują te odmiany prawidłowo, ale zawsze należy używać kanonicznych programów TFM podczas bezpośredniej edycji plików.

Przestarzałe struktury

Następujące struktury są przestarzałe. Pakiety przeznaczone dla tych struktur powinny zostać zmigrowane do wskazanych zastąpień.

Precedence

Wiele struktur jest powiązanych i zgodnych ze sobą, ale niekoniecznie równoważnych:

NET Standard

Platforma .NET Standard upraszcza odwołania między strukturami zgodnymi z binarnymi, umożliwiając pojedynczej strukturze docelowej odwołanie do kombinacji innych. (Aby uzyskać informacje w tle, zobacz .NET Primer).

Narzędzie NuGet Get Nearest Framework Tool symuluje użycie narzędzia NuGet w celu wybrania jednej struktury z wielu dostępnych zasobów platformy w pakiecie na podstawie struktury projektu.

Seria dotnet monikers powinna być używana w nuGet 3.3 i starszych wersjach. Składnia netstandard moniker powinna być używana w wersji 3.4 lub nowszej.

Przenośne biblioteki klas

Aby zdefiniować platformę docelową odwołującą się do wielu struktur podrzędnych docelowych, portable słowo kluczowe służy do prefiksu listy odwołań struktur. Unikaj sztucznego dołączania dodatkowych struktur, które nie są bezpośrednio kompilowane, ponieważ może to prowadzić do niezamierzonych skutków ubocznych w tych strukturach.

Dodatkowe struktury zdefiniowane przez inne firmy zapewniają zgodność z innymi środowiskami, które są w ten sposób dostępne. Ponadto istnieją skrócone numery profilów, które są dostępne do odwoływania się do tych kombinacji powiązanych struktur jako Profile#, ale nie jest to zalecana praktyka używania tych liczb, ponieważ zmniejsza czytelność folderów i .nuspec.

Ponadto pakiety NuGet przeznaczone dla platformy Xamarin mogą używać dodatkowych struktur zdefiniowanych przez platformę Xamarin: