Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Správa verzí sady .NET SDK a jeho vztah k sadě Visual Studio a nástroji MSBuild může být matoucí. Verze MSBuild jsou součástí sady Visual Studio, ale jsou zahrnuty i v .NET SDK. Sada SDK má minimální verzi nástroje MSBuild a Visual Studio, se kterou pracuje, a nenačte se ve verzi sady Visual Studio, která je starší než tato minimální verze.
Vytváření verzí
Číslo verze sady .NET SDK používá formát major.minor.patch, kde:
-
major.minorodpovídá verzi .NET, kterou sada SDK zahrnuje, spouští a cíluje ve výchozím nastavení. - Cifry stovek
patchurčuje pás funkcí, například1xx,2xx,3xx, nebo4xx. Pásma funkcí začíná na 1 a zvyšuje se pro každou čtvrtletní verzi sady .NET SDK. - Poslední dvě číslice
patchjsou verze opravy, která se zvýší o servisní aktualizaci každého měsíce.
Například verze 7.0.203 se dodává s rozhraním .NET 7, je druhou čtvrtletní verzí funkční série od vydání verze 7.0.100 a je třetí opravou od vydání verze 7.0.200.
Instalace sady Visual Studio obsahuje jednu odpovídající kopii sady .NET SDK. Pokud aktualizujete instanci sady Visual Studio, aktualizuje se také sada .NET SDK nainstalovaná sadou Visual Studio, včetně pásem funkcí sady .NET SDK a hlavních pásem. Pokud chcete použít jinou sadu .NET SDK než nainstalovanou sadou Visual Studio, můžete ji nainstalovat ze stránky pro stažení .NETa upgrade sady Visual Studio se této verzi nedotkne. Zodpovídáte za aktualizaci této kopie sady .NET SDK od tého dne.
Počínaje verzí Visual Studio 18.0 se Visual Studio bude dodávat v měsíčních menších verzích, zatímco .NET SDK se bude dodávat čtvrtletně. Verze sady Visual Studio mezi čtvrtletními verzemi sady .NET SDK obsahují pouze verze oprav nejnovější sady .NET SDK.
Poznámka:
Sada .NET SDK podporuje cílení na nižší verze .NET, proto doporučujeme vždy aktualizovat sadu .NET SDK spolu s vaší verzí sady Visual Studio.
Životní cyklus
Časový rámec podpory sady SDK obvykle odpovídá verzi sady Visual Studio, do které je součástí.
Rozbalením zobrazíte verze .NET, které nepodporují.
| Verze sady SDK | Verze nástroje MSBuild/Visual Studio | Datum expedice | Životní cyklus |
|---|---|---|---|
| 2.1.5xx | 15,9 | lis '18 | srpen '21 |
| 2.1.8xx | 16.2 (bez VS) | Červenec '19 | srpen '21 |
| 3.1.1xx | 16.4 | Prosinec '19 | Říjen '21 |
| 3.1.4xx | 16.7 | srpen 2020 | Prosinec '22 |
| 5.0.1xx | 16.8 | Listopad '20 | březen '21 |
| 5.0.2xx | 16.9 | Březen '21 | Květen '22 |
| 5.0.3xx | 16,10 | Květen '21 | srpen '21 |
| 5.0.4xx | 16.11 | srpen '21 | Květen '22 |
| 6.0.1xx | 17.0 | Listopad '21 | Listopad '24 |
| 6.0.2xx | 17.1 | Únor '22 | Květen '22 |
| 6.0.3xx | 17.23 | Květen '22 | Říj '23 |
| 6.0.4xx | 17,3 | srp '22 | Listopad '24 |
| 7.0.1xx | 17.4 | Listopad '22 | květen '24 |
| 7.0.2xx | 17,53 | Únor '23 | Květen '23 |
| 7.0.3xx | 17.6 | Květen '23 | květen '24 |
| 7.0.4xx | 17.7 | srp '23 | květen '24 |
Podporované verze .NET
| Verze sady SDK | Verze nástroje MSBuild/Visual Studio | Datum expedice | Životní cyklus |
|---|---|---|---|
| 8.0.1xx | 17.8 | Listopad '23 | Listopad '261 |
| 8.0.2xx | 17,9 | Únor '24 | květen '24 |
| 8.0.3xx | 17.10 | květen '24 | Jan (ročník '26) |
| 8.0.4xx | 17.11 | srpen '24 | Listopad '262 |
| 9.0.1xx | 17.12 | Listopad '24 | Květen '26 |
| 9.0.2xx | 17.13 | Únor '25 | Květen '25 |
| 9.0.3xx | 17.14 | Květen '25 | Listopad '262 |
| 10.0.1xx | 18,0 | Listopad '25 | Listopad '28 |
| 10.0.2xx | 18.4 | Bře '26 | Květen '26 |
Poznámka:
1 pásma funkcí .1xx .NET SDK jsou podporována v průběhu životního cyklu hlavních verzí .NET. Během období rozšířené podpory je podpora omezená na opravy zabezpečení a minimální opravy nesouvisecí se zabezpečením s vysokou prioritou pouze pro Linux. Další informace o důvodech této rozšířené podpory najdete v tématu Podpora zdrojového sestavení.
2 Poslední funkční balíčky sady .NET SDK pro hlavní verzi jsou podporovány po dobu životnosti odpovídajícího modulu runtime jako samostatné instalace.
Životní cyklus sady Visual Studio 2026
Cílení a pravidla podpory
Následující zásada určuje, ve kterých verzích nástroje MSBuild a Visual Studio se bude spouštět daná verze sady .NET SDK:
- Každá nová verze TargetFramework vyžaduje novou verzi sady Visual Studio nebo novou
dotnetverzi. - První verze sady Visual Studio, která podporuje nový TargetFramework, se stává základem pro verze funkcí této sady SDK, zahrnující API rozhraní Roslyn, cíle MSBuild, zdrojové generátory, analyzátory a podobně.
- První verze nové sady .NET SDK, která podporuje nový TargetFramework, se dá dál používat s předchozí verzí sady Visual Studio, aby bylo možné migrovat nástroje a infrastrukturu (například akce a kanály).
| sada SDK | Verze sady Visual Studio sada SDK je dodávána s |
Minimální verze sady Visual Studio | Maximální cílový rámec v minimální verze sady Visual Studio |
Maximální TargetFramework v 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 |
| 10.0.100 | 18,0 | 17.14 | Net9.0 | Net10.0 |
| 10.0.200 | 18.4 | 18,0 | Net10.0 | Net10.0 |
Poznámka:
Tabulka znázorňuje způsob použití těchto pravidel správy verzí počínaje sadou .NET SDK 7.0.100 a sadou .NET SDK 6.0.300. Také znázorňuje, jak by se politika vztahovala na dříve distribuované verze sady .NET SDK, kdyby tehdy platila. Požadavky na předchozí verze sady SDK se ale nemění – to znamená, že minimální požadovaná verze sady Visual Studio pro .NET SDK 6.0.100 nebo 6.0.200 zůstává 16.10.
Cílení net8.0 je oficiálně podporováno pouze ve Visual Studio verze 17.8 nebo vyšší.
Cílení net9.0 je oficiálně podporováno pouze ve Visual Studio 17.12 nebo novější.
Cílení net10.0 je oficiálně podporováno pouze v sadě Visual Studio 18.0 nebo vyšší.
Pro zajištění konzistentních nástrojů byste měli použít dotnet build místo msbuild k sestavení vaší aplikace, pokud je to možné.
Matice podpory sady SDK a sady Visual Studio
Většina vývojářů používá sadu .NET SDK, která je součástí jejich verze sady Visual Studio, ale některé konfigurace zahrnují neshodu sad SDK a verzí sady Visual Studio. Neexistuje žádná záruka, že každá verze sady Visual Studio funguje s každou sadou .NET SDK podporující podporu. Nejběžnější konfigurace se testují, aby se zajistilo co nejlepší úsilí o kompatibilitu.
Zpětná a dopředná kompatibilita
-
Primární podporovaná konfigurace: Použití verze sady SDK, která je součástí instalace sady Visual Studio
- Visual Studio 17.14 a .NET 9.0.3xx
- Visual Studio 18.0 a .NET 10.0.1xx
- Zpětná kompatibilita: Použití nejnovějšího pásma funkcí předchozí verze sady SDK (například 8.0.4xx v sadě Visual Studio 17.14) je podporováno s kompatibilitou s nejlepším úsilím. Tým .NET určuje, kdy provést opravy backportu na základě rizika a dopadu na zákazníka. Sady SDK, které jsou starší než nejnovější verze v předchozí řadě, sice můžou fungovat, ale tým .NET je netestuje ani se nesnaží zajistit jejich kompatibilitu.
- Dopředná kompatibilita: Použití novější sady SDK (například sada .NET 10 SDK v sadě Visual Studio 17.14) je povolená bez blokování, ale cílení na novější moduly runtime ve starších verzích sady Visual Studio není podporované a vytvoří upozornění na sestavení.
Pokyny
Použijte sadu SDK, která byla součástí vaší instance sady Visual Studio (nebo nejnovější dostupná v CI nebo Visual Studio Code), protože tato verze má vždy nejnovější funkce, včetně aktualizací zabezpečení.
Podpora cílení na nižší úroveň
Sada .NET SDK zachovává cílení na verze .NET, které již nejsou podporovány. Sada SDK 10.0.100 může vytvářet aplikace, které cílí net9.0 až do netcoreapp1.0.
Hlavní principy
- Zachování stávající podpory: Cílení na podporu nepodporovaných verzí zůstává v sadě SDK bez aktivního odebrání. Zákazníci, kteří upgradují svou sadu SDK nebo verzi sady Visual Studio, by neměli mít své buildy poškozené jednoduše tím, že cílí na starší verzi .NET.
- Nové funkce: Nové funkce sady SDK nejsou nutné k podpoře verzí mimo podporu, pokud vyloučení takové podpory nepředstavuje značné náklady nebo riziko.
- Opravy poruch: Pokud při cílení na verze bez podpory dojde k problémům, použije se oprava na základě nákladů. Cílem je zabránit tomu, aby zákazníkům během upgradu vznikaly problémy.
Správa verzí Preview
Hlavní verze sady .NET SDK se obvykle vydávají během několika dnů od verze Visual Studio Preview. I když můžou fungovat i jiné kombinace, testuje se a oficiálně podporuje pouze nejnovější vydaná verze Preview. Následující tabulka uvádí, která verze sady Visual Studio byla před vydáním testována pro každou verzi .NET Preview.
| Preview verze sady SDK | Verze sady Visual Studio |
|---|---|
| 10.0.100 RC 1 | 18.0.0 Insiders (11010.61) |
| 10.0.100 RC 2 | 18.0.0 Insiders (11111.16) |
| 11.0.100 Preview 1 | 18.4.0 Insiders |
| 11.0.100 Preview 2 | 18.5.0 Insiders |