← Nesim Apps

Bulutta iOS İmzalama: Her Derlemede Yeni Sertifika ve Kalıcı Çözüm

Nesim Razon, bağımsız mobil uygulama geliştiricisi · 2026-11-18

#Geliştirici notları#iOS

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

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

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