.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ó tartalmazza a .NET 7-et, a második kisebb Visual Studio-kiadás a 7.0.100 óta, és a harmadik javítás a 7.0.200 óta, hogy megjelent.
A Visual Studio telepítése tartalmazza a .NET SDK egyetlen egyező példányát. Ha frissíti a Visual Studio-példányt, a Visual Studio által telepített .NET SDK is frissül, beleértve a .NET SDK-szolgáltatássávokat és a fő sávokat is. Ha a Visual Studio által telepítettnél más .NET SDK-t szeretne használni, a .NET-letöltési oldalról telepítheti, és a Visual Studio frissítése nem érinti ezt a verziót. Ön a felelős a .NET SDK ezen másolatának frissítéséért.
Feljegyzés
A .NET SDK támogatja a .NET alacsonyabb szintű verzióinak megcélzását, ezért javasoljuk, hogy mindig frissítse a .NET SDK-t a Visual Studio-verzióval együtt.
É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 | augusztus '21 |
| 5.0.4xx | 16.11 | aug '21 | Május '22 |
| 6.0.1xx | 17,0 | Nov '21 | Nov '24 |
| 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. '24 |
| 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 |
|---|---|---|---|
| 8.0.1xx | 17.8 | Nov '23 | Nov '251 |
| 8.0.2xx | 17,9 | Február '24 | '24. május |
| 8.0.3xx | 17.10 | '24. május | Jan '26 |
| 8.0.4xx | 17.11 | aug '24 | Nov '252 |
| 9.0.1xx | 17.12 | Nov '24 | '26. május |
| 9.0.2xx | 17.13 | Február '25 | Május '25 |
| 9.0.3xx | 17.14 | Május '25 | '26. május |
Feljegyzés
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.
Célzási és támogatási szabályok
A következő szabályzat határozza meg, hogy az MSBuild és a Visual Studio mely verzióiban fog futni a .NET SDK egy adott verziója:
- Minden új TargetFramework új Visual Studio verziót vagy egy új
dotnetverziót igényel. - A Visual Studio azon első verziója, amely támogatja az új TargetFramework-et, alapot szolgáltat az SDK funkciócsoportjainak, a Roslyn API-felülethez, az MSBuild-célokhoz, a forrásgenerátorokhoz, elemzőkhöz é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 tartalmazza |
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 |
|---|---|---|---|---|
| 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 |
| 9.0.200 | 17.13 | 17.12 | Net9.0 | Net9.0 |
| 9.0.300 | 17.14 | 17.12 | Net9.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 kezdve mutatja be a verziószámozási szabályok alkalmazását. 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.
A célzás net8.0 hivatalosan csak a Visual Studio 17.8+-ban támogatott.
A net9.0 célzása hivatalosan csak a Visual Studio 17.12+-ban támogatott.
A konzisztens eszközhasználat biztosítása érdekében célszerű dotnet build használni az alkalmazás építéséhez, ahelyett, hogy msbuild -t használna, ha lehetséges.
Előzetes verziók kezelése
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 RC 1 | 17.12 2. előzetes verzió |
| 9.0.100 RC 2 | 17.12 Előzetes 3 |
| 9.0.100 GA | 17.12 GA |
| 10.0.100 Előzetes verzió 1 | 17.14 Előzetes verzió 1 |
| 10.0.100 2. előzetes verzió | 17.14 2. előzetes verzió |
| 10.0.100 Előzetes 3 | 17.14 Előzetes 3 |
