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 NÁSTROJE MSBuild se sadou Visual Studio, ale jsou také součástí sady .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í

První část verze sady .NET SDK odpovídá verzi .NET, která zahrnuje, běží na ní a cíle ve výchozím nastavení. Pásma funkcí začíná na 1 a zvyšuje se pro každou čtvrtletní podverzi sady Visual Studio. Verze opravy se zvýší o aktualizace údržby jednotlivých měsíců.

Například verze 7.0.203 je druhá podverze sady Visual Studio od vydání verze 7.0.100 a je třetí opravou od vydání verze 7.0.200.

Životní cyklus

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

Verze sady SDK Verze nástroje MSBuild/Visual Studio Datum expedice Životní cyklus
2.1.5xx 15.9 XI/18 Aug (ročník '21)
2.1.8xx 16.2 (bez VS) Červenec (ročník '19) Aug (ročník '21)
3.1.1xx 16.4 Prosinec (ročník '19) Října (ročník '21)
3.1.4xx 16.7 20. Prosinec (ročník '22)
5.0.1xx 16.8 Listopad '20 Mar (ročník '21)
5.0.2xx 16.9 Březen (ročník '21) Květen '22
5.0.3xx 16,10 Květen (ročník '21) Aug (ročník '21)
5.0.4xx 16.11 Aug (ročník '21) Květen '22
6.0.1xx 17.0 Listopad '21 Listopad '241
6.0.2xx 17.1 Únor (ročník '22) Květen '22
6.0.3xx 17.23 Květen '22 Října '23)
6.0.4xx 17.3 22. Listopad '242
7.0.1xx 17.4 Listopad '22 Květen '241
7.0.2xx 17,53 Únor (ročník '23) Květen (ročník '23)
7.0.3xx 17.6 Květen (ročník '23) Květen (ročník '24)
7.0.4xx 17.7 23. Květen '242
8.0.1xx 17.8 Listopad '23 TBD
8.0.2xx 17,93 Únor (ročník '24) TBD
8.0.3xx 17.10 Květen (ročník '24) TBD

Poznámka:

Cílení net6.0 se oficiálně podporuje jenom v sadě Visual Studio 17.0 nebo novější. Cílení net7.0 se oficiálně podporuje jenom v sadě Visual Studio 17.4 nebo novější. Cílení net8.0 se oficiálně podporuje jenom v sadě Visual Studio 17.8 nebo novější.

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 pásma funkcí sady .4xx .NET SDK jsou podporována po dobu životnosti odpovídajícího modulu runtime jako samostatné instalace.

3 6.0.300, 7.0.200 a 8.0.200 vyžadují novější verze sady Visual Studio. Další informace najdete v pravidlech podpory.

Životní cyklus sady Visual Studio 2019

Životní cyklus sady Visual Studio 2022

Cílení a pravidla podpory

Počínaje sadou .NET SDK 7.0.100 a .NET SDK 6.0.300 byly zavedeny zásady týkající se toho, ve kterých verzích NÁSTROJE MSBuild a Visual Studio se daná verze sady .NET SDK bude spouštět. Zásada je:

  • 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 stane podlahou pro pásy funkcí této sady SDK pro povrch rozhraní Roslyn API, cíle NÁSTROJE MSBuild, zdrojové generátory, analyzátory atd.
  • 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 Max TargetFramework in
minimální verze sady Visual Studio
Max TargetFramework in dotnet
6.0.100 17.0 16.11 Net5.0 Net6.0
6.0.200 17.1 17.0 Net6.0 Net6.0
6.0.300 17.2 17.0 Net6.0 Net6.0
6.0.400 17.3 17.0 Net6.0 Net6.0
7.0.100 17.4 17.3 Net6.0 Net7.0
7.0.200 17.5 17.4 Net7.0 Net7.0
7.0.300 17.6 17.41 Net7.0 Net7.0
7.0.400 17.7 17.4 Net7.0 Net7.0
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

Poznámka:

Tabulka znázorňuje, jak se tato pravidla správy verzí použijí v budoucnu, počínaje sadou .NET SDK 7.0.100 a sadou .NET SDK 6.0.300. Také znázorňuje, jak by se zásada použila na dříve dodávané verze sady .NET SDK, pokud byla poté splněna. 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.

1 Zásadní změna ve verzi 7.0.300 pro vývoj pro Blazor a Razor vyžaduje Visual Studio verze 17.6 nebo novější. Další informace najdete v tématu dotnet/razor issue 8718.

Pokud chcete zajistit konzistentní nástroje, měli byste místo sestavení aplikace použít dotnet buildmsbuild , pokud je to možné.

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.

Verze Preview sady SDK Verze sady Visual Studio
9.0.100 Preview 1 17.10 Preview 1
9.0.100 Preview 2 17.10 Preview 2
9.0.100 Preview 3 17.10 Preview 3

Reference