iOS Derleme sorunlarını giderme
Önemli
Visual Studio App Center 31 Mart 2025'te kullanımdan kaldırılıyor. Tamamen kullanımdan kaldırılana kadar Visual Studio App Center'ı kullanmaya devam edebilirsiniz ancak geçiş yapmayı düşünebileceğiniz birkaç önerilen alternatif vardır.
Destek zaman çizelgeleri ve alternatifleri hakkında daha fazla bilgi edinin.
Xcode düzeni bulunamadı
veya oluşturmak xcworkspace
xcproject
için paylaşılan bir Xcode şeması gerekir. Xcode düzenleri yerel olarak kaydedilir, böylece Xcode bunlara erişebilir. Varsayılan olarak şemalar başkalarıyla paylaşılamaz veya kaynak denetimine dahil değildir.
Xcode'da bir düzeni paylaşmak için aşağıdaki adımları kullanın:
- Ürün > Şeması Şemalarını > yönet'i seçin.
- xcproject/xcworkspace düzeninizi paylaşılan olarak ayarlayın.
- Şemanın kapsayıcısı, oluşturmak istediğiniz Xcode projesine veya çalışma alanına ayarlanmalıdır.
.xcscheme
Dosyayı kaynak denetimine ekleyin ve App Center'ın erişebilmesi için uzak deponuza gönderin.
Uyarı
Klasörünüzün dosyanızda xcshareddata/xcschemes/
.gitignore
olmadığından emin olun. Dosyaların Xcode tarafından depolandığı yerdir .xcscheme
. App Center, projeyi düzgün bir şekilde oluşturmak için bu dosyalara dayanır. Yalnızca öğesini .xcscheme
farklı bir klasöre dışarı aktarmak işe yaramaz.
iOS derlemelerim "clang: error: linker komutu çıkış kodu 1 ile başarısız oldu" hatasıyla başarısız oluyor
Hataya çalışma alanı yerine xcodeproj ile App Center derlemesi neden olmuş olabilir. Projenize CocoaPods eklerken App Center'da derleme yaparken çalışma alanını kullanmaya geçin.
Gösterge: Derleme günlüğünüzde şu satırı arayın:
ld: library not found for -lPods-GarageController
clang: error: linker command failed with exit code 1 (use -v to see invocation)
** ARCHIVE FAILED **
Bu hatayı düzeltmek için projenizin Derleme yapılandırmasını açın ve Kaydet'e tıklayın. App Center, gelecekteki derlemeler için çalışma alanını otomatik olarak doğru seçer.
iOS imzalama sorunları açıklandı
Not
Ascii olmayan karakterler kullanan imzalama kimlikleri Derleme'de desteklenmez.
Sağlama profilleri ve sertifikalarıyla ilgilenmek zorlu bir işlem olabilir. Aşağıdaki ipuçları iOS uygulamalarınızı başarıyla imzalamanıza yardımcı olacaktır:
projenize imza değişiklikleri gönderdikten sonra derleme yapılandırmasını App Center'a kaydedin. App Center'da, herhangi bir dalın derleme yapılandırması Xcode projenizin iki değerini depolar:
CODE_SIGN_STYLE
veDEVELOPMENT_TEAM
(klasörünüzdeki.xcodeproj
dosyadaproject.pbxproj
ayarlanır). El ile ve otomatik imzalama arasında geçiş yaptığınızda veya geliştirme ekibini değiştirdiğinizde, değişiklikleri gönderdikten sonra derleme yapılandırmasını App Center'a kaydettiğinizden emin olun. Gönderimden sonra kaydetmezseniz derlemeniz bir imzalama hatasıyla başarısız olabilir.Otomatik imzalama kullanırken doğru sağlama profilini sürükleyip bırakın. Xcode'da, İmzalama'nın altındaki hedefinizin Genel sekmesinde Xcode Yönetilen Profili'nin yanındaki bilgi simgesine tıklayın. Ardından profil bilgilerini içeren bir açılır pencere görürsünüz. Sol üstteki PROV simgesine tıklayıp istenen konuma (aşağıda gösterildiği gibi) sürükleyin.
El ile ve otomatik imzalama kullanırken App Center'ın şu anda desteklenen seçeneklerini not edin. App Center, el ile iOS uygulama imzalamayı tamamen desteklediğinden, her tür profili veya sertifikayı kullanabilirsiniz. App Center'a yüklediğiniz sağlama profilinin ve sertifikanın projenizde belirttiğiniz değerle eşleşip eşleşmedığını doğrulayın. Xcode'da İmzalama özelliğini Otomatik Olarak Yönet'i etkinleştirdiyseniz App Center, geliştirici sertifikaları ve profilleriyle (dağıtımla değil) uygulama imzalamayı destekler. App Center'a yüklerken Xcode'dan otomatik olarak oluşturulan sağlama profilini kullanmanız gerekir.
Hala sorun mu yaşıyorsunuz?
Sorun gidermek ve derlemeye kaydolmayı ve çalıştırmayı sağlamak için aşağıdaki adımları öneririz:
- Xcode projenizde el ile imzalamayı ayarlayın ve yerel olarak çalıştığından emin olun.
- Bu doğrulandıktan sonra değişiklikleri işleyin ve deponuza gönderin.
- Xcode hedefinde seçilen sağlama profilini ve sertifikayı hazırlayın ve App Center derleme yapılandırmasına yükleyin.
- En önemlisi: Yeni sertifikayı ve profili derleme yapılandırmasına kaydetmeden önce projenizin en son durumunu yüklediğinizden emin olun.
.ipa dosyam nerede?
Xcodebuild, xcrun'un aksine, derleme imzalanmadıysa dosya .ipa
oluşturmaya izin vermez. İmzasız derlemeler bunun yerine bir .xcarchive
oluşturur. İmzasız bir derlemenin yapıtlarıyla bir .ipa
dosya oluşturmak isterseniz, bunu yapmak için dosyasını kullanabilirsiniz .xcarchive
.
dışarı dışarı aktarma
Xcode kullanan iOS uygulamam Geçersiz bit kodu sürümü hatasıyla başarısız oluyor
Derlemeleriniz ile error: Invalid bitcode version (Producer: '802.0.38.0_0' Reader: '800.0.42.1_0')
başarısız olursa, projenizden daha yeni bir Xcode sürümü tarafından oluşturulmuş bir kitaplık veya pod kullanıyorsunuz demektir. Projenizi güncelleştirebilir ve Xcode'un daha yeni bir sürümünü kullanmak için App Center'da yapılandırma oluşturabilir veya sorunlu kitaplığın eşleşen bir Xcode sürümüyle derlenen alternatif bir sürümüne geçebilirsiniz.
iOS uygulamam test çalıştıramıyor
Testlerin başarısız olmasının yaygın nedenlerinden biri, bağlayıcı komutlarının aşağıdakine benzer bir hatayla sonuçlandığı yerdir:
ld: directory not found for option iPhoneSimulator10.3.sdk/Developer/Library/Frameworks
❌ ld: embedded dylibs/frameworks are only supported on iOS 8.0 and later (@rpath/XCTest.framework/XCTest) for architecture x86_64
❌ clang: error: linker command failed with exit code 1 (use -v to see invocation)
Bu hatanın olası nedeni , Apple Mach-O Linker'ın bağlama türünün statik kitaplığa ayarlanmamasıdır. Uygulamanızı başarıyla derlemek ve test etmek için test hedefinizdekiApple Mach-O Linker bağlantı türünün statik kitaplığa ayarlandığından emin olun.
Xcode 9'da CocoaPods kullanan iOS derlemelerim başarısız olmaya devam ediyor, ne yapmalıyım?
Bunun nedeni Podlar projenizdeki imzalama yapılandırmasının Ana projenizdeki yapılandırmadan farklı olması olabilir. Podlarınız deponuzda iade edildi mi? Bu durumda, Pods projeniz Ana projenizle aynı imzalama yöntemini kullanmalıdır.
Podlarınız iade edilmediyse farklı sorunlar olabilir. Derleme öncesi betiklerle ilgili bu GitHub Sorunu'nda kullanabileceğiniz birkaç geçici çözüm vardır.
Projemi Xcode 10 beta sürümüne yükselttikten sonra uygulamam hedefler arasındaki bağımlılıklarda Döngü hatasıyla derlenemiyor
Xcode 10'un yeni derleme sistemi, derlemenizdeki bağımlılık döngülerini algılar ve varsa derlemenizde başarısız olur.
Derlemeyi düzeltme hakkında daha fazla bilgi için Apple'ın yaygın bağımlılık döngüsü türlerini çözme belgelerine bakın.