← Nesim Apps

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

#Geliştirici notları#iOS

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

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