.NET SDK, MSBuild és Visual Studio verziószámozás
A .NET SDK verziószámozása és a Visual Studióhoz és az MSBuildhez való viszonya zavaró lehet. MSBuild-verziók a Visual Studióval, de a .NET SDK-ban is megtalálható. Az SDK rendelkezik az MSBuild és a Visual Studio azon minimális verziójával, amellyel működik, és nem töltődik be a Visual Studio azon verziójában, amely régebbi ennél a minimális verziónál.
Verziókezelés
A .NET SDK-verzió első része alapértelmezés szerint megegyezik a .NET-verzióval, amely tartalmazza, futtatja és célként használja. A funkciósáv 1-nél kezdődik, és minden negyedéves Visual Studio-alverzió esetében nő. A javítás verziója minden hónap karbantartási frissítéseivel növekszik.
Például a 7.0.203-as verzió a .NET 7-es verziójával a második kisebb Visual Studio-kiadás, mivel először megjelent a 7.0.100, és a harmadik javítás a 7.0.200-as kiadás óta.
Életciklus
Az SDK támogatási időkerete általában megegyezik a Visual Studio azon verziójával, amelyben szerepel.
Kibontás a nem támogatott .NET-verziók megtekintéséhez
SDK verziója | MSBuild/Visual Studio-verzió | Szállítási dátum | Életciklus |
---|---|---|---|
2.1.5xx | 15,9 | 18 nov | aug '21 |
2.1.8xx | 16.2 (Nem VS) | '19. július | aug '21 |
3.1.1xx | 16,4 | Dec '19 | Október '21 |
3.1.4xx | 16.7 | aug '20 | Dec '22 |
5.0.1xx | 16.8 | Nov '20 | 21. márc. |
5.0.2xx | 16,9 | '21. március | Május '22 |
5.0.3xx | 16,10 | '21. május | aug '21 |
5.0.4xx | 16.11 | aug '21 | Május '22 |
7.0.1xx | 17.4 | Nov '22 | '24. május |
7.0.2xx | 17.53 | Február '23 | Május '23 |
7.0.3xx | 17,6 | Május '23 | '24. május |
7.0.4xx | 17,7 | aug '23 | '24. május |
Támogatott .NET-verziók
SDK verziója | MSBuild/Visual Studio-verzió | Szállítási dátum | Életciklus |
---|---|---|---|
6.0.1xx | 17,0 | Nov '21 | Nov '241 |
6.0.2xx | 17.1 | Február '22 | Május '22 |
6.0.3xx | 17.23 | Május '22 | Október '23 |
6.0.4xx | 17,3 | aug '22 | Nov '242 |
8.0.1xx | 17.8 | Nov '23 | Nov '251 |
8.0.2xx | 17.93 | Február '24 | '24. május |
8.0.3xx | 17.10 | '24. május | Később eldöntendő |
8.0.4xx | 17.11 | aug '24 | Nov '252 |
9.0.1xx | 17.12 | Nov '24 | '26. május 1 |
Feljegyzés
A célzás net6.0
hivatalosan csak a Visual Studio 17.0+-ban támogatott.
A célzás net7.0
hivatalosan csak a Visual Studio 17.4+-ban támogatott.
A célzás net8.0
hivatalosan csak a Visual Studio 17.8+-ban támogatott.
Az 1 .1xx .NET SDK-funkciósávok a fő .NET-verziók teljes életciklusa alatt támogatottak. A kiterjesztett támogatási időszak alatt a támogatás csak a biztonsági javításokra és a minimális magas prioritású, nem biztonsági javításokra korlátozódik, csak Linux esetén. A kiterjesztett támogatás okával kapcsolatos további információkért lásd a forrásépítési támogatást.
A 2 .4xx .NET SDK-funkciósávok támogatottak az egyező futtatókörnyezet önálló telepítésekként való élettartamához.
A 3 6.0.300-at, a 7.0.200-at és a 8.0.200-at újabb Visual Studio-verziókra van szükség. További információkért tekintse meg a támogatási szabályokat.
Célzási és támogatási szabályok
A .NET SDK 7.0.100-tól és a .NET SDK 6.0.300-tól kezdve életbe lépett egy szabályzat, amely azt ismerteti, hogy az MSBuild és a Visual Studio mely verzióiban fog futni a .NET SDK egy adott verziója. A szabályzat a következő:
- Minden új TargetFrameworkhez új Visual Studio-verzióra vagy új
dotnet
verzióra van szükség. - Az új TargetFramework-et támogató Visual Studio első verziója a Roslyn API-felülethez készült SDK funkciósávjainak, az MSBuild-céloknak, a forrásgenerátoroknak, az elemzőknek és így tovább.
- Az új TargetFramework-et támogató új .NET SDK első verziója továbbra is használható a Visual Studio korábbi verziójával, hogy lehetővé tegye az eszközök és az infrastruktúra (például műveletek és folyamatok) egynegyedének áttelepítését.
SDK | Visual Studio-verzió az SDK hajók |
A Visual Studio minimális verziója | TargetFramework maximális kihasználtság a Visual Studio minimális verziója |
TargetFramework maximális kihasználtság 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 |
Feljegyzés
A táblázat a .NET SDK 7.0.100 és a .NET SDK 6.0.300 verziótól kezdődően mutatja be, hogyan fogják alkalmazni ezeket a verziószámozási szabályokat. Azt is bemutatja, hogy a szabályzat hogyan lett volna alkalmazva a .NET SDK korábban kiszállított verzióira, ha az akkor érvényben lett volna. Az SDK korábbi verzióira vonatkozó követelmények azonban nem változnak, vagyis a .NET SDK 6.0.100-as vagy 6.0.200-as verziójához készült Visual Studio minimálisan szükséges verziója 16.10 marad.
1 A Blazor és a Razor 7.0.300-ás verziójának kompatibilitástörő változásához a Visual Studio 17.6-os vagy újabb verziója szükséges. További információ: dotnet/razor issue 8718.
A konzisztens eszközhasználat dotnet build
biztosítása érdekében célszerű az alkalmazás létrehozása helyett msbuild
, ha lehetséges.
Előzetes verziószámozás
A .NET SDK fő verziói általában a Visual Studio előzetes verziójától számított néhány napon belül jelennek meg. Bár lehetnek más kombinációk is, amelyek működnek, csak a legújabb kiadású előzetes verziót tesztelik és hivatalosan támogatják. Az alábbi táblázat azt mutatja be, hogy a Visual Studio mely verziójával tesztelték az egyes .NET előzetes verziót a kiadás előtt.
SDK előzetes verzió | Visual Studio-verzió |
---|---|
9.0.100 Előzetes verzió 1 | 17.10 Előzetes verzió 1 |
9.0.100 2. előzetes verzió | 17.10 2. előzetes verzió |
9.0.100 Előzetes 3 | 17.10 Előzetes 3 |
9.0.100 Előzetes verzió 4 | 17.11 Előzetes verzió 1 |
9.0.100 Előzetes 5 | 17.11 Előzetes 2 |
9.0.100 Előzetes verzió 6 | 17.11 Előzetes 3 |
9.0.100 Előzetes 7 | 17.12 Előzetes verzió 1 |
9.0.100 RC 1 | 17.12 2. előzetes verzió |
9.0.100 RC 2 | 17.12 Előzetes 3 |