Bulutta iOS İmzalama: Her Derlemede Yeni Sertifika ve Kalıcı Çözüm
Nesim Razon, bağımsız mobil uygulama geliştiricisi · 2026-11-18
iPhone derlemelerimiz bulutta çalışıyor, çünkü Windows'ta geliştiriyoruz. İlk çalışan hat uygulamayı otomatik imzalıyordu ve işe yaradı, ta ki yaramayana kadar. Her çalıştırma geliştirici hesabında sessizce bir sertifika daha üretti ve bir gün derlemeler eksik özel anahtar hatasıyla düşmeye başladı. Bu yazı olanı ve onun yerine koyduğumuz düzeni anlatıyor.
Belirti: biriken sertifikalar
Arşiv adımında bulut yönetimli imzalamayla derleme, ihtiyacı olanı App Store Connect API'sinden ister. Bizde bu, her derlemede Created via API notlu yeni bir Apple Development sertifikası demekti. Hızla birikirler. Hesap, bir türde en fazla kaç sertifika tutabileceğini sınırlar; biz bu sınıra yaklaşık on birde vardık.
Sonra ikinci hata çıktı: arşiv adımı özel anahtarın kurulu olmadığından yakındı. Makinede eşleşen özel anahtarı olmayan sertifika işe yaramaz ve yeni bir derleme makinesinde, önceki bir makinenin ürettiği sertifikanın anahtarı hiçbir zaman bulunmaz.
Sonradan patlayan kestirme
Akla gelen fikir, imzasız arşivlemek ve dışa aktarırken imzalamaktır. Arşiv başarılı olur, dışa aktarma bir paket bile üretir ve yükleme App Store Connect tarafından 90035 numaralı geçersiz imza hatasıyla reddedilir. Sebebi şu: arşiv kod imzalama kapalıyken derlendiğinde uygulamanın içine gömülü framework'ler imzasız kalır. Yalnızca dıştaki uygulamayı imzalamak yetmez, gömülü her framework'ün kendi imzası olmalıdır.
Yani burada kestirme yok. Arşiv, özel anahtarı derleme makinesinde bulunan bir sertifikayla düzgün imzalanmalıdır.
Kalıcı düzen: sakladığın tek dağıtım anahtarı
Çözüm, her derlemenin kendi kimliğini üretmesine izin vermemektir. Tek bir dağıtım sertifikası oluşturur, özel anahtarını bulut hizmetinin dışında güvenle saklar ve derlemeye her seferinde aynı anahtarı verirsin. Derleme API'den sertifikayı ve provizyon profilini ister; API de yeni bir tane üretmek yerine o anahtara ait mevcut sertifikayı döndürür.
Bizim hattımızda özel anahtar, App Store Connect API anahtarı ve iki tanımlayıcısıyla birlikte, gizli bir değişken grubunda base64 olarak durur. Derleme sırasında dosyaya çözülür ve openssl ile denetlenir; böylece bozuk bir gizli değer uzun bir derlemenin sonunda değil, ilk dakikada anlaşılır.
Adımlar, sırasıyla
- API anahtar dosyasını temiz bir PEM olarak yeniden kur: gizli değerler çoğu zaman satır sonları bozulmuş gelir; başlık ve alt bilgiyi, boşlukları ve düz ters eğik çizgi-n yazılarını at, gövdeyi 64 karakterlik satırlara böl ve openssl ile doğrula.
- Derleme numarasını projeye ve Info.plist'e yaz, yüklemeden önce bitmiş paketten tekrar yazdır.
- Dağıtım özel anahtarını gizli değerden çöz ve openssl ile denetle.
- Derleme makinesinde anahtarlığı başlat.
- Paket kimliği için imzalama dosyalarını create bayrağıyla, iOS App Store türünde getir. Araç, anahtarına ait sertifikayı yeniden kullanır.
- Sertifikaları anahtarlığa ekle, ardından provizyon profillerini Xcode projesine uygula.
- Proje ve şemadan imzalı ipa üret, sonra TestFlight'a yayınla.
Dakika kazanmak
Ücretsiz planda macOS derleme dakikaları sınırlıdır ve başarısız her imzalama çalıştırması bir kısmını yakar. İki alışkanlık yardım eder. Birincisi, imzalama iş akışını yalnızca elle başlatmak; böylece bir gönderim dakika harcamaz. İkincisi, imzasız derleyen ve Apple ile hiç konuşmayan ayrı bir simülatör iş akışı tutmak. Sıradan derleme hatalarını hızlı yakalar ve sertifika açısından bedavadır.
Ayrıca her bulut derlemesinden önce Windows'ta, projeyi bir kez bedelini ödediğimiz hatalara karşı denetleyen bir betik çalıştırıyoruz. Bir saniyelik bir kural, on dakikalık bir derlemeden iyidir.
Akılda kalacaklar
- Otomatik bulut imzalama ilk deneme için iyidir ama her çalıştırmada yeni sertifika üretir.
- Dışa aktarırken imzalanan imzasız arşiv, framework'leri imzasız bırakır ve yükleme doğrulamasında düşer.
- Tek bir dağıtım sertifikası oluştur, özel anahtarını yedekli sakla ve her derlemeye gizli değer olarak ver.
- Gizli değerleri derlemenin başında doğrula, sürüm numaralarını son paketten yazdır.
Sık sorulan sorular
Derlemeler neden eksik özel anahtar hatasıyla düştü?
Her çalıştırma yeni bir makinede yeni bir sertifika üretti ve bir sertifikanın özel anahtarı yalnızca onu üreten makinede bulunur.
İmzasız arşivleyip sonra imzalayabilir miyim?
Güvenilir biçimde hayır. Gömülü framework'ler imzasız kalır ve App Store Connect yüklemeyi geçersiz imza hatasıyla reddeder.
Dağıtım özel anahtarı nerede durmalı?
Kontrol ettiğin güvenli bir yedekte ve CI hizmetinde gizli değişken olarak; depoda asla.
Bunu kurmak için Mac gerekir mi?
Hayır. Sertifika isteği ve anahtar herhangi bir makinede üretilebilir, gerisini bulut derlemesi yapar.
Diğer yazılar
- 1'de Takılan iOS Derleme Numarası: İşlemeyen Üç Çözüm ve İşleyen Bir Çözüm
- 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ı