Xcode gereksinimi

iOS, tvOS, Mac Catalyst veya macOS iş yükleri için .NET'in her sürümü Xcode'un belirli bir sürümünü gerektirir.

Sürüm notlarımızda her sürüm için tam Xcode sürümünü belirtiriz.

Uyarı

Xcode'un farklı bir sürümünü kullanan birkaç sınırlı senaryoda çalışabilir, ancak derleme hataları veya uyarıları olmasa bile bu desteklenmez.

Yeni iş yükleri

İş yükünün yeni bir sürümü farklı bir Xcode sürümü gerektirebilir. Bu genellikle Apple Xcode'un yeni bir sürümünü yayımlayışında gerçekleşir: kısa süre sonra Xcode'un yeni sürümünü destekleyen iş yüklerinin yeni sürümlerini yayınlarız. Böylece iş yüklerinin güncelleştirilmesi için yeni bir Xcode sürümü gerekir.

Bu genellikle aşağıdaki gibi bir derleme hatasıyla gösterilir:

Microsoft.iOS'un bu sürümü iOS 18.4 SDK'sını (Xcode 16.3 ile birlikte gönderilir) gerektirir. Xcode'un geçerli sürümü 16.2'dir. Xcode 16.3'ü yükleyin veya Microsoft.iOS'un farklı bir sürümünü kullanın. Daha fazla bilgi için bkz. https://aka.ms/xcode-requirement.

veya:

iOS için .NET'in bu sürümü (18.4.9288) Xcode 16.3 gerektirir. Xcode'un geçerli sürümü 16.2'dir. Xcode 16.3'ü yükleyin veya iOS için farklı bir .NET sürümü kullanın. Daha fazla bilgi için bkz. https://aka.ms/xcode-requirement.

En basit çözüm genellikle hata iletisinde bahseden Xcode sürümüne yükseltmektir.

Xcode'u yükseltmek zorunda kalmamak için ilgili iş yükünün eski bir sürümünü yüklemek de mümkündür.

Bazı durumlarda Xcode'un daha yeni sürümü macOS'un daha yeni bir ana sürümüne güncelleştirilmesini de gerektirir (bu genellikle her yıl Nisan ayında gerçekleşir). Yeni macOS sürümü geliştiricinin geçerli donanımında desteklenmiyorsa, tek seçenek iş yükünün eski bir sürümünü kullanmak (veya yeni donanım almak).

Yeni Xcode

Apple'ın yeni bir Xcode sürümü yayınlaması ile bu yeni Xcode sürümü için destek yayınlamamız arasında bir zaman penceresi vardır. Bazen macOS yüklü Xcode sürümünü otomatik olarak güncelleştirir ve bu da bu zaman çerçevesi sırasında sorunlara neden olabilir.

En basit çözüm, Xcode'un birden çok sürümünü yüklemek ve yüklü iş yükleri için Xcode gereksinimine karşılık gelen Xcode sürümünü seçmektir.

Uyarı

Bu senaryodan kaçınmak için macOS üzerinde App Store'da otomatik güncelleştirmeleri devre dışı bırakmanızı öneririz.

Xcode'un birden çok sürümünü yükleme

Xcode'un birden çok sürümünün aynı anda yüklenmesi mümkündür.

Bu, aşağıdaki adımlarla gerçekleştirilebilir:

• Apple Geliştirici İndirmeleri sitesine gidin.
• Apple kimliğiniz ile oturum açın.
• Xcode'un istenen sürümlerini arayın.
• .xip Dosya(lar)ını indir.
• Dosyaları çift tıklayarak ayıklayın.
• Xcode.app İndirilenler klasöründeki dosyasını daha açıklayıcı bir şekilde yeniden adlandırın (örneğinXcode_15.app).
• Ayıklanan *.app öğesini /Applications/ klasörüne taşıyın.

Uyarı

Xcode uygulaması en az bir kez açıldıktan sonra yeniden adlandırıldıysa garip sorunlar gördük, bu nedenle uygulamayı yalnızca indirdikten ve ayıkladıktan hemen sonra yeniden adlandırmanızı öneririz.

Xcode'un istenen sürümleri yüklendikten sonra, geliştiriciler Xcode'dan (menü Xcode - Ayarlar -> Konumlar ->> Komut Satırı Araçları) veya komut satırından xcode-select aracı kullanarak aralarında seçim yapabilir:

$ sudo xcode-select --switch /Applications/Xcode_15.app

Önemli

Dosya ~/Library/Preferences/Xamarin/Settings.plist , Xcode'un belirli bir sürümünü seçmek için de kullanılabilir ve bu dosya kullanılarak Xcode'da veya komut satırında xcode-selectbelirtilen ayara göre öncelikli olur. Karışıklığı önlemek için yalnızca bu dosyayı silmenizi öneririz.

İş yükünün eski sürümünü yükleme

İş yükünün belirli bir sürümü, iş yükü kümesi kullanılarak yüklenir.

tam iş yükü kümesi sürümü önceden tahmin edilemez, ancak her sürümde belirli bir iş yükü sürümü için iş yükü kümesi sürümünü belirtiriz: https://github.com/dotnet/macios/releases.

Xcode 16.3 desteğine sahip sürümümüze bir örnek aşağıda verilmiştir:

$ dotnet workload install ios --version 9.0.203

Sıkça Sorulan Sorular

Xcode'umu yükseltmek güvenli mi?

Xcode'un belirli bir sürümü için destek yayınlayıp yayınlamadığımızı sürümler listemize bakarak kontrol etmek mümkündür.

Xcode'un belirli bir sürümü için destek yayımladıysak, bu Xcode sürümüne yükseltmek güvenlidir (maui geliştiricileri de buna dahildir). Xcode'un bazı eski sürümlerinin desteklenen sürüm olduğunu belirten başka belgeler de olabilir; bu belgeler genellikle sürümlerimizin bir derece gerisinde kalır.

Tam tersi de geçerlidir: Belirli bir Xcode sürümü için destek yayınlanmadıysa , Xcode'un yükseltilmesi sorunlara neden olabilir. Xcode'un daha yeni bir sürümünü isteyen geliştiriciler için bu durumda en iyi çözüm , Xcode'un birden çok sürümünü yüklemektir.