Udostępnij za pośrednictwem

Wersje zestawów .NET SDK, MSBuild i Visual Studio

  • Artykuł

Przechowywanie wersji zestawu .NET SDK i jego powiązania z programem Visual Studio i programem MSBuild może być mylące. Wersje programu MSBuild są dostępne w programie Visual Studio, a także wchodzą w skład zestawu SDK platformy .NET. Zestaw SDK ma minimalną wersję programu MSBuild i programu Visual Studio, z którą współpracuje, i nie zostanie załadowany w wersji programu Visual Studio starszej niż ta minimalna wersja.

Wersjonowanie

Pierwsza część wersji zestawu .NET SDK odpowiada wersji .NET, którą obejmuje, na której jest uruchamiana i na którą jest skierowana domyślnie. Zakres funkcji rozpoczyna się od 1 i zwiększa się dla każdej kwartalnej pomniejszej wersji programu Visual Studio. Numer wersji poprawki zwiększa się z każdą miesięczną aktualizacją serwisową.

Na przykład wersja 7.0.203 jest dostarczana z platformą .NET 7, jest drugą wersją pomocniczą programu Visual Studio od czasu wydania wersji 7.0.100 i jest trzecią poprawką od wersji 7.0.200.

Instalacja programu Visual Studio obejmuje pojedynczą zgodną kopię zestawu .NET SDK. Jeśli zaktualizujesz swoje wystąpienie Visual Studio, zestaw .NET SDK zainstalowany przez Visual Studio również zostanie zaktualizowany, w tym w przypadku różnych wersji funkcjonalnych i głównych wersji zestawu .NET SDK. Jeśli chcesz użyć innego pakietu .NET SDK niż zainstalowanego przez Visual Studio, możesz go zainstalować ze strony pobierania .NET, a aktualizacja Visual Studio nie zmieni tej wersji. Odpowiadasz za zaktualizowanie tej kopii zestawu .NET SDK od tego momentu.

Uwaga

Zestaw .NET SDK obsługuje określanie wersji platformy .NET na poziomie podrzędnym, dlatego zalecamy zawsze aktualizowanie zestawu .NET SDK wraz z wersją programu Visual Studio.

Cykl życia

Przedział czasu pomocy technicznej dla zestawu SDK jest zwykle zgodny z wersją programu Visual Studio, w którą jest uwzględniony.

Rozwiń, aby wyświetlić niewspierane wersje .NET
Wersja zestawu SDK MsBuild/Wersja programu Visual Studio Data wysyłki Cykl życia
2.1.5xx 15,9 Lis 2018 21 sierpnia
2.1.8xx 16.2 (brak Visual Studio) 19 lipca 21 sierpnia
3.1.1xx 16,4 Grudzień '19 21 października
3.1.4xx 16.7 20 sierpnia Grudzień '22
5.0.1xx 16.8 20 listopada marzec 2021
5.0.2xx 16,9 21 marca 22 maja
5.0.3xx 16,10 21 maja 21 sierpnia
5.0.4xx 16.11 21 sierpnia 22 maja
6.0.1xx 17,0 21 listopada 24 listopada
6.0.2xx 17.1 22 lutego 22 maja
6.0.3xx 17.23 22 maja 23 października
6.0.4xx 17,3 22 sierpnia 24 listopada
7.0.1xx 17.4 22 listopada 24 maja
7.0.2xx 17.53 23 lutego 23 maja
7.0.3xx 17,6 23 maja 24 maja
7.0.4xx 17,7 23 sierpnia 24 maja

Obsługiwane wersje platformy .NET

Wersja zestawu SDK MsBuild/Wersja programu Visual Studio Data wysyłki Cykl życia
8.0.1xx 17.8 23 listopada 1listopada '25
8.0.2xx 17,9 24 lutego 24 maja
8.0.3xx 17.10 24 maja 26 stycznia
8.0.4xx 17.11 24 sierpnia Listopad '252
9.0.1xx 17.12 24 listopada 26 maja
9.0.2xx 17.13 25 lutego 25 maja
9.0.3xx 17.14 25 maja 26 maja

Uwaga

1 .1xx .NET SDK (Zakresy funkcji zestawu .NET SDK 1xx) są obsługiwane w całym cyklu życia głównych wersji platformy .NET. W dłuższym okresie wsparcia pomoc techniczna jest ograniczona do poprawek zabezpieczeń i minimalnych poprawek niezwiązanych z zabezpieczeniami o wysokim priorytcie tylko dla systemu Linux. Aby dowiedzieć się więcej na temat rozumowania dla tego rozszerzonego wsparcia, zobacz Wsparcie dla kompilacji źródła.

Zespoły funkcji SDK .NET w wersji 2 .4xx są wspierane przez cały okres życia zgodnego środowiska uruchomieniowego jako samodzielne instalacje.

Cykl życia programu Visual Studio 2019

Cykl życia programu Visual Studio 2022

Reguły kierowania i wsparcia

Następujące zasady określają, w których wersjach programów MSBuild i Visual Studio zostanie uruchomiona dana wersja zestawu .NET SDK:

  • Każdy nowy element TargetFramework wymaga nowej wersji programu Visual Studio lub nowej dotnet wersji.
  • Pierwsza wersja programu Visual Studio, która obsługuje nowy element TargetFramework, staje się podłogą dla przedziałów funkcji tego zestawu SDK dla powierzchni interfejsu API Roslyn, obiektów docelowych MSBuild, generatorów źródłowych, analizatorów itd.
  • Pierwsza wersja nowego zestawu .NET SDK, który obsługuje nowy element TargetFramework, nadal może być używana z poprzednią wersją programu Visual Studio, aby umożliwić trzy miesiące na migrację narzędzi i infrastruktury (na przykład akcji i potoków).
SDK Wersja programu Visual Studio
zestaw SDK jest dostarczany z		 Minimalna wersja programu Visual Studio Maksymalna liczba elementów TargetFramework w
minimalna wersja programu Visual Studio		 Maksymalna liczba elementów TargetFramework w 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

Uwaga

W tabeli przedstawiono sposób stosowania tych reguł przechowywania wersji, począwszy od zestawu .NET SDK 7.0.100 i zestawu .NET SDK 6.0.300. Przedstawia również sposób, w jaki zasady miałyby zastosowanie do wcześniej dostarczonych wersji zestawu .NET SDK, gdyby zostały wprowadzone. Jednak wymagania dotyczące poprzednich wersji zestawu SDK nie ulegają zmianie — czyli minimalna wymagana wersja programu Visual Studio dla zestawu .NET SDK 6.0.100 lub 6.0.200 pozostaje w wersji 16.10.

Określanie wartości docelowej net8.0 jest oficjalnie obsługiwane tylko w programie Visual Studio 17.8 lub nowszym.

Określanie wartości docelowej net9.0 jest oficjalnie obsługiwane tylko w programie Visual Studio 17.12 lub nowszym.

Aby zapewnić spójność narzędzi, należy użyć dotnet build zamiast msbuild do kompilacji aplikacji, gdy jest to możliwe.

Wersjonowanie zapoznawcze

Główne wersje zestawu .NET SDK są zwykle wydawane w ciągu kilku dni od wersji zapoznawczej programu Visual Studio. Chociaż mogą istnieć inne kombinacje, tylko najnowsza wersja zapoznawcza jest testowana i oficjalnie obsługiwana. W poniższej tabeli pokazano, z którą wersją programu Visual Studio każda wersja zapoznawcza .NET została przetestowana przed wydaniem.

Wersja zapoznawcza zestawu SDK Wersja programu Visual Studio
9.0.100 RC 1 17.12 (wersja zapoznawcza 2)
9.0.100 RC 2 17.12 (wersja zapoznawcza 3)
9.0.100 GA 17.12 ogólna dostępność
10.0.100 (wersja zapoznawcza 1) 17.14 (wersja zapoznawcza 1)
10.0.100 (wersja zapoznawcza 2) 17.14 (wersja próbna 2)
10.0.100 (wersja zapoznawcza 3) 17.14 (wersja zapoznawcza 3)

Odwołanie