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 NÁSTROJE MSBuild se sadou Visual Studio, ale jsou také součástí sady .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, která zahrnuje, běží na ní a cíle ve výchozím nastavení. Pásma funkcí začíná na 1 a zvyšuje se pro každou čtvrtletní podverzi sady Visual Studio. Verze opravy se zvýší o aktualizace údržby jednotlivých měsíců.
Například verze 7.0.203 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 | XI/18 | Aug (ročník '21) |
| 2.1.8xx | 16.2 (bez VS) | Červenec (ročník '19) | Aug (ročník '21) |
| 3.1.1xx | 16.4 | Prosinec (ročník '19) | Října (ročník '21) |
| 3.1.4xx | 16.7 | 20. | Prosinec (ročník '22) |
| 5.0.1xx | 16.8 | Listopad '20 | Mar (ročník '21) |
| 5.0.2xx | 16.9 | Březen (ročník '21) | Květen '22 |
| 5.0.3xx | 16,10 | Květen (ročník '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 (ročník '22) | Květen '22 |
| 6.0.3xx | 17.23 | Květen '22 | Října '23) |
| 6.0.4xx | 17.3 | 22. | Listopad '24 |
| 7.0.1xx | 17.4 | Listopad '22 | Květen (ročník '24) |
| 7.0.2xx | 17,53 | Únor (ročník '23) | Květen (ročník '23) |
| 7.0.3xx | 17.6 | Květen (ročník '23) | Květen (ročník '24) |
| 7.0.4xx | 17.7 | 23. | Květen (ročník '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 (ročník '24) |
| 8.0.3xx | 17.10 | Květen (ročník '24) | TBD |
| 8.0.4xx | 17.11 | 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 '26 |
| 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 stane podlahou pro pásy funkcí této sady SDK pro povrch rozhraní Roslyn API, cíle NÁSTROJE MSBuild, zdrojové generátory, analyzátory atd.
- 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 | Max TargetFramework in minimální verze sady Visual Studio |
Max TargetFramework in 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 zásada použila na dříve dodávané verze sady .NET SDK, pokud byla poté splněna. 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 se oficiálně podporuje jenom v sadě Visual Studio 17.8 nebo novější.
Cílení net9.0 je oficiálně podporováno pouze ve Visual Studio 17.12 nebo novější.
Pokud chcete zajistit konzistentní nástroje, měli byste místo sestavení aplikace použít dotnet buildmsbuild , 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.
| Verze Preview sady SDK | Verze sady Visual Studio |
|---|---|
| 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 |
| 10.0.100 Preview 1 | 17.14 Preview 1 |
