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 w programie Visual Studio, ale są również zawarte w zestawie 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.

Wersje

Pierwsza część wersji zestawu .NET SDK jest zgodna z wersją platformy .NET, która zawiera, jest domyślnie uruchamiana i docelowa. Przedział funkcji rozpoczyna się od 1 i zwiększa się dla każdego kwartalnie wersji pomocniczej programu Visual Studio. Wersja poprawki zwiększa się wraz z aktualizacjami obsługi każdego miesiąca.

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.

Cykl życia

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

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 programu VS) 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 Mar '21
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 24listopada 1
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 24listopada 22
7.0.1xx 17.4 22 listopada 24maja 1
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 24maja 2
8.0.1xx 17.8 23 listopada Do ustalenia
8.0.2xx 17.93 24 lutego Do ustalenia
8.0.3xx 17.10 24 maja Do ustalenia

Uwaga

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

1.1xx .NET SDK feature bands (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 tej rozszerzonej pomocy technicznej, zobacz Obsługa kompilacji źródła.

Zespoły funkcji zestawu .NET SDK 2 .4xx są obsługiwane przez okres życia zgodnego środowiska uruchomieniowego jako autonomiczne instalacje.

Wersje 3 6.0.300, 7.0.200 i 8.0.200 wymagają nowszych wersji programu Visual Studio. Aby uzyskać więcej informacji, zobacz reguły pomocy technicznej.

Cykl życia programu Visual Studio 2019

Cykl życia programu Visual Studio 2022

Reguły określania wartości docelowych i obsługi

Począwszy od zestawu .NET SDK 7.0.100 i zestawu .NET SDK 6.0.300, wprowadzono zasady dotyczące wersji programu MSBuild i programu Visual Studio, w której zostanie uruchomiona dana wersja zestawu .NET SDK. Zasady są następujące:

  • 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ć migrację jednej czwartej narzędzi i infrastruktury (na przykład akcji i potoków).
SDK Wersja programu Visual Studio
zestaw SDK jest dostarczany z usługą		 Minimalna wersja programu Visual Studio Maksymalna liczba elementów TargetFramework w
minimalna wersja programu Visual Studio		 Maksymalna liczba elementów TargetFramework w dotnet
6.0.100 17,0 16.11 Net5.0 Net6.0
6.0.200 17.1 17,0 Net6.0 Net6.0
6.0.300 17,2 17,0 Net6.0 Net6.0
6.0.400 17,3 17,0 Net6.0 Net6.0
7.0.100 17.4 17,3 Net6.0 Net7.0
7.0.200 17.5 17.4 Net7.0 Net7.0
7.0.300 17,6 17.41 Net7.0 Net7.0
7.0.400 17,7 17.4 Net7.0 Net7.0
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

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.

1 Zmiana powodująca niezgodność w wersji 7.0.300 dla platformy Blazor i programowania Razor wymaga programu Visual Studio w wersji 17.6 lub nowszej. Aby uzyskać więcej informacji, zobacz dotnet/razor issue 8718.

Aby zapewnić spójne narzędzia, należy użyć dotnet build zamiast msbuild kompilować aplikację, gdy jest to możliwe.

Przechowywanie wersji zapoznawczej

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, która wersja zapoznawcza programu Visual Studio została przetestowana przed wydaniem.

Wersja zapoznawcza zestawu SDK Wersja programu Visual Studio
9.0.100 (wersja zapoznawcza 1) 17.10 (wersja zapoznawcza 1)
9.0.100 (wersja zapoznawcza 2) 17.10 (wersja zapoznawcza 2)
9.0.100 (wersja zapoznawcza 3) 17.10 (wersja zapoznawcza 3)

Odwołanie