.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.

Visual Studio 2019 Yaşam Döngüsü

Visual Studio 2022 Yaşam Döngüsü

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 dotnet bir 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

Başvuru