.NET SDK, MSBuild en Visual Studio-versiebeheer
De versiebeheer van de .NET SDK en hoe deze zich verhoudt tot Visual Studio en MSBuild kan verwarrend zijn. MSBuild-versies met Visual Studio, maar is ook opgenomen in de .NET SDK. De SDK heeft een minimale versie van MSBuild en Visual Studio waarmee de SDK werkt en laadt niet in een versie van Visual Studio die ouder is dan die minimale versie.
Versiebeheer
Het eerste deel van de .NET SDK-versie komt overeen met de .NET-versie die deze bevat, wordt standaard uitgevoerd en doelen. De functieband begint bij 1 en neemt toe voor elke kleine versie van Visual Studio per kwartaal. De patchversie wordt verhoogd met de onderhoudsupdates van elke maand.
Versie 7.0.203 wordt bijvoorbeeld geleverd met .NET 7, is de tweede secundaire Visual Studio-release sinds 7.0.100 is uitgebracht en is de derde patch sinds 7.0.200 uitgebracht.
Levenscyclus
De ondersteuningsperiode voor de SDK komt doorgaans overeen met die van de Visual Studio-versie waarin deze is opgenomen.
| SDK-versie | MSBuild/Visual Studio-versie | Verzenddatum | Levenscyclus |
|---|---|---|---|
| 2.1.5xx | 15.9 | Nov 18 | Aug '21 |
| 2.1.8xx | 16.2 (Geen VS) | Juli '19 | Aug '21 |
| 3.1.1xx | 16.4 | Dec '19 | 21 oktober |
| 3.1.4xx | 16.7 | Aug '20 | 22 december |
| 5.0.1xx | 16.8 | November '20 | Mar '21 |
| 5.0.2xx | 16.9 | 21 maart | 22 mei |
| 5.0.3xx | 16,10 | 21 mei | Aug '21 |
| 5.0.4xx | 16.11 | Aug '21 | 22 mei |
| 6.0.1xx | 17,0 | 21 november | 24november 1 |
| 6.0.2xx | 17.1 | 22 februari | 22 mei |
| 6.0.3xx | 17.23 | 22 mei | 23 oktober |
| 6.0.4xx | 17.3 | Aug '22 | 24november 2 |
| 7.0.1xx | 17.4 | 22 november | 24mei 1 |
| 7.0.2xx | 17,53 | 23 februari | 23 mei |
| 7.0.3xx | 17.6 | 23 mei | 24 mei |
| 7.0.4xx | 17.7 | Aug '23 | 24mei 2 |
| 8.0.1xx | 17.8 | 23 november | N.t.b. |
| 8.0.2xx | 17.93 | 24 februari | N.t.b. |
| 8.0.3xx | 17.10 | 24 mei | N.t.b. |
Notitie
Targeting net6.0 wordt officieel ondersteund in Visual Studio 17.0+ alleen.
Targeting net7.0 wordt officieel ondersteund in Visual Studio 17.4+ alleen.
Targeting net8.0 wordt officieel ondersteund in Visual Studio 17.8+ alleen.
1 .1xx .NET SDK-functiebanden worden gedurende de levenscyclus van primaire .NET-versies ondersteund. Tijdens de verlengde ondersteuningsperiode is de ondersteuning beperkt tot beveiligingsoplossingen en minimale niet-beveiligingsoplossingen met hoge prioriteit voor Alleen Linux. Zie Source-build-ondersteuning voor meer informatie over de redenering voor deze uitgebreide ondersteuning.
2 .4xx .NET SDK-functiebanden worden ondersteund voor de levensduur van de overeenkomende runtime als zelfstandige installaties.
3 6.0.300, 7.0.200 en 8.0.200 vereisen nieuwere Visual Studio-versies. Zie de ondersteuningsregels voor meer informatie.
Regels voor targeting en ondersteuning
Vanaf .NET SDK 7.0.100 en .NET SDK 6.0.300 is een beleid geïmplementeerd met betrekking tot de versies van MSBuild en Visual Studio waarin een bepaalde versie van de .NET SDK wordt uitgevoerd. Het beleid is:
- Voor elk nieuw TargetFramework is een nieuwe Visual Studio-versie of een nieuwe
dotnetversie vereist. - De eerste versie van Visual Studio die ondersteuning biedt voor een nieuw TargetFramework wordt een verdieping voor de functiebanden van die SDK voor roslyn-API-oppervlak, MSBuild-doelen, brongeneratoren, analyses, enzovoort.
- De eerste versie van een nieuwe .NET SDK die ondersteuning biedt voor een nieuw TargetFramework, kan nog steeds worden gebruikt met de vorige versie van Visual Studio, zodat een kwart voor hulpprogramma's en infrastructuur (bijvoorbeeld acties en pijplijnen) kan worden gemigreerd.
| SDK | Visual Studio-versie de SDK wordt geleverd met |
Minimale Versie van Visual Studio | Max TargetFramework in minimale Versie van 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 |
Notitie
In de tabel ziet u hoe deze versiebeheerregels in de toekomst worden toegepast, te beginnen met .NET SDK 7.0.100 en .NET SDK 6.0.300. Het geeft ook weer hoe het beleid zou zijn toegepast op eerder verzonden versies van de .NET SDK, als het toen was ingesteld. De vereisten voor eerdere versies van de SDK veranderen echter niet. Dat wil gezegd: de minimaal vereiste versie van Visual Studio voor .NET SDK 6.0.100 of 6.0.200 blijft 16.10.
1 Een belangrijke wijziging in 7.0.300 voor Blazor- en Razor-ontwikkeling vereist Visual Studio versie 17.6 of hoger. Zie dotnet/razor issue 8718 voor meer informatie.
Als u consistente hulpprogramma's wilt garanderen, moet u deze gebruiken dotnet build in plaats msbuild van uw toepassing te bouwen wanneer dat mogelijk is.
Preview-versiebeheer
Primaire versies van de .NET SDK worden doorgaans binnen een paar dagen na een preview-versie van Visual Studio uitgebracht. Hoewel er mogelijk andere combinaties zijn die werken, wordt alleen de nieuwste preview getest en officieel ondersteund. In de volgende tabel ziet u welke versie van Visual Studio elke .NET preview-versie is getest met vóór de release.
| PREVIEW-versie van SDK | Visual Studio-versie |
|---|---|
| 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 |
Verwijzing
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor