İngilizce dilinde oku

Aracılığıyla paylaş


.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. MSBuild, Visual Studio sürümleriyle birlikte gelir ve .NET SDK'sına da dahildir. 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 grubu 1'de başlar ve her üç aylık Visual Studio minör sürümünde 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.

Visual Studio yüklemesi .NET SDK'sının eşleşen tek bir kopyasını içerir. Visual Studio örneğinizi güncelleştirirseniz, .NET SDK özellik bantları ve ana bantlar da dahil olmak üzere Visual Studio tarafından yüklenen .NET SDK'sı da güncelleştirilir. Visual Studio tarafından yüklenenden farklı bir .NET SDK kullanmak istiyorsanız, bunu.NET indirme sayfasından yükleyebilirsiniz; Visual Studio yükseltmesi bu sürüme dokunmaz. Bundan sonra .NET SDK'sının bu kopyasını güncelleştirmek sizin sorumluluğundadır.

Not

.NET SDK'sı .NET'in alt düzey sürümlerini hedeflemeyi destekler, bu nedenle .NET SDK'nızı Visual Studio sürümünüzle birlikte her zaman güncelleştirmenizi öneririz.

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 Kasım '18 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 Kas '20 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
6.0.1xx 17.0 Kasım 2021 Kas 24
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 Kasım 2024
7.0.1xx 17.4 Kas '22 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ü
8.0.1xx 17.8 Kas '23 25 Kas '251
8.0.2xx 17.9 24 Şubat Mayıs '24
8.0.3xx 17.10 Mayıs '24 26 Ocak
8.0.4xx 17.11 Ağustos '24 25 Kas '252
9.0.1xx 17.12 Kasım '24 Mayıs '26
9.0.2xx 17.13 25 Şubat Mayıs '25
9.0.3xx 17.14 Mayıs '25 Mayıs '26

Not

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.

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

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

Hedefleme ve destek kuralları

Aşağıdaki ilke, .NET SDK'sının belirli bir sürümünün hangi MSBuild ve Visual Studio sürümlerinde çalışacağını belirler:

  • Her yeni TargetFramework, yeni bir Visual Studio sürümü veya yeni bir dotnet sürümü gerektirir.
  • 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'ü destekleyen yeni bir .NET SDK'nın ilk sürümü, araçlar ve altyapı (örneğin, eylemler ve işlem hatları) için geçiş sürecine bir çeyrek yıl ayırmak amacıyla Visual Studio'nun önceki sürümüyle uyumlu olarak kullanılmaya devam edilebilir.
SDK Visual Studio sürüm
SDK ile birlikte
En düşük Visual Studio sürümü İçindeki Azami TargetFramework
en düşük Visual Studio sürümü
Içindeki En Fazla TargetFramework 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

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 uygulandığı 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.

net8.0 Hedefleme resmi olarak yalnızca Visual Studio 17.8+ ile desteklenir.

net9.0 hedefleme, yalnızca Visual Studio 17.12+ işletim sisteminde resmi olarak desteklenir.

Tutarlı araçlar sağlamak için, mümkün olduğunda uygulamanızı derlemek için msbuild yerine dotnet build kullanmalısınız.

Ö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 RC 1 17.12 Önizleme 2
9.0.100 RC 2 17.12 Önizleme 3
9.0.100 GA 17.12 GA
10.0.100 Önizleme 1 17.14 Önizleme 1
10.0.100 Önizleme 2 17.14 Önizleme 2
10.0.100 Önizleme 3 17.14 Önizleme 3

Referans