Freigeben über


.NET SDK-, MSBuild- und Visual Studio-Versionsverwaltung

Die Versionsverwaltung des .NET SDK und seine Beziehung zu Visual Studio und MSBuild kann schwer verständlich sein. MSBuild wird mit Visual Studio versioniert, ist aber auch im -NET SDK enthalten. Das SDK verfügt über eine Mindestversion von MSBuild und Visual Studio, mit der es funktioniert, und es wird nicht in einer Version von Visual Studio geladen, die älter als diese Mindestversion ist.

Versionskontrolle

Der erste Teil der .NET SDK-Version entspricht der .NET-Version, die es enthält, in der es ausgeführt wird und für die es standardmäßig vorgesehen ist. Die Featuregruppe beginnt bei 1 und wird für jede vierteljährliche Visual Studio-Nebenversion heraufgesetzt. Die Patchversion wird mit den Wartungsupdates jedes Monats heraufgesetzt.

Beispiel: Version 7.0.203 wird mit .NET 7 veröffentlicht, ist die zweite Visual Studio-Nebenversion, wurde seit 7.0.100 zum ersten Mal veröffentlicht und ist der dritte Patch seit der Veröffentlichung von 7.0.200.

Lebenszyklus

Der Supportzeitrahmen für das SDK entspricht in der Regel der Visual Studio-Version, in dem es enthalten ist.

Erweitern, um nicht mehr unterstützte .NET-Versionen anzuzeigen
SDK-Version MSBuild-/Visual Studio-Version Auslieferungsdatum Lebenszyklus
2.1.5xx 15,9 Nov. 18 Aug. 21
2.1.8xx 16.2 (kein VS) Juli 19 Aug. 21
3.1.1xx 16.4 Dez. 19 Okt. 21
3.1.4xx 16.7 Aug. 20 Dez. 22
5.0.1xx 16.8 Nov. 2020 Mär. 21
5.0.2xx 16,9 März. 21 Mai 2022
5.0.3xx 16.10 Mai 21 Aug. 21
5.0.4xx 16.11 Aug. 21 Mai 2022
7.0.1xx 17.4 Nov. 2022 Mai 2024
7.0.2xx 17.53 Feb. 2023 Mai 2023
7.0.3xx 17.6 Mai 2023 Mai 2024
7.0.4xx 17,7 Aug. 2023 Mai 2024

Unterstützte .NET-Versionen

SDK-Version MSBuild-/Visual Studio-Version Auslieferungsdatum Lebenszyklus
6.0.1xx 17.0 Nov. 2021 Nov. 20241
6.0.2xx 17.1 Feb. 2022 Mai 2022
6.0.3xx 17.23 Mai 2022 Okt. 2023
6.0.4xx 17.3 Aug. 22 Nov. 20242
8.0.1xx 17.8 Nov. 23 Nov. 251
8.0.2xx 17.93 Feb. 24 Mai 2024
8.0.3xx 17.10 Mai 2024 TBD
8.0.4xx 17,11 Aug. 24 Nov. 252
9.0.1xx 17.12 Nov. 24 Mai 261

Hinweis

net6.0 als Ziel wird offiziell nur in Visual Studio 17.0 und höher unterstützt. net7.0 als Ziel wird offiziell nur in Visual Studio 17.4 und höheren Versionen unterstützt. net8.0 als Ziel wird offiziell nur in Visual Studio 17.8 und höheren Versionen unterstützt.

1 Die Featuregruppen des .1xx .NET SDK werden während des gesamten Lebenszyklus von .NET-Hauptversionen unterstützt. Während des erweiterten Supportzeitraums ist der Support nur auf Sicherheitsfixes und minimale andere Fixes mit hoher Priorität und nur auf Linux beschränkt. Weitere Informationen zu den Gründen für diesen erweiterten Support finden Sie im Dokument zur Unterstützung des Quellbuilds.

2 Die Featuregruppen des .4xx .NET SDK werden für die Laufzeit der entsprechenden Runtime als eigenständige Installationen unterstützt.

3 Für 6.0.300, 7.0.200, and 8.0.200 sind neuer Visual Studio-Versionen erforderlich. Weitere Informationen finden Sie in den Supportregeln.

Visual Studio 2019-Lebenszyklus

Visual Studio 2022-Lebenszyklus

Zielfestlegung und Regeln für die Unterstützung

Ab .NET SDK 7.0.100 und .NET SDK 6.0.300 wurde eine Richtlinie bezüglich der MSBuild- und Visual Studio-Versionen eingeführt, mit der eine bestimmte Version des .NET SDK ausgeführt wird. Die Richtlinie lautet wie folgt:

  • Jedes neue TargetFramework erfordert eine neue Visual Studio-Version oder eine neue dotnet-Version.
  • Die erste Version von Visual Studio, die ein neues TargetFramework unterstützt, wird die Mindestversion für die Featuregruppen dieses SDK beispielsweise für die Roslyn-API-Schnittstelle, MSBuild-Ziele, Quell-Generatoren und Analysetools.
  • Die erste Version eines neuen .NET SDK, die ein neues TargetFramework unterstützt, kann auch mit der früheren Visual Studio-Version verwendet werden, um ein Viertel der Tools und Infrastruktur (z. B. Aktionen und Pipelines) zu migrieren.
SDK Visual Studio-Version
in der das SDK enthalten ist
Mindestversion von Visual Studio TargetFramework-Höchstversion in
Mindestversion von Visual Studio
TargetFramework-Höchstversion in dotnet
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
8.0.400 17,11 17.8 Net8.0 Net8.0
9.0.100 17.12 17,11 Net8.0 Net9.0

Hinweis

Die Tabelle zeigt, wie diese Versionsverwaltungsregeln in Zukunft ab .NET SDK 7.0.100 und .NET SDK 6.0.300 angewendet werden. Zudem wird erläutert, wie die Richtlinie bei Verfügbarkeit auf zuvor veröffentlichte Versionen des .NET SDK angewendet worden wäre. Die Anforderungen für frühere Versionen des SDK ändern sich jedoch nicht. Dies bedeutet, dass die mindestens erforderliche Visual Studio-Version für .NET SDK 6.0.100 oder 6.0.200 die Version 16.10 bleibt.

1 Ein Breaking Change in Version 7.0.300 für die Blazor- und Razor-Entwicklung erfordert Visual Studio Version 17.6 oder höher. Weitere Informationen finden Sie unter dotnet/razor issue 8718.

Für eine konsistente Toolnutzung sollten Sie zum Erstellen Ihrer Anwendung nach Möglichkeit dotnet build anstelle von msbuild verwenden.

Versionsverwaltung für Vorschauversionen

Hauptversionen des .NET SDK werden in der Regel innerhalb weniger Tage nach einer Visual Studio-Vorschauversion veröffentlicht. Möglicherweise funktionieren auch andere Kombinationen, aber nur die zuletzt veröffentlichte Vorschauversion wird getestet und offiziell unterstützt. Die folgende Tabelle zeigt, mit welcher Visual Studio-Version jede .NET-Vorschauversion vor der Veröffentlichung getestet wurde.

SDK-Vorschauversion Visual Studio-Version
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
9.0.100 Preview 4 17.11 Preview 1
9.0.100 Preview 5 17.11 Preview 2
9.0.100 Preview 6 17.11 Preview 3
9.0.100 Preview 7 17.12 Preview 1
9.0.100 RC 1 17.12 Preview 2
9.0.100 RC 2 17.12 Preview 3

Verweis