1'de Takılan iOS Derleme Numarası: İşlemeyen Üç Çözüm ve İşleyen Bir Çözüm
Nesim Razon, bağımsız mobil uygulama geliştiricisi · 2026-11-17
App Store Connect'e her yükleme, öncekinden yüksek bir derleme numarası ister. Bulut hattımız, ne değiştirirsek değiştirelim, derleme numarası 1 olan bir paket üretmeye devam etti. Nedenini bulmak üç deneme sürdü. Bu yazı hikâyeyi ve çözümü anlatıyor; Mac'i olmadan üretilmiş bir Xcode projesinden iOS uygulaması derleyen herkes için.
Belirti
Yükleme adımı, paket sürümünün daha önce yüklenenden yüksek olması gerektiğini söyleyen bir hatayla başarısız oldu. Bir uygulamanın ilk yüklemesi her zaman çalışır; bu yüzden sorun ikinci derlemeden itibaren görünür. Mağaza tarafında derleme için gösterilen numara her seferinde 1'di.
İki numara söz konusudur. 1.0 gibi pazarlama sürümü insanların gördüğüdür. Derleme numarası olan CFBundleVersion yalnızca aynı pazarlama sürümünün her yüklemesiyle artmak zorundadır.
Birinci deneme: arşiv bayrakları
Derleme aracının arşiv komutuna ek bayrak geçirme yolu var; derleme numarasını oraya verdik. Hiçbir şey değişmedi. Bayrak kabul edildi, ama pakete giren değere hiçbir etkisi olmadı.
İkinci deneme: proje tanımını düzenlemek
Proje, küçük bir tanım dosyasından XcodeGen ile üretilir ve bu dosyada derleme numarası için bir alan vardır. Projeyi üretmeden önce onu CI çalıştırmasının numarasıyla sed ile yeniden yazdık. Üretilen proje yeni değeri gerçekten içeriyordu, ama paket hâlâ 1 diyordu.
Nedeni, XcodeGen'in ürettiği Info.plist'in derleme numarasını o ayardan almamasıdır. Kendi değeri vardır ve paketlenen odur.
Üçüncü deneme ve daha iyi bir fikir
Aynı fikrin üçüncü bir çeşidi de aynı şekilde başarısız oldu. Değiştirilecek şey derleme ayarları değil, gerçekten okunan dosyaydı: Info.plist.
Çözüm: değeri Info.plist'e yazmak
Proje üretildikten sonra tek bir komut değeri doğrudan ayarlar: PlistBuddy ile Set :CFBundleVersion ve numara. Numara, 1000 artı CI hizmetinin derleme sayacıdır; böylece hep büyür ve önceki yüklemelerle çakışmaz.
Çözümün ikinci yarısı bunu kanıtlamaktır. Yüklemeden önce betik, bitmiş paketin içinden CFBundleVersion değerini geri okur ve günlüğe yazar. Değer yanlışsa bunu başarısız bir yüklemeden sonra değil, bir dakika içinde görürsün.
Akılda kalacaklar
- Derleme numarasını, ona ulaşmayabilecek bir ayara değil, paketlenen dosyaya yaz.
- Değeri girdinden değil, son paketten yazdır.
- Yalnızca artan bir sayaç kullan; örneğin sabit bir ofsetli CI derleme numarası.
- Yükleme paket sürümünün daha yüksek olması gerektiğini söylüyorsa önce pakete bak.
Sık sorulan sorular
Sürüm ile derleme numarası arasındaki fark nedir?
Sürüm, kullanıcıların gördüğü numaradır, örneğin 1.0. Derleme numarasının yalnızca o sürümün her yüklemesinde artması gerekir.
Proje tanımını düzenlemek neden işe yaramadı?
XcodeGen'in ürettiği Info.plist derleme numarasını o ayardan almadı; paket kendi değerini korudu.
Paketlenen değer nasıl kontrol edilir?
Bitmiş paketin içindeki Info.plist'ten CFBundleVersion okunur ve yüklemeden önce derleme günlüğüne yazdırılır.
Diğer yazılar
- iOS'ta SIM Ülkesi Okunamayınca Analytics Bölge Kapısı
- App Store Bağlantım Neden 404 Verdi ve Sayfa 2018 Ekran Görüntülerini Gösterdi
- App Store İnceleme Kuralı 2.1 "Bilgi Gerekli": Ne Gönderdim
- Telefonsuz App Store Ekran Görüntüleri: Robolectric, Sahte Görsel Yükleyici ve Başsız Tarayıcı
- İki Mağaza İçin Tek QR Kodu: Küçük Bir Yönlendirme Sayfası
- Davranışı Değiştirmeden Kotlin Multiplatform'a Geçiş: Eski Kodu Test Kâhini Olarak Tutmak