Bagikan melalui

Pengaturan versi .NET SDK, MSBuild, dan Visual Studio

  • Artikel

Penerapan versi .NET SDK dan hubungannya dengan Visual Studio dan MSBuild dapat membingungkan. Versi MSBuild dengan Visual Studio, tetapi juga disertakan dalam .NET SDK. SDK memiliki versi minimum MSBuild dan Visual Studio yang berfungsi dengannya, dan tidak akan dimuat dalam versi Visual Studio yang lebih lama dari versi minimum tersebut.

Pengelolaan versi

Bagian pertama dari versi .NET SDK cocok dengan versi .NET yang disertakannya, dijalankan, dan ditargetkan secara default. Pita fitur dimulai dari 1 dan meningkat untuk setiap rilis kecil Visual Studio per kuartal. Versi patch meningkat dengan pembaruan layanan setiap bulan.

Misalnya, versi 7.0.203 dikirim dengan .NET 7, adalah rilis Visual Studio minor kedua sejak 7.0.100 pertama kali keluar, dan merupakan patch ketiga sejak 7.0.200 dirilis.

Penginstalan Visual Studio menyertakan satu salinan yang cocok dari .NET SDK. Jika Anda memperbarui instans Visual Studio Anda, .NET SDK yang diinstal oleh Visual Studio juga akan diperbarui, termasuk di dalam kelompok fitur dan versi utama .NET SDK. Jika Anda ingin menggunakan .NET SDK yang berbeda dari yang diinstal oleh Visual Studio, Anda dapat menginstalnya dari halaman unduhan .NET, dan peningkatan Visual Studio tidak akan menyentuh versi tersebut. Anda bertanggung jawab untuk memperbarui salinan .NET SDK tersebut sejak saat itu.

Catatan

.NET SDK mendukung penargetan versi .NET tingkat bawah, jadi sebaiknya selalu perbarui .NET SDK Anda bersama dengan versi Visual Studio Anda.

Siklus Hidup

Jangka waktu dukungan untuk SDK biasanya cocok dengan versi Visual Studio yang disertakannya.

Perluas untuk melihat versi .NET yang tidak didukung
Versi SDK Versi MSBuild/Visual Studio Tanggal pengiriman Siklus Hidup
2.1.5xx 15,9 Nov '18 Agu '21
2.1.8xx 16.2 (Tidak ada VS) Juli '19 Agu '21
3.1.1xx 16.4 Des '19 Okt '21
3.1.4xx 16.7 Agu '20 Des '22
5.0.1xx 16.8 Nov '20 Mar '21
5.0.2xx 16.9 Maret '21 Mei '22
5.0.3xx 16.10 Mei '21 Agu '21
5.0.4xx 16,11 Agu '21 Mei '22
6.0.1xx 17,0 Nov '21 November '24
6.0.2xx 17,1 Feb '22 Mei '22
6.0.3xx 17.23 Mei '22 Okt '23
6.0.4xx 17.3 Agu '22 November '24
7.0.1xx 17.4 Novem '22 Mei '24
7.0.2xx 17,53 Februari '23 Mei '23
7.0.3xx 17.6 Mei '23 Mei '24
7.0.4xx 17.7 Agustus '23 Mei '24

Versi .NET yang didukung

Versi SDK Versi MSBuild/Visual Studio Tanggal pengiriman Siklus Hidup
8.0.1xx 17.8 Nov '23 Nov '251
8.0.2xx 17.9 Februari '24 Mei '24
8.0.3xx 17.10 Mei '24 Jan '26
8.0.4xx 17.11 Agustus '24 Nov '252
9.0.1xx 17.12 Nov '24 Mei '26
9.0.2xx 17.13 Februari 2025 Mei '25
9.0.3xx 17.14 Mei '25 Mei '26

Catatan

1 band fitur .1xx .NET SDK didukung sepanjang siklus hidup versi .NET utama. Selama periode dukungan yang diperpanjang, dukungan terbatas pada perbaikan keamanan dan perbaikan non-keamanan prioritas tinggi minimal untuk Linux saja. Untuk mempelajari selengkapnya tentang alasan dukungan yang diperluas ini, lihat Dukungan pembangunan sumber.

2 kelompok fitur .4xx .NET SDK didukung selama masa pakai runtime yang sesuai sebagai penginstalan mandiri.

Siklus Hidup Visual Studio 2019

Siklus Hidup Visual Studio 2022

Aturan penargetan dan dukungan

Kebijakan berikut menentukan versi MSBuild dan Visual Studio versi tertentu dari .NET SDK yang akan berjalan di:

  • Setiap TargetFramework baru memerlukan versi Visual Studio baru atau versi baru dotnet .
  • Versi pertama Visual Studio yang mendukung TargetFramework baru menjadi dasar untuk kelompok fitur SDK tersebut, termasuk lapisan API Roslyn, target MSBuild, generator sumber, penganalisis, dan sebagainya.
  • Versi pertama dari .NET SDK baru yang mendukung TargetFramework baru masih dapat digunakan dengan versi Visual Studio sebelumnya untuk memberikan waktu satu kuartal bagi alat dan infrastruktur (misalnya, tindakan dan pipeline) untuk bermigrasi.
SDK Versi Visual Studio
SDK dilengkapi dengan		 Versi Visual Studio minimum TargetFramework maksimal di
minimum versi Visual Studio		 TargetFramework maksimum di 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

Catatan

Tabel menggambarkan bagaimana aturan penerapan versi ini diterapkan, dimulai dengan .NET SDK 7.0.100 dan .NET SDK 6.0.300. Ini juga menggambarkan bagaimana kebijakan akan diterapkan ke versi yang dikirim sebelumnya dari .NET SDK, jika sudah diberlakukan saat itu. Namun, persyaratan untuk versi SDK sebelumnya tidak berubah—yaitu, versi minimum visual Studio yang diperlukan untuk .NET SDK 6.0.100 atau 6.0.200 tetap 16.10.

Penargetan net8.0 secara resmi hanya didukung di Visual Studio 17.8+.

Menargetkan net9.0 secara resmi hanya didukung di Visual Studio 17.12+.

Untuk memastikan pemakaian alat yang konsisten, Anda harus menggunakan dotnet build daripada msbuild untuk membangun aplikasi Anda jika memungkinkan.

Penerapan versi pratinjau

Versi utama .NET SDK biasanya dirilis dalam beberapa hari setelah versi pratinjau Visual Studio. Meskipun mungkin ada kombinasi lain yang berfungsi, hanya pratinjau terbaru yang dirilis yang diuji dan didukung secara resmi. Tabel berikut menunjukkan versi Visual Studio mana yang setiap versi pratinjau .NET diuji sebelum rilis.

Versi pratinjau SDK Versi Visual Studio
9.0.100 RC 1 17.12 Pratinjau 2
9.0.100 RC 2 17.12 Pratinjau 3
9.0.100 GA 17.12 GA
10.0.100 Pratinjau 1 17.14 Pratinjau 1
10.0.100 Pratinjau 2 17.14 Pratinjau 2
10.0.100 Pratinjau 3 17.14 Pratinjau 3

Referensi