Cílové architektury v projektech ve stylu sady SDK
Když cílíte na architekturu v aplikaci nebo knihovně, zadáváte sadu rozhraní API, která chcete zpřístupnit aplikaci nebo knihovně. Cílovou architekturu v souboru projektu zadáte pomocí monikeru cílového rozhraní (TFM).
Aplikace nebo knihovna může cílit na verzi .NET Standard. Verze .NET Standard představují standardizované sady rozhraní API ve všech implementacích .NET. Knihovna může například cílit na .NET Standard 1.6 a získat přístup k rozhraním API, která fungují v rozhraních .NET Core a .NET Framework pomocí stejného základu kódu.
Aplikace nebo knihovna může také cílit na konkrétní implementaci .NET, aby získala přístup k rozhraním API pro konkrétní implementaci. Například aplikace, která cílí na Xamarin.iOS (napříkladXamarin.iOS10) má přístup k obálkám rozhraní API pro iOS poskytovaným pro IOS 10 nebo aplikaci, která cílí na Univerzální platforma Windows (UPW), má přístup k rozhraním API, uap10.0která kompilují pro zařízení s Windows 10.
V některých cílových architekturách, jako je rozhraní .NET Framework, jsou rozhraní API definována sestaveními, která rozhraní nainstaluje do systému, a mohou zahrnovat rozhraní API architektury aplikací (například ASP.NET).
Pro cílové architektury založené na balíčcích (například .NET 5 nebo .NET Core a .NET Standard) jsou rozhraní API definovaná balíčky NuGet, které jsou součástí aplikace nebo knihovny.
Nejnovější verze
Následující tabulka definuje nejběžnější cílové architektury, způsob jejich odkazování a verzi .NET Standard, kterou implementují. Tyto cílové verze architektury jsou nejnovější stabilní verze. Předběžné verze se nezobrazují. Moniker cílové architektury (TFM) je standardizovaný formát tokenu pro určení cílové architektury aplikace nebo knihovny .NET.
| Cílová architektura | Nejnovější stabilní verze |
Moniker cílové architektury (TFM) | Implementována Verze .NET Standard |
|---|---|---|---|
| .NET 8 | 8 | net8.0 | 2.1 |
| .NET 7 | 7 | net7.0 | 2.1 |
| .NET 6 | 6 | net6.0 | 2.1 |
| .NET 5 | 5 | net5.0 | 2.1 |
| .NET Standard | 2.1 | netstandard2.1 | – |
| .NET Core | 3.1 | netcoreapp3.1 | 2.1 |
| .NET Framework | 4.8.1 | net481 | 2.0 |
Podporované cílové architektury
Na cílovou architekturu obvykle odkazuje TFM. Následující tabulka ukazuje cílové architektury podporované sadou .NET SDK a klientem NuGet. Ekvivalenty se zobrazují v hranatých závorkách. Například win81 je ekvivalentní TFM .netcore451
| Cílová architektura | TFM |
|---|---|
| .NET 5+ (a .NET Core) | netcoreapp1.0 netcoreapp1.1 netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1 net5.0* net6.0* net7.0* net8.0* |
| .NET Standard | netstandard1.0 netstandard1.1 netstandard1.2 netstandard1.3 netstandard1.4 netstandard1.5 netstandard1.6 netstandard2.0 netstandard2.1 |
| .NET Framework | net11 net20 net35 net40 net403 net45 net451 net452 net46 net461 net462 net47 net471 net472 net48 net481 |
| Windows Store | netcore [netcore45] netcore45 [win] [win8] netcore451 [win81] |
| .NET Micro Framework | netmf |
| Silverlight | sl4 sl5 |
| Windows Phone | wp [wp7] wp7 wp75 wp8 wp81 wpa81 |
| Univerzální platforma Windows | uap [uap10.0] uap10.0 [win10] [netcore50] |
* .NET 5 a novější TFM zahrnují některé varianty specifické pro operační systém. Další informace najdete v následující části tfmy specifické pro operační systém .NET 5 nebo novější.
TFM pro konkrétní operační systém .NET 5 nebo novější
Mezi net5.0technologie , net6.0a net7.0net8.0 TFM patří technologie, které fungují na různých platformách. Zadáním sady TFM specifické pro operační systém jsou rozhraní API specifická pro operační systém dostupná pro vaši aplikaci, například vazby model Windows Forms nebo iOS. TFM specifické pro operační systém také dědí každé rozhraní API dostupné pro jejich základní TFM, net6.0 například TFM.
Rozhraní .NET 5 zavedlo net5.0-windows TFM specifické pro operační systém, které zahrnuje vazby specifické pro Windows pro rozhraní API WinForms, WPF a UPW. Verze .NET 6 a novější mají další tfmy specifické pro operační systém, například net6.0-ios.
Následující tabulka ukazuje kompatibilitu tfmů .NET 5 a více.
| TFM | Kompatibilní s |
|---|---|
| net5.0 | net1.. 4 (s upozorněním NU1701) netcoreapp1.. 3.1 (upozornění při odkazování na WinForms nebo WPF) netstandard1.. 2.1 |
| net5.0-windows | netcoreapp1.. 3.1 (plus vše ostatní zděděno z net5.0) |
| net6.0 | (Následná verze net5.0) |
| net6.0-android | xamarin.android (plus vše ostatní zděděno z net6.0) |
| net6.0-ios | xamarin.ios (plus vše ostatní zděděno z net6.0) |
| net6.0-maccatalyst | xamarin.ios (plus vše ostatní zděděno z net6.0) |
| net6.0-macos | xamarin.mac (plus vše ostatní zděděno z net6.0) |
| net6.0-tvos | xamarin.tvos (plus vše ostatní zděděno z net6.0) |
| net6.0-windows | (Následná verze net5.0-windows) |
| net7.0 | (Následná verze net6.0) |
| net7.0-android | (Následná verze net6.0-android) |
| net7.0-ios | (Následná verze net6.0-ios) |
| net7.0-maccatalyst | (Následná verze net6.0-maccatalyst) |
| net7.0-macos | (Následná verze net6.0-macos) |
| net7.0-tizen | tizen40 (plus vše ostatní zděděno z net7.0) |
| net7.0-tvos | (Následná verze net6.0-tvos) |
| net7.0-windows | (Následná verze net6.0-windows) |
| net8.0 | (Následná verze net7.0) |
| net8.0-android | (Následná verze net7.0-android) |
| net8.0-browser | Vše zděděno z net8.0 |
| net8.0-ios | (Následná verze net7.0-ios) |
| net8.0-maccatalyst | (Následná verze net7.0-maccatalyst) |
| net8.0-macos | (Následná verze net7.0-macos) |
| net8.0-tizen | (Následná verze net7.0-tizen) |
| net8.0-tvos | (Následná verze net7.0-tvos) |
| net8.0-windows | (Následná verze net7.0-windows) |
Pokud chcete aplikaci přenášet na různých platformách, ale stále máte přístup k rozhraním API pro konkrétní operační systém, můžete cílit na několik tfmů specifických pro operační systém a přidat ochranu platforem kolem volání rozhraní API specifického pro operační systém pomocí #if direktiv preprocesoru. Seznam dostupných symbolů najdete v tématu Symboly preprocesoru.
Navrhované cíle
Pomocí těchto pokynů určete, který TFM se má ve vaší aplikaci používat:
Aplikace, které jsou přenosné na více platforem, by měly cílit na základní TFM,
net8.0například . To zahrnuje většinu knihoven, ale také ASP.NET Core a Entity Framework.Knihovny specifické pro konkrétní platformu by měly cílit na varianty specifické pro konkrétní platformu. Například projekty WinForms a WPF by měly cílit
net8.0-windows.Multiplatformní aplikační modely (Xamarin Forms, ASP.NET Core) a balíčky mostů (Xamarin Essentials) by měly alespoň cílit na základní TFM,
net8.0ale můžou také cílit na další varianty specifické pro platformu, aby se zlehčily více rozhraní API nebo funkcí.
Verze operačního systému v TFMs
Můžete také zadat volitelnou verzi operačního systému na konci TFM specifického pro operační systém, například net6.0-ios15.0. Verze označuje, která rozhraní API jsou dostupná pro vaši aplikaci nebo knihovnu. Neřídí verzi operačního systému, kterou vaše aplikace nebo knihovna podporuje za běhu. Slouží k výběru referenčních sestavení, která projekt zkompiluje, a k výběru prostředků z balíčků NuGet. Tuto verzi si můžete představit jako "verzi platformy" nebo "verzi rozhraní API operačního systému", aby byla nejednoznačná z verze operačního systému za běhu.
Pokud TFM specifický pro operační systém explicitně nezadává verzi platformy, má implicitní hodnotu, kterou lze odvodit ze základního názvu TFM a platformy. Například výchozí hodnota platformy pro iOS v .NET 6 je 15.0, což znamená, že net6.0-ios je zkratka pro kanonický net6.0-ios15.0 TFM. Implicitní verze platformy pro novější základní TFM může být vyšší, například budoucí net8.0-ios TFM by se mohl mapovat na net8.0-ios16.0. Zkrácený formulář je určen pouze pro použití v souborech projektu a je rozšířen na kanonický formulář podle cílů MSBuild sady .NET SDK před předáním jiným nástrojům, jako je NuGet.
Následující tabulka uvádí výchozí hodnoty cílové platformy (TPV) pro každou verzi .NET.
| Verze .NET | Platforma | Výchozí TPV |
|---|---|---|
| .NET 6 | Android | 31.0 |
| .NET 7 | Android | 33.0 |
| .NET 8 | Android | 34.0 |
| .NET 6 | iOS | 15.0 |
| .NET 7 | iOS | 16.1 |
| .NET 8 | iOS | 17.2 |
| .NET 6 | Mac Catalyst | 15.0 |
| .NET 7 | Mac Catalyst | 16.1 |
| .NET 8 | Mac Catalyst | 17.2 |
| .NET 6 | macOS | 12.0 |
| .NET 7 | macOS | 13.0 |
| .NET 8 | macOS | 14.2 |
| .NET 6 | tvOS | 15.1 |
| .NET 7 | tvOS | 16.1 |
| .NET 8 | tvOS | 17.1 |
| .NET 7 | Tizen | 7.0 |
| .NET 8 | Tizen | 8.0 |
| .NET 6 | Windows | 7.0 |
| .NET 7 | Windows | 7.0 |
| .NET 8 | Windows | 7.0 |
Sada .NET SDK je navržená tak, aby podporovala nově vydaná rozhraní API pro jednotlivé platformy bez nové verze základní sady TFM. To vám umožní přístup k funkcím pro konkrétní platformu bez čekání na hlavní verzi .NET. K těmto nově vydaným rozhraním API můžete získat přístup zvýšením verze platformy v TFM. Pokud například platforma iOS přidala rozhraní API pro iOS 15.1 v aktualizaci sady .NET 6.0.x SDK, můžete k nim přistupovat pomocí TFM net6.0-ios15.1.
Pořadí podle priority
Pokud vaše aplikace odkazuje na balíček, který má více prostředků pro různé TFM, jsou upřednostňované prostředky, které jsou blíže v čísle verze. Pokud například vaše aplikace cílí net6.0-ios a balíček nabízí prostředky a net6.0net5.0-iosprostředky se net6.0 použijí. Další informace najdete v tématu Priority.
Podpora starších verzí operačního systému
I když se aplikace nebo knihovna specifická pro platformu kompiluje na rozhraní API z konkrétní verze tohoto operačního systému, můžete ji nastavit tak, aby byla kompatibilní se staršími verzemi operačního systému přidáním SupportedOSPlatformVersion vlastnosti do souboru projektu. Tato SupportedOSPlatformVersion vlastnost označuje minimální verzi operačního systému potřebnou ke spuštění aplikace nebo knihovny. Pokud v projektu explicitně nezadáte tuto minimální verzi operačního systému za běhu, nastaví se výchozí verze platformy z TFM.
Aby se aplikace správně spustila ve starší verzi operačního systému, nemůže volat rozhraní API, která v této verzi operačního systému neexistují. Můžete ale přidat stráže kolem volání novějších rozhraní API, aby se volala pouze při spuštění na verzi operačního systému, která je podporuje. Tento model umožňuje navrhnout aplikaci nebo knihovnu tak, aby podporovaly spouštění ve starších verzích operačního systému a současně využívaly novější funkce operačního systému při spouštění na novějších verzích operačního systému.
Hodnota SupportedOSPlatformVersion (bez ohledu na to, jestli je explicitní nebo výchozí) používána analyzátorem kompatibility platformy, která detekuje a varuje před nechráněnými voláními novějších rozhraní API. Spálil se do kompilovaného sestavení projektu jako UnsupportedOSPlatformAttribute atribut sestavení, aby analyzátor kompatibility platformy mohl detekovat nechráněná volání rozhraní API sestavení z projektů s nižší SupportedOSPlatformVersion hodnotou. Na některých platformách tato SupportedOSPlatformVersion hodnota ovlivňuje procesy vytváření a balení aplikací pro konkrétní platformu, které jsou popsané v dokumentaci pro tyto platformy.
Zde je příklad výňatek souboru projektu, který používá TargetFramework vlastnosti a SupportedOSPlatformVersion MSBuild k určení, že aplikace nebo knihovna má přístup k rozhraním API pro iOS 15.0, ale podporuje spouštění v iOS 13.0 a vyšší:
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net6.0-ios15.0</TargetFramework>
<SupportedOSPlatformVersion>13.0</SupportedOSPlatformVersion>
</PropertyGroup>
...
</Project>
Určení cílové architektury
Cílové architektury jsou zadané v souboru projektu. Pokud je zadána jedna cílová architektura, použijte TargetFramework element. Následující soubor projektu aplikace konzoly ukazuje, jak cílit na .NET 8:
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>net8.0</TargetFramework>
</PropertyGroup>
</Project>
Když zadáte více cílových architektur, můžete podmíněně odkazovat na sestavení pro každou cílovou architekturu. V kódu můžete podmíněně zkompilovat proti těmto sestavením pomocí symbolů preprocesoru s logikou if-then-else .
Následující projekt knihovny cílí na rozhraní API rozhraní .NET Standard (netstandard1.4) a .NET Framework (net40 a net45). Použijte množný element TargetFrameworks s více cílovými architekturami. Mezi Condition atributy patří balíčky specifické pro implementaci, pokud je knihovna zkompilována pro dva TFM rozhraní .NET Framework:
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFrameworks>netstandard1.4;net40;net45</TargetFrameworks>
</PropertyGroup>
<!-- Conditionally obtain references for the .NET Framework 4.0 target -->
<ItemGroup Condition=" '$(TargetFramework)' == 'net40' ">
<Reference Include="System.Net" />
</ItemGroup>
<!-- Conditionally obtain references for the .NET Framework 4.5 target -->
<ItemGroup Condition=" '$(TargetFramework)' == 'net45' ">
<Reference Include="System.Net.Http" />
<Reference Include="System.Threading.Tasks" />
</ItemGroup>
</Project>
V knihovně nebo aplikaci napíšete podmíněný kód pomocí direktiv preprocesoru ke kompilaci pro každou cílovou architekturu:
public class MyClass
{
static void Main()
{
#if NET40
Console.WriteLine("Target framework: .NET Framework 4.0");
#elif NET45
Console.WriteLine("Target framework: .NET Framework 4.5");
#else
Console.WriteLine("Target framework: .NET Standard 1.4");
#endif
}
}
Symboly preprocesoru
Systém sestavení si je vědom symbolů preprocesoru představujících cílové architektury zobrazené v tabulce podporovaných verzí cílové architektury při použití projektů ve stylu sady SDK. Pokud chcete převést .NET Standard, .NET Core nebo .NET 5+ TFM na symbol preprocesoru, nahraďte tečky a spojovníky podtržítkem a změňte malá písmena na velká písmena (například symbol pro netstandard1.4 znak je NETSTANDARD1_4).
Generování těchto symbolů můžete zakázat prostřednictvím DisableImplicitFrameworkDefines vlastnosti. Další informace o této vlastnosti naleznete v tématu DisableImplicitFrameworkDefines.
Úplný seznam symbolů preprocesoru pro cílové architektury .NET je:
| Cílové architektury | Symboly | Další symboly (k dispozici v sadách .NET 5+ SDK) |
Symboly platformy (k dispozici pouze při zadání TFM specifického pro operační systém) |
|---|---|---|---|
| .NET Framework | NETFRAMEWORK, NET48, , NET472, NET47NET462, NET40NET35NET471NET461NET46NET452NET451NET45NET20 |
NET48_OR_GREATER, NET472_OR_GREATER, , NET471_OR_GREATER, NET462_OR_GREATERNET47_OR_GREATER, NET461_OR_GREATERNET40_OR_GREATERNET452_OR_GREATERNET46_OR_GREATERNET451_OR_GREATERNET45_OR_GREATER, NET35_OR_GREATERNET20_OR_GREATER |
|
| .NET Standard | NETSTANDARD, NETSTANDARD2_1, , NETSTANDARD2_0, NETSTANDARD1_5NETSTANDARD1_6, NETSTANDARD1_4NETSTANDARD1_3NETSTANDARD1_2, , NETSTANDARD1_1NETSTANDARD1_0 |
NETSTANDARD2_1_OR_GREATER, NETSTANDARD2_0_OR_GREATER, , NETSTANDARD1_5_OR_GREATERNETSTANDARD1_3_OR_GREATERNETSTANDARD1_2_OR_GREATERNETSTANDARD1_6_OR_GREATERNETSTANDARD1_4_OR_GREATER, , NETSTANDARD1_1_OR_GREATERNETSTANDARD1_0_OR_GREATER |
|
| .NET 5+ (a .NET Core) | NET, NET8_0, , NET7_0, NET5_0NET6_0, NETCOREAPPNETCOREAPP2_0NETCOREAPP3_0NETCOREAPP3_1NETCOREAPP2_2NETCOREAPP2_1, NETCOREAPP1_1NETCOREAPP1_0 |
NET8_0_OR_GREATER, NET7_0_OR_GREATER, , NET6_0_OR_GREATER, NETCOREAPP3_1_OR_GREATERNETCOREAPP2_0_OR_GREATERNET5_0_OR_GREATERNETCOREAPP3_0_OR_GREATERNETCOREAPP2_2_OR_GREATERNETCOREAPP2_1_OR_GREATER, NETCOREAPP1_1_OR_GREATERNETCOREAPP1_0_OR_GREATER |
ANDROID, BROWSER, IOS, , MACOSMACCATALYST, TVOS, , WINDOWS[OS][version] (například IOS15_1),[OS][version]_OR_GREATER (například IOS15_1_OR_GREATER) |
Poznámka:
- Symboly bez verzí se definují bez ohledu na verzi, na kterou cílíte.
- Symboly specifické pro verzi jsou definované jenom pro verzi, na kterou cílíte.
- Symboly
<framework>_OR_GREATERjsou definované pro verzi, na kterou cílíte, a všechny předchozí verze. Pokud například cílíte na rozhraní .NET Framework 2.0, jsou definovány následující symboly:NET20,NET20_OR_GREATER,NET11_OR_GREATERaNET10_OR_GREATER. - Symboly
NETSTANDARD<x>_<y>_OR_GREATERjsou definovány pouze pro cíle .NET Standard, a ne pro cíle, které implementují .NET Standard, jako jsou .NET Core a .NET Framework. - Liší se od monikers cílové architektury (TFMs) používané vlastností MSBuild
TargetFrameworka NuGet.
Zastaralé cílové architektury
Následující cílové architektury jsou zastaralé. Balíčky, které cílí na tyto cílové architektury, by se měly migrovat na uvedené nahrazení.
| Zastaralé TFM | Náhrada |
|---|---|
| aspnet50 aspnetcore50 dnxcore50 Dnx dnx45 dnx451 dnx452 |
netcoreapp |
| dotnet dotnet50 dotnet51 dotnet52 dotnet53 dotnet54 dotnet55 dotnet56 |
netstandard |
| netcore50 | uap10.0 |
| Vyhrát | netcore45 |
| win8 | netcore45 |
| win81 | netcore451 |
| win10 | uap10.0 |
| winrt | netcore45 |
Viz také
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro