Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
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
Nomor versi .NET SDK menggunakan format major.minor.patch, di mana:
-
major.minorsesuai dengan versi .NET yang disertakan oleh SDK, dijalankan, dan ditargetkan secara default. - Ratusan digit
patchmengidentifikasi pita fitur—misalnya,1xx, ,2xx3xx, atau4xx. Tingkat fitur dimulai pada 1 dan meningkat pada setiap rilis .NET SDK triwulanan. - Dua digit terakhir
patchadalah versi patch, yang meningkat dengan pembaruan layanan setiap bulan.
Misalnya, versi 7.0.203 dilengkapi dengan .NET 7, merupakan rilis fitur triwulan kedua sejak 7.0.100 pertama kali keluar, dan pembaruan 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.
Dimulai dengan Visual Studio 18.0, Visual Studio mengirimkan versi minor bulanan, sementara .NET SDK terus dikirim setiap triwulanan. Rilis Visual Studio yang terjadi di antara rilis triwulanan .NET SDK hanya menyertakan versi patch dari .NET SDK terbaru.
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 | 22 Des |
| 5.0.1xx | 16.8 | November '20 | Maret '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 | November '21 | November '24 |
| 6.0.2xx | 17,1 | Februari '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 | November '23 | Nov '261 |
| 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 '262 |
| 9.0.1xx | 17.12 | November '24 | Mei '26 |
| 9.0.2xx | 17.13 | Februari 2025 | Mei '25 |
| 9.0.3xx | 17.14 | Mei '25 | Nov '262 |
| 10.0.1xx | 18,0 | Nov '25 | Nov '28 |
| 10.0.2xx | 18.4 | Mar '26 | Mei '26 |
Catatan
1 Jalur fitur .1xx di .NET SDK didukung sepanjang siklus hidup dari 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 Kanal fitur akhir .NET SDK dari versi utama didukung selama masa dukungan runtime yang sesuai sebagai penginstalan mandiri.
Siklus hidup Visual Studio 2026
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 |
| 10.0.100 | 18,0 | 17.14 | Net9.0 | Net10.0 |
| 10.0.200 | 18.4 | 18,0 | Net10.0 | Net10.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+.
Penargetan net10.0 secara resmi hanya didukung di Visual Studio 18.0+.
Untuk memastikan pemakaian alat yang konsisten, Anda harus menggunakan dotnet build daripada msbuild untuk membangun aplikasi Anda jika memungkinkan.
Matriks dukungan SDK dan Visual Studio
Meskipun sebagian besar pengembang menggunakan .NET SDK yang dibundel dengan versi Visual Studio mereka, beberapa konfigurasi melibatkan versi SDK dan Visual Studio yang tidak cocok. Tidak ada jaminan setiap versi Visual Studio berfungsi dengan setiap .NET SDK yang didukung. Konfigurasi yang paling umum diuji untuk memastikan upaya kompatibilitas terbaik.
Kompatibilitas ke belakang dan ke depan
-
Konfigurasi utama yang didukung: Gunakan versi SDK yang dibundel dengan penginstalan Visual Studio Anda
- Visual Studio 17.14 dan .NET 9.0.3xx
- Visual Studio 18.0 dan .NET 10.0.1xx
- Kompatibilitas mundur: Menggunakan rentang fitur terbaru dari SDK versi sebelumnya (misalnya, 8.0.4xx di Visual Studio 17.14) didukung dengan kompatibilitas terbaik yang diusahakan. Tim .NET menentukan kapan harus melakukan backport perbaikan berdasarkan risiko dan dampak pelanggan. Meskipun SDK yang lebih lama dari yang terbaru dari band sebelumnya mungkin berfungsi, tim .NET tidak mengujinya atau berupaya memastikan kompatibilitas apa pun.
- Kompatibilitas ke depan: Menggunakan SDK yang lebih baru (misalnya, .NET 10 SDK di Visual Studio 17.14) diperbolehkan tanpa hambatan, tetapi menargetkan runtime yang lebih baru dalam versi Visual Studio yang lebih lama tidak didukung dan menghasilkan peringatan saat build.
Bimbingan
Gunakan SDK yang disertakan dengan instans Visual Studio Anda (atau terbaru tersedia di CI atau Visual Studio Code), karena versi tersebut selalu memiliki fitur terbaru, termasuk pembaruan keamanan.
Dukungan penargetan tingkat bawah
.NET SDK mempertahankan dukungan penargetan untuk versi .NET yang tidak didukung. SDK 10.0.100 dapat membangun aplikasi yang menargetkan net9.0 hingga ke netcoreapp1.0.
Prinsip panduan
- Dukungan yang ada dipertahankan: Menargetkan dukungan untuk versi yang tidak lagi didukung tetap berada di SDK tanpa penghapusan secara aktif. Pelanggan yang memperbarui versi SDK atau Visual Studio mereka seharusnya tidak mengalami kerusakan pada hasil kompilasi hanya dengan menargetkan versi .NET yang lebih lama.
- Fitur baru: Fitur baru SDK tidak diperlukan untuk mendukung versi yang tidak didukung, kecuali jika mengecualikan dukungan tersebut dapat menimbulkan biaya atau risiko yang besar.
- Perbaikan kerusakan: Jika masalah muncul saat menargetkan versi di luar dukungan, perbaikan diterapkan berdasarkan biaya perbaikan. Tujuannya adalah untuk mencegah pelanggan mengalami gangguan saat peningkatan.
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 telah diuji dan didukung secara resmi. Tabel berikut menunjukkan versi Visual Studio yang digunakan untuk menguji setiap versi pratinjau .NET sebelum dirilis.
| Versi pratinjau SDK | Versi Visual Studio |
|---|---|
| 10.0.100 RC 1 | 18.0.0 Insider (11010.61) |
| 10.0.100 RC 2 | 18.0.0 Insider (11111.16) |
| 11.0.100 Pratinjau 1 | 18.4.0 Insider |
| 11.0.100 Pratinjau 2 | 18.5.0 Insider |
Referensi
- Gambaran umum tentang bagaimana .NET diberi versi
- Kebijakan dukungan resmi .NET dan .NET Core
- Microsoft .NET dan .NET Core
- Unduhan .NET (Windows, Linux, dan macOS)
- Siklus Hidup dan Layanan Produk Visual Studio 2019
Berkolaborasi dengan kami di GitHub
Sumber untuk konten ini dapat ditemukan di GitHub, yang juga dapat Anda gunakan untuk membuat dan meninjau masalah dan menarik permintaan. Untuk informasi selengkapnya, lihat panduan kontributor kami.
