Správa verzí sady .NET SDK, MSBuild a Sady Visual Studio
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í
První část verze sady .NET SDK odpovídá verzi .NET, kterou zahrnuje, na které běží a na kterou je zaměřena ve výchozím nastavení. Úroveň funkcí začíná na 1 a zvyšuje se s každou čtvrtletní aktualizací menší verze sady Visual Studio. Verze opravy se zvyšuje s každou měsíční aktualizací údržby.
Například verze 7.0.203 přichází s .NET 7, je druhá podverze sady Visual Studio 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.
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 | Aug (ročník '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 | Aug (ročník '21) |
| 5.0.4xx | 16.11 | Aug (ročník '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 2024 |
| 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 '251 |
| 8.0.2xx | 17.9 | Únor (ročník '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 '252 |
| 9.0.1xx | 17.12 | Listopad '24 | Květen '26 |
| 9.0.2xx | 17.13 | Únor (ročník '25) | Květen '25 |
| 9.0.3xx | 17.14 | Květen '25 | 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 pásma funkcí sady .4xx .NET SDK jsou podporována po dobu životnosti odpovídajícího modulu runtime jako samostatné instalace.
Cílení a pravidla podpory
Následující zásada určuje, ve kterých verzích nástroje MSBuild a Visual Studio se daná verze sady .NET SDK spustí:
- 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 pro vývoj softwaru (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 |
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ší.
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é.
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 |
|---|---|
| 9.0.100 RC 1 | 17.12 Předběžná verze 2 |
| 9.0.100 RC 2 | 17.12 Preview 3 |
| 9.0.100 GA | 17.12 GA |
| 10.0.100 Preview 1 | 17.14 Preview 1 |
| 10.0.100 Preview 2 | 17.14 Preview 2 |
| 10.0.100 Předběžná verze 3 | 17.14 Preview 3 |
