Penerapan versi .NET SDK, MSBuild, dan Visual Studio
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.
Penerapan versi
Bagian pertama dari versi .NET SDK cocok dengan versi .NET yang disertakannya, dijalankan, dan ditargetkan secara default. Pita fitur dimulai pada 1 dan meningkat untuk setiap rilis minor Visual Studio triwulanan. Kenaikan versi patch 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.
Siklus Hidup
Jangka waktu dukungan untuk SDK biasanya cocok dengan versi Visual Studio yang disertakannya.
| 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 | Nov '241 |
| 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 | Nov '242 |
| 7.0.1xx | 17.4 | Nov '22 | Mei '241 |
| 7.0.2xx | 17,53 | Feb '23 | Mei '23 |
| 7.0.3xx | 17.6 | Mei '23 | Mei '24 |
| 7.0.4xx | 17.7 | Agustus '23 | Mei '242 |
| 8.0.1xx | 17.8 | Nov '23 | TBD |
| 8.0.2xx | 17,93 | Feb '24 | TBD |
| 8.0.3xx | 17.10 | Mei '24 | TBD |
Catatan
Penargetan net6.0 secara resmi hanya didukung di Visual Studio 17.0+.
Penargetan net7.0 secara resmi hanya didukung di Visual Studio 17.4+.
Penargetan net8.0 secara resmi hanya didukung di Visual Studio 17.8+.
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 build sumber.
2 band fitur .4xx .NET SDK didukung untuk masa pakai runtime yang cocok sebagai penginstalan mandiri.
3 6.0.300, 7.0.200, dan 8.0.200 memerlukan versi Visual Studio yang lebih baru. Untuk informasi selengkapnya, lihat aturan dukungan.
Aturan penargetan dan dukungan
Dimulai dengan .NET SDK 7.0.100 dan .NET SDK 6.0.300, kebijakan telah diterapkan mengenai versi MSBuild dan Visual Studio versi tertentu dari .NET SDK yang akan berjalan. Kebijakannya adalah:
- Setiap TargetFramework baru memerlukan versi Visual Studio baru atau versi baru
dotnet. - Versi pertama Visual Studio yang mendukung TargetFramework baru menjadi lantai untuk pita fitur SDK tersebut untuk permukaan 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 memungkinkan seperempat alat dan infrastruktur (misalnya, tindakan dan alur) untuk bermigrasi.
| SDK | Versi Visual Studio SDK dikirim dengan |
Versi Visual Studio minimum | TargetFramework maks di versi Visual Studio minimum |
TargetFramework maks di 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 |
Catatan
Tabel ini menggambarkan bagaimana aturan penerapan versi ini akan diterapkan ke depannya, 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.
1 Perubahan yang melanggar di 7.0.300 untuk pengembangan Blazor dan Razor memerlukan Visual Studio versi 17.6 atau yang lebih baru. Untuk informasi selengkapnya, lihat masalah dotnet/razor 8718.
Untuk memastikan alat yang konsisten, Anda harus menggunakan dotnet build daripada msbuild 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 Pratinjau 1 | 17.10 Pratinjau 1 |
| 9.0.100 Pratinjau 2 | 17.10 Pratinjau 2 |
| 9.0.100 Pratinjau 3 | 17.10 Pratinjau 3 |
Referensi
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk