.NET SDK, MSBuild ve Visual Studio sürüm oluşturma
.NET SDK'sının sürümü ve Visual Studio ile MSBuild arasındaki ilişki kafa karıştırıcı olabilir. Visual Studio ile MSBuild sürümleri, ancak .NET SDK'sında da bulunur. SDK, birlikte çalıştığı en düşük MSBuild ve Visual Studio sürümüne sahiptir ve bu en düşük sürümden daha eski bir Visual Studio sürümünde yüklenmez.
Sürüm oluşturma
.NET SDK sürümünün ilk bölümü, varsayılan olarak içerdiği, üzerinde çalıştığı ve hedeflediği .NET sürümüyle eşleşir. Özellik bandı 1'de başlar ve her üç aylık Visual Studio ikincil sürümü için artar. Yama sürümü, her ayın hizmet güncelleştirmeleriyle artar.
Örneğin, 7.0.203 sürümü .NET 7 ile birlikte sunulur, 7.0.100 ilk çıktığından bu yana ikinci ikincil Visual Studio sürümüdür ve 7.0.200 sürümünden bu yana üçüncü düzeltme ekidir.
Yaşam döngüsü
SDK'nın destek zaman çerçevesi genellikle içerdiği Visual Studio sürümüyle eşleşir.
Destek dışı .NET sürümlerini görmek için genişletin
| SDK sürümü | MSBuild/Visual Studio sürümü | Sevk tarihi | Yaşam döngüsü |
|---|---|---|---|
| 2.1.5xx | 15.9 | 18 Kas | Ağustos '21 |
| 2.1.8xx | 16.2 (VS Yok) | Temmuz '19 | Ağustos '21 |
| 3.1.1xx | 16.4 | Aralık '19 | Ekim 21 |
| 3.1.4xx | 16.7 | 20 Ağustos | Aralık '22 |
| 5.0.1xx | 16.8 | '20 Nov | 21 Mart |
| 5.0.2xx | 16.9 | Mart '21 | Mayıs '22 |
| 5.0.3xx | 16.10 | Mayıs '21 | Ağustos '21 |
| 5.0.4xx | 16.11 | Ağustos '21 | Mayıs '22 |
| 7.0.1xx | 17.4 | '22 Nov | Mayıs '24 |
| 7.0.2xx | 17,53 | 23 Şubat | Mayıs '23 |
| 7.0.3xx | 17.6 | Mayıs '23 | Mayıs '24 |
| 7.0.4xx | 17.7 | Ağustos '23 | Mayıs '24 |
Desteklenen .NET sürümleri
| SDK sürümü | MSBuild/Visual Studio sürümü | Sevk tarihi | Yaşam döngüsü |
|---|---|---|---|
| 6.0.1xx | 17.0 | '21 Nov | '24 Nov1 |
| 6.0.2xx | 17.1 | 22 Şubat | Mayıs '22 |
| 6.0.3xx | 17.23 | Mayıs '22 | Ekim 23 |
| 6.0.4xx | 17.3 | Ağustos '22 | '24 No'2 |
| 8.0.1xx | 17.8 | '23 No'lar | '25 Nov1 |
| 8.0.2xx | 17,93 | 24 Şubat | Mayıs '24 |
| 8.0.3xx | 17.10 | Mayıs '24 | Henüz belirlenmedi |
| 8.0.4xx | 17.11 | Ağustos '24 | '25 Nov2 |
| 9.0.1xx | 17.12 | '24 Nov | Mayıs '261 |
Not
net6.0 Hedefleme resmi olarak yalnızca Visual Studio 17.0+ ile desteklenir.
net7.0 Hedefleme resmi olarak yalnızca Visual Studio 17.4+ ile desteklenir.
net8.0 Hedefleme resmi olarak yalnızca Visual Studio 17.8+ ile desteklenir.
1 .1xx .NET SDK özellik bantları, ana .NET sürümlerinin yaşam döngüsü boyunca desteklenir. Genişletilmiş destek süresi boyunca destek yalnızca Linux için güvenlik düzeltmeleri ve en düşük yüksek öncelikli olmayan güvenlik düzeltmeleri ile sınırlıdır. Bu genişletilmiş desteğin mantığı hakkında daha fazla bilgi edinmek için bkz . Kaynak derleme desteği.
2 .4xx .NET SDK özellik bantları, tek başına yüklemeler olarak eşleşen çalışma zamanının ömrü boyunca desteklenir.
3 6.0.300, 7.0.200 ve 8.0.200 daha yeni Visual Studio sürümleri gerektirir. Daha fazla bilgi için destek kurallarına bakın.
Hedefleme ve destek kuralları
.NET SDK 7.0.100 ve .NET SDK 6.0.300'den başlayarak, MSBuild ve Visual Studio'nun belirli bir .NET SDK sürümünün hangi sürümlerinde çalıştırılacağına ilişkin bir ilke uygulanmıştır. İlke:
- Her yeni TargetFramework için yeni bir Visual Studio sürümü veya yeni
dotnetbir sürüm gerekir. - Yeni bir TargetFramework destekleyen Visual Studio'nun ilk sürümü, Roslyn API yüzeyi, MSBuild hedefleri, kaynak oluşturucular, çözümleyiciler vb. için bu SDK'nın özellik bantları için bir zemin haline gelir.
- Yeni bir TargetFramework'i destekleyen yeni bir .NET SDK'sının ilk sürümü, araç ve altyapının (örneğin eylemler ve işlem hatları) geçirilmesi için çeyrekte bir izin vermek üzere Visual Studio'nun önceki sürümüyle birlikte kullanılabilir.
| SDK | Visual Studio sürüm SDK ile birlikte |
En düşük Visual Studio sürümü | Içindeki En Fazla TargetFramework en düşük Visual Studio sürümü |
Içindeki En Fazla TargetFramework 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 |
Not
Tabloda, .NET SDK 7.0.100 ve .NET SDK 6.0.300'den başlayarak bu sürüm oluşturma kurallarının nasıl uygulanacağı gösterilir. Ayrıca, ilkenin daha önce gönderilen .NET SDK sürümlerine nasıl uygulanacağını, o zaman yerinde olsaydı nasıl uygulanacağını da gösterir. Ancak, SDK'nın önceki sürümleri için gereksinimler değişmez; diğer bir deyişle. .NET SDK 6.0.100 veya 6.0.200 için Visual Studio'nun gereken en düşük sürümü 16.10 olarak kalır.
1 Blazor ve Razor geliştirmesi için 7.0.300 sürümünde hataya neden olan bir değişiklik için Visual Studio sürüm 17.6 veya üzeri gerekir. Daha fazla bilgi için bkz . dotnet/razor sorunu 8718.
Tutarlı araçlar sağlamak için mümkün olduğunda uygulamanızı derlemek yerine msbuild kullanmanız dotnet build gerekir.
Önizleme sürümü oluşturma
.NET SDK'sının ana sürümleri genellikle Visual Studio önizleme sürümünü izleyen birkaç gün içinde yayımlar. Çalışan başka kombinasyonlar da olsa, yalnızca en son yayınlanan önizleme test edilir ve resmi olarak desteklenir. Aşağıdaki tabloda, her .NET önizleme sürümünün yayımlanmadan önce hangi Visual Studio sürümüyle test edildiği gösterilmektedir.
| SDK önizleme sürümü | Visual Studio sürüm |
|---|---|
| 9.0.100 Önizleme 1 | 17.10 Önizleme 1 |
| 9.0.100 Önizleme 2 | 17.10 Önizleme 2 |
| 9.0.100 Önizleme 3 | 17.10 Önizleme 3 |
| 9.0.100 Önizleme 4 | 17.11 Önizleme 1 |
| 9.0.100 Önizleme 5 | 17.11 Önizleme 2 |
| 9.0.100 Önizleme 6 | 17.11 Önizleme 3 |
| 9.0.100 Önizleme 7 | 17.12 Önizleme 1 |
| 9.0.100 RC 1 | 17.12 Önizleme 2 |
| 9.0.100 RC 2 | 17.12 Önizleme 3 |
