Fastlane ile iOS ve Android Yayınını Tek Komuta İndirmek: Kendi Uygulamalarımızdan Notlar
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.
|
1 2 3 4 5 6 7 8 |
source "https://rubygems.org" gem "fastlane", "~> 2.230" plugins_path = File.join(File.dirname(__FILE__), "fastlane", "Pluginfile") eval_gemfile(plugins_path) if File.exist?(plugins_path) |
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.
|
1 2 3 4 5 6 7 8 |
app_identifier(ENV["APP_IDENTIFIER"]) # örn. com.example.balloonpop team_id(ENV["APPLE_TEAM_ID"]) json_key_file(ENV["PLAY_JSON_KEY_PATH"]) package_name(ENV["ANDROID_PACKAGE_NAME"]) |
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.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
private_lane :asc_api_key do app_store_connect_api_key( key_id: ENV["ASC_KEY_ID"], issuer_id: ENV["ASC_ISSUER_ID"], key_content: ENV["ASC_KEY_CONTENT_BASE64"], is_key_content_base64: true, in_house: false ) end |
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.
|
1 2 3 4 5 6 7 8 9 10 11 12 |
private_lane :sync_signing do match( type: "appstore", git_url: ENV["MATCH_GIT_URL"], app_identifier: ENV["APP_IDENTIFIER"], readonly: is_ci ) end |
İ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.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
private_lane :bump_ios_build do latest = latest_testflight_build_number( app_identifier: ENV["APP_IDENTIFIER"] ) increment_build_number( build_number: latest + 1, xcodeproj: "ios/BalloonPop.xcodeproj" ) end |
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.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
platform :ios do desc "Yeni bir beta build'i TestFlight'a gönderir" lane :beta do setup_ci if is_ci asc_api_key sync_signing bump_ios_build build_app( workspace: "ios/BalloonPop.xcworkspace", scheme: "BalloonPop", export_method: "app-store", output_directory: "build/ios", clean: true ) upload_to_testflight(skip_waiting_for_build_processing: true) end end |
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:
|
1 2 3 4 5 |
bundle exec fastlane ios beta |
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.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 |
platform :android do desc "Internal test track'e yeni bir build gönderir" lane :internal do codes = google_play_track_version_codes(track: "internal") next_code = (codes.max || 0) + 1 gradle( task: "bundle", build_type: "Release", project_dir: "android/", properties: { "versionCode" => next_code } ) upload_to_play_store( track: "internal", aab: lane_context[SharedValues::GRADLE_AAB_OUTPUT_PATH], release_status: "draft", skip_upload_metadata: true, skip_upload_images: true, skip_upload_screenshots: true ) end end |
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:
|
1 2 3 4 5 6 7 8 9 10 |
android { defaultConfig { versionCode project.hasProperty("versionCode") ? project.property("versionCode").toInteger() : 1 versionName "1.4.0" } } |
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.
|
1 2 3 4 5 |
bundle exec fastlane android internal |
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.
|
1 2 3 4 5 6 7 8 9 10 11 |
lane :release_all do ensure_git_status_clean Fastlane::LaneManager.cruise_lane("ios", "beta") Fastlane::LaneManager.cruise_lane("android", "internal") add_git_tag(tag: "release/#{Time.now.strftime('%Y%m%d-%H%M')}") push_git_tags end |
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.
|
1 2 3 4 5 6 7 8 |
error do |lane, exception| UI.error("#{lane} lane'i başarısız oldu: #{exception.message}") # slack(message: "...", success: false) gibi bir bildirim buraya eklenebilir end |
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.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 |
name: ios-beta on: workflow_dispatch: jobs: beta: runs-on: macos-15 steps: - uses: actions/checkout@v4 - uses: ruby/setup-ruby@v1 with: bundler-cache: true - run: npm ci - run: cd ios && pod install - run: bundle exec fastlane ios beta env: APP_IDENTIFIER: ${{ secrets.APP_IDENTIFIER }} ASC_KEY_ID: ${{ secrets.ASC_KEY_ID }} ASC_ISSUER_ID: ${{ secrets.ASC_ISSUER_ID }} ASC_KEY_CONTENT_BASE64: ${{ secrets.ASC_KEY_CONTENT_BASE64 }} MATCH_GIT_URL: ${{ secrets.MATCH_GIT_URL }} MATCH_PASSWORD: ${{ secrets.MATCH_PASSWORD }} |
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
- fastlane Dokümantasyonu
- fastlane — App Store Connect API
- fastlane — match
- fastlane — upload_to_play_store (supply)
Faydalı olması dileğiyle.