Správa verzí sady .NET SDK, MSBuild a Sady Visual Studio

Správa verzí sady .NET SDK a jeho vztah k sadě Visual Studio a nástroji MSBuild může být matoucí. Verze MSBuild jsou součástí sady Visual Studio, ale jsou zahrnuty i v .NET SDK. Sada SDK má minimální verzi nástroje MSBuild a Visual Studio, se kterou pracuje, a nenačte se ve verzi sady Visual Studio, která je starší než tato minimální verze.

Vytváření verzí

Číslo verze sady .NET SDK používá formát major.minor.patch, kde:

  • major.minor odpovídá verzi .NET, kterou sada SDK zahrnuje, spouští a cíluje ve výchozím nastavení.
  • Cifry stovek patch určuje pás funkcí, například 1xx, 2xx, 3xx, nebo 4xx. Pásma funkcí začíná na 1 a zvyšuje se pro každou čtvrtletní verzi sady .NET SDK.
  • Poslední dvě číslice patch jsou verze opravy, která se zvýší o servisní aktualizaci každého měsíce.

Například verze 7.0.203 se dodává s rozhraním .NET 7, je druhou čtvrtletní verzí funkční série od vydání verze 7.0.100 a je třetí opravou od vydání verze 7.0.200.

Instalace sady Visual Studio obsahuje jednu odpovídající kopii sady .NET SDK. Pokud aktualizujete instanci sady Visual Studio, aktualizuje se také sada .NET SDK nainstalovaná sadou Visual Studio, včetně pásem funkcí sady .NET SDK a hlavních pásem. Pokud chcete použít jinou sadu .NET SDK než nainstalovanou sadou Visual Studio, můžete ji nainstalovat ze stránky pro stažení .NETa upgrade sady Visual Studio se této verzi nedotkne. Zodpovídáte za aktualizaci této kopie sady .NET SDK od tého dne.

Počínaje verzí Visual Studio 18.0 se Visual Studio bude dodávat v měsíčních menších verzích, zatímco .NET SDK se bude dodávat čtvrtletně. Verze sady Visual Studio mezi čtvrtletními verzemi sady .NET SDK obsahují pouze verze oprav nejnovější sady .NET SDK.

Poznámka:

Sada .NET SDK podporuje cílení na nižší verze .NET, proto doporučujeme vždy aktualizovat sadu .NET SDK spolu s vaší verzí sady Visual Studio.

Životní cyklus

Časový rámec podpory sady SDK obvykle odpovídá verzi sady Visual Studio, do které je součástí.

Rozbalením zobrazíte verze .NET, které nepodporují.
Verze sady SDK Verze nástroje MSBuild/Visual Studio Datum expedice Životní cyklus
2.1.5xx 15,9 lis '18 srpen '21
2.1.8xx 16.2 (bez VS) Červenec '19 srpen '21
3.1.1xx 16.4 Prosinec '19 Říjen '21
3.1.4xx 16.7 srpen 2020 Prosinec '22
5.0.1xx 16.8 Listopad '20 březen '21
5.0.2xx 16.9 Březen '21 Květen '22
5.0.3xx 16,10 Květen '21 srpen '21
5.0.4xx 16.11 srpen '21 Květen '22
6.0.1xx 17.0 Listopad '21 Listopad '24
6.0.2xx 17.1 Únor '22 Květen '22
6.0.3xx 17.23 Květen '22 Říj '23
6.0.4xx 17,3 srp '22 Listopad '24
7.0.1xx 17.4 Listopad '22 květen '24
7.0.2xx 17,53 Únor '23 Květen '23
7.0.3xx 17.6 Květen '23 květen '24
7.0.4xx 17.7 srp '23 květen '24

Podporované verze .NET

Verze sady SDK Verze nástroje MSBuild/Visual Studio Datum expedice Životní cyklus
8.0.1xx 17.8 Listopad '23 Listopad '261
8.0.2xx 17,9 Únor '24 květen '24
8.0.3xx 17.10 květen '24 Jan (ročník '26)
8.0.4xx 17.11 srpen '24 Listopad '262
9.0.1xx 17.12 Listopad '24 Květen '26
9.0.2xx 17.13 Únor '25 Květen '25
9.0.3xx 17.14 Květen '25 Listopad '262
10.0.1xx 18,0 Listopad '25 Listopad '28
10.0.2xx 18.4 Bře '26 Květen '26

Poznámka:

1 pásma funkcí .1xx .NET SDK jsou podporována v průběhu životního cyklu hlavních verzí .NET. Během období rozšířené podpory je podpora omezená na opravy zabezpečení a minimální opravy nesouvisecí se zabezpečením s vysokou prioritou pouze pro Linux. Další informace o důvodech této rozšířené podpory najdete v tématu Podpora zdrojového sestavení.

2 Poslední funkční balíčky sady .NET SDK pro hlavní verzi jsou podporovány po dobu životnosti odpovídajícího modulu runtime jako samostatné instalace.

Životní cyklus sady Visual Studio 2026

Životní cyklus sady Visual Studio 2022

Životní cyklus sady Visual Studio 2019

Cílení a pravidla podpory

Následující zásada určuje, ve kterých verzích nástroje MSBuild a Visual Studio se bude spouštět daná verze sady .NET SDK:

  • Každá nová verze TargetFramework vyžaduje novou verzi sady Visual Studio nebo novou dotnet verzi.
  • První verze sady Visual Studio, která podporuje nový TargetFramework, se stává základem pro verze funkcí této sady SDK, zahrnující API rozhraní Roslyn, cíle MSBuild, zdrojové generátory, analyzátory a podobně.
  • První verze nové sady .NET SDK, která podporuje nový TargetFramework, se dá dál používat s předchozí verzí sady Visual Studio, aby bylo možné migrovat nástroje a infrastrukturu (například akce a kanály).
sada SDK Verze sady Visual Studio
sada SDK je dodávána s
Minimální verze sady Visual Studio Maximální cílový rámec v
minimální verze sady Visual Studio
Maximální TargetFramework v dotnet
8.0.100 17.8 17.7 Net7.0 Net8.0
8.0.200 17,9 17.8 Net8.0 Net8.0
8.0.300 17.10 17.8 Net8.0 Net8.0
8.0.400 17.11 17.8 Net8.0 Net8.0
9.0.100 17.12 17.11 Net8.0 Net9.0
9.0.200 17.13 17.12 Net9.0 Net9.0
9.0.300 17.14 17.12 Net9.0 Net9.0
10.0.100 18,0 17.14 Net9.0 Net10.0
10.0.200 18.4 18,0 Net10.0 Net10.0

Poznámka:

Tabulka znázorňuje způsob použití těchto pravidel správy verzí počínaje sadou .NET SDK 7.0.100 a sadou .NET SDK 6.0.300. Také znázorňuje, jak by se politika vztahovala na dříve distribuované verze sady .NET SDK, kdyby tehdy platila. Požadavky na předchozí verze sady SDK se ale nemění – to znamená, že minimální požadovaná verze sady Visual Studio pro .NET SDK 6.0.100 nebo 6.0.200 zůstává 16.10.

Cílení net8.0 je oficiálně podporováno pouze ve Visual Studio verze 17.8 nebo vyšší.

Cílení net9.0 je oficiálně podporováno pouze ve Visual Studio 17.12 nebo novější.

Cílení net10.0 je oficiálně podporováno pouze v sadě Visual Studio 18.0 nebo vyšší.

Pro zajištění konzistentních nástrojů byste měli použít dotnet build místo msbuild k sestavení vaší aplikace, pokud je to možné.

Matice podpory sady SDK a sady Visual Studio

Většina vývojářů používá sadu .NET SDK, která je součástí jejich verze sady Visual Studio, ale některé konfigurace zahrnují neshodu sad SDK a verzí sady Visual Studio. Neexistuje žádná záruka, že každá verze sady Visual Studio funguje s každou sadou .NET SDK podporující podporu. Nejběžnější konfigurace se testují, aby se zajistilo co nejlepší úsilí o kompatibilitu.

Zpětná a dopředná kompatibilita

  • Primární podporovaná konfigurace: Použití verze sady SDK, která je součástí instalace sady Visual Studio
    • Visual Studio 17.14 a .NET 9.0.3xx
    • Visual Studio 18.0 a .NET 10.0.1xx
  • Zpětná kompatibilita: Použití nejnovějšího pásma funkcí předchozí verze sady SDK (například 8.0.4xx v sadě Visual Studio 17.14) je podporováno s kompatibilitou s nejlepším úsilím. Tým .NET určuje, kdy provést opravy backportu na základě rizika a dopadu na zákazníka. Sady SDK, které jsou starší než nejnovější verze v předchozí řadě, sice můžou fungovat, ale tým .NET je netestuje ani se nesnaží zajistit jejich kompatibilitu.
  • Dopředná kompatibilita: Použití novější sady SDK (například sada .NET 10 SDK v sadě Visual Studio 17.14) je povolená bez blokování, ale cílení na novější moduly runtime ve starších verzích sady Visual Studio není podporované a vytvoří upozornění na sestavení.

Pokyny

Použijte sadu SDK, která byla součástí vaší instance sady Visual Studio (nebo nejnovější dostupná v CI nebo Visual Studio Code), protože tato verze má vždy nejnovější funkce, včetně aktualizací zabezpečení.

Podpora cílení na nižší úroveň

Sada .NET SDK zachovává cílení na verze .NET, které již nejsou podporovány. Sada SDK 10.0.100 může vytvářet aplikace, které cílí net9.0 až do netcoreapp1.0.

Hlavní principy

  • Zachování stávající podpory: Cílení na podporu nepodporovaných verzí zůstává v sadě SDK bez aktivního odebrání. Zákazníci, kteří upgradují svou sadu SDK nebo verzi sady Visual Studio, by neměli mít své buildy poškozené jednoduše tím, že cílí na starší verzi .NET.
  • Nové funkce: Nové funkce sady SDK nejsou nutné k podpoře verzí mimo podporu, pokud vyloučení takové podpory nepředstavuje značné náklady nebo riziko.
  • Opravy poruch: Pokud při cílení na verze bez podpory dojde k problémům, použije se oprava na základě nákladů. Cílem je zabránit tomu, aby zákazníkům během upgradu vznikaly problémy.

Správa verzí Preview

Hlavní verze sady .NET SDK se obvykle vydávají během několika dnů od verze Visual Studio Preview. I když můžou fungovat i jiné kombinace, testuje se a oficiálně podporuje pouze nejnovější vydaná verze Preview. Následující tabulka uvádí, která verze sady Visual Studio byla před vydáním testována pro každou verzi .NET Preview.

Preview verze sady SDK Verze sady Visual Studio
10.0.100 RC 1 18.0.0 Insiders (11010.61)
10.0.100 RC 2 18.0.0 Insiders (11111.16)
11.0.100 Preview 1 18.4.0 Insiders
11.0.100 Preview 2 18.5.0 Insiders

Odkazy