Wersje zestawów .NET SDK, MSBuild i Visual Studio
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.
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 zestawu .NET SDK niż zainstalowany przez program Visual Studio, możesz go zainstalować ze strony pobierania platformy .NET, a aktualizacja programu Visual Studio nie wpłynie na tę wersję. 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ć wersje platformy .NET poza obsługą
| 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 | 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 | 25listopada 1 |
| 8.0.2xx | 17.93 | 24 lutego | 24maja 3 |
| 8.0.3xx | 17.10 | 24 maja | Do ustalenia |
| 8.0.4xx | 17.11 | 24 sierpnia | 25listopada 22 |
| 9.0.1xx | 17.12 | 24 listopada | 26maja 1 |
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.
Wersja 3 8.0.200 wymaga nowszej wersji programu Visual Studio. Aby uzyskać więcej informacji, zobacz reguły pomocy technicznej.
Reguły określania wartości docelowych i obsługi
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
dotnetwersji. - 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.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 |
| 8.0.400 | 17.11 | 17.8 | Net8.0 | Net8.0 |
| 9.0.100 | 17.12 | 17.11 | Net8.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.
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) |
| 9.0.100 (wersja zapoznawcza 4) | 17.11 (wersja zapoznawcza 1) |
| 9.0.100 (wersja zapoznawcza 5) | 17.11 (wersja zapoznawcza 2) |
| 9.0.100 (wersja zapoznawcza 6) | 17.11 (wersja zapoznawcza 3) |
| 9.0.100 (wersja zapoznawcza 7) | 17.12 (wersja zapoznawcza 1) |
| 9.0.100 RC 1 | 17.12 (wersja zapoznawcza 2) |
| 9.0.100 RC 2 | 17.12 (wersja zapoznawcza 3) |
| 9.0.100 ogólna dostępność | 17.12 ogólna dostępność |
