Fastlane ile iOS ve Android Yayınını Tek Komuta İndirmek: Kendi Uygulamalarımızdan Notlar

0 21

Birden fazla mobil uygulamayı hem App Store’a hem Google Play’e çıkarıyoruz. Her sürümde aynı adımlar dönüyordu: build numarasını artır, Xcode’da archive al, sertifikayla uğraş, TestFlight’a yükle, sonra Android tarafında AAB üret, Play Console’a gir, internal track’e at. Adım sayısı az değil ve her birinde unutulacak bir şey var. Bir uygulamada build numarasını artırmayı unuttuğunuzda App Store Connect yüklemeyi reddediyor, siz de uzun süren archive işlemini baştan alıyorsunuz.

Bu yazıda fastlane ile bu süreci nasıl tek komuta indirdiğimizi anlatacağım. Proje yapısı React Native (ios/ ve android/ klasörleri), ama native bir iOS ya da Android projesinde de aynı Fastfile neredeyse aynen çalışır.

Spring Boot tarafından geliyorsanız şöyle düşünebilirsiniz: fastlane, mobil yayın için Maven/Gradle task’ları ve bir CI pipeline’ının birleşimi. Fastfile sizin pipeline tanımınız, lane‘ler de çalıştırdığınız task’lar.

Kurulum: fastlane’i Bundler ile sabitlemek

fastlane bir Ruby gem’i. Global kurmak yerine projeye bir Gemfile koyup sürümü sabitlemek, CI ile yerel makinenin aynı sürümü kullanmasını sağlıyor.

Ardından bundle install ve proje kökünde bundle exec fastlane init. Bundan sonra her komutu bundle exec fastlane ... ile çalıştırıyoruz. bundle exec olmadan çalıştırdığınızda makinedeki başka bir fastlane sürümü devreye girebiliyor ve “bende çalışıyordu” sorunu buradan başlıyor.

Appfile: uygulamanın kimliği

fastlane/Appfile uygulamaya ait sabit bilgileri tutar. Değerleri doğrudan yazmak yerine ortam değişkenlerinden okuyoruz, böylece aynı şablonu birden fazla uygulamada kullanabiliyoruz.

Değerler fastlane/.env dosyasında duruyor ve bu dosya .gitignore içinde. fastlane .env dosyasını kendisi yükler, ek bir şey yapmanıza gerek yok.

App Store Connect API Key: Apple ID ve 2FA’dan kurtulmak

Eskiden fastlane Apple ID ve şifreyle giriş yapıyordu. İki faktörlü doğrulama devreye girince CI’da bu iş tam bir eziyete dönüştü. Çözüm App Store Connect API Key. App Store Connect > Users and Access > Integrations bölümünden bir anahtar oluşturuyorsunuz, .p8 dosyasını indiriyorsunuz.

private_lane dışarıdan çağrılamayan, sadece diğer lane’lerin kullandığı bir yardımcı. app_store_connect_api_key çağrıldıktan sonra anahtar fastlane’in paylaşılan context’ine yazılıyor ve match, upload_to_testflight gibi action’lar onu otomatik kullanıyor. Anahtarı base64 olarak tek satır ortam değişkeninde tutmak, CI secret’larına koymayı kolaylaştırıyor.

match: sertifikaları ekipçe paylaşmak

iOS’ta en çok vakit kaybettiren konu imzalama. Yeni bir makinede, yeni bir CI runner’da ya da yeni bir ekip arkadaşında sertifika ve provisioning profile kurulumu her seferinde baştan başlıyor. match sertifikaları şifreli olarak private bir git reposunda tutuyor ve herkes aynı sertifikayı kullanıyor.

İlk seferde yerel makinede readonly: false ile çalıştırıp sertifikaları oluşturuyoruz. CI’da readonly: true kalıyor, yani CI sertifika üretmeye ya da iptal etmeye çalışmıyor, sadece okuyor. is_ci fastlane’in hazır yardımcı metodu. Repo şifresi MATCH_PASSWORD ortam değişkeninden geliyor.

Build numarası: elle artırmayı bırakmak

Yazının başındaki “build numarasını unuttum” sorununun çözümü bu. Build numarasını TestFlight’taki son numaradan okuyup bir artırıyoruz. Yerelde kimse bir şey hatırlamak zorunda kalmıyor.

Kaynak olarak App Store Connect’i kullanmak önemli. Build numarasını git’teki dosyadan okursanız iki farklı branch’ten çıkan build’ler aynı numarayı alabiliyor. TestFlight’tan okumak her zaman yukarı doğru giden tek bir sayaç veriyor.

iOS lane’i: build edip TestFlight’a yüklemek

Yardımcılar hazır olunca asıl lane oldukça kısa kalıyor.

setup_ci CI ortamında geçici bir keychain oluşturuyor. Bunu atlarsanız GitHub Actions gibi ortamlarda match sertifikayı kuruyor ama codesign işlemi keychain’e erişemeyip takılıyor. skip_waiting_for_build_processing ise Apple’ın build’i işlemesini beklemeden lane’i bitiriyor. İşleme süresi uzayabiliyor ve bunu beklemek için CI dakikası harcamaya değmiyor.

Çalıştırmak için:

Android lane’i: AAB üretip Play Console’a yüklemek

Android tarafında imzalama Gradle’ın işi. Keystore bilgilerini android/gradle.properties yerine ortam değişkenlerinden okuyoruz. fastlane sadece Gradle’ı çağırıp çıkan AAB’yi yüklüyor.

Play Console’a erişim için Google Cloud’da bir service account oluşturup Play Console’da yetki veriyorsunuz. İndirdiğiniz JSON anahtarı Appfile’daki json_key_file.

Mantık iOS ile aynı: version code’u Play Console’daki son değerden alıp bir artırıyoruz. properties ile gelen değeri build.gradle içinde okumak için küçük bir değişiklik gerekiyor:

release_status: "draft" bilinçli bir tercih. İlk yüklemeyi taslak olarak bırakıp Play Console’dan bir göz atıyoruz. Süreç oturduktan sonra bunu completed yapabilirsiniz. Bir not: Play Console’da uygulamanın ilk sürümü API ile yüklenemiyor, ilk AAB’yi elle yüklemeniz gerekiyor. Sonraki sürümler fastlane ile sorunsuz gidiyor.

Tek komutla iki platform

İki platformu birlikte çıkarmak için platform dışında bir lane tanımlıyoruz. Lane’ler birbirini normal metot gibi çağırabiliyor.

ensure_git_status_clean commit edilmemiş değişiklik varsa lane’i hemen durduruyor. Yerelde yarım kalmış bir değişikliğin mağazaya gitmesini engelleyen en ucuz kontrol bu. Sondaki tag sayesinde hangi commit’in hangi gün mağazaya gittiğini git geçmişinden görebiliyoruz.

Hata olduğunda haberdar olmak

Lane’ler CI’da çalıştığı için bir şey patladığında bunu bir an önce görmek istiyoruz. fastlane’in error bloğu herhangi bir lane hata verdiğinde çalışıyor.

Biz burada kendi bildirim kanalımıza mesaj atıyoruz. slack action’ı hazır geliyor, webhook URL’ini vermeniz yeterli.

GitHub Actions ile çalıştırmak

Son adım bu lane’leri CI’a bağlamak. iOS build’i için macOS runner gerekiyor.

bundler-cache: true gem’leri cache’liyor ve Gemfile.lock’taki fastlane sürümünü kuruyor. Tüm özel değerler GitHub secret’larında, repoda hiçbir anahtar yok. match reposuna erişim için ayrıca bir deploy key ya da token tanımlamayı unutmayın.

Toparlarsak

fastlane’in bize kazandırdığı şey hız kadar tekrarlanabilirlik. Build numarası artık App Store Connect ve Play Console’dan okunuyor, sertifikalar match ile tek yerden geliyor, Apple girişi API key ile yapılıyor ve iki platform tek komutla çıkıyor. Yeni bir uygulama eklediğimizde aynı Fastfile’ı kopyalayıp .env değerlerini değiştirmek yetiyor.

Kaynaklar

Faydalı olması dileğiyle.

Email adresiniz yayınlanmayacaktır.