.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.
Een installatie van Visual Studio bevat één overeenkomende kopie van de .NET SDK. Als u uw Visual Studio-exemplaar bijwerkt, wordt de .NET SDK die door Visual Studio is geïnstalleerd, ook bijgewerkt, inclusief de .NET SDK-functiebanden en grote versies. Als u een andere .NET SDK wilt gebruiken dan wat door Visual Studio is geïnstalleerd, kunt u deze installeren vanaf de .NET-downloadpaginaen de Visual Studio-upgrade raakt die versie niet aan. U bent verantwoordelijk voor het bijwerken van die kopie van de .NET SDK vanaf dat jaar.
Notitie
De .NET SDK biedt ondersteuning voor downlevel versies van .NET. Daarom raden we u aan uw .NET SDK altijd bij te werken samen met uw Visual Studio-versie.
Levenscyclus
De ondersteuningsperiode voor de SDK komt doorgaans overeen met die van de Visual Studio-versie waarin deze is opgenomen.
Uitvouwen om out-of-support .NET-versies weer te geven
| 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 | November '24 |
| 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 | November '24 |
| 7.0.1xx | 17.4 | 22 november | 24 mei |
| 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 | 24 mei |
Ondersteunde .NET-versies
| SDK-versie | MSBuild/Visual Studio-versie | Verzenddatum | Levenscyclus |
|---|---|---|---|
| 8.0.1xx | 17.8 | 23 november | 25november 1 |
| 8.0.2xx | 17.93 | 24 februari | 24mei 3 |
| 8.0.3xx | 17.10 | 24 mei | N.t.b. |
| 8.0.4xx | 17.11 | 24 aug | 25november 2 |
| 9.0.1xx | 17.12 | November '24 | 26mei 1 |
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.
Voor 3 8.0.200 is een nieuwere Versie van Visual Studio vereist. Zie de ondersteuningsregels voor meer informatie.
Regels voor targeting en ondersteuning
Een van de volgende beleidsregels bepaalt in welke versies van MSBuild en Visual Studio een bepaalde versie van de .NET SDK wordt uitgevoerd:
- Voor elk nieuw TargetFramework .
- 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.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 |
Notitie
In de tabel ziet u hoe deze versiebeheerregels 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 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 |
| 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 |
| 9.0.100 GA | 17.12 GA |
