Mobil geliştirmede Ruby: Fastlane, CI/CD ve otomasyon

Ruby nedir?

Ruby, Yukihiro Matsumoto tarafından 1995 yılında oluşturulmuş dinamik yorumlanan açık kaynaklı bir dildir. Ruby'nin temel ilkesi "optimum basitlik"tir (en az şaşırtma ilkesi). Dil, bloklar (closure), saf nesne yönelimli yaklaşım (sayılar dahil her şey bir nesnedir) ve güçlü bir meta programlama sistemiyle bilinir.

Ruby, sürüm 3.1'den itibaren JIT derlemesiyle YARV (Yet Another Ruby VM) yorumlayıcısında çalışır. Mevcut sürüm Ruby 3.4 (2025), dekoratörler, geliştirilmiş Prism ayrıştırıcı ve RBS aracılığıyla deneysel tip desteği içerir. RubyGems — paket yöneticisi — 200.000'den fazla gem içerir.

Ruby on Rails, Ruby ile oluşturulmuş en ünlü web çerçevesidir, ancak mobil geliştirmede Ruby farklı şekilde kullanılır. Ana alanı Fastlane'dir: kod imzalamadan mağaza yayınına kadar mobil uygulama yaşam döngüsünün tüm aşamalarını otomatikleştiren Ruby betikleri ve gem'lerinden oluşan bir ekosistem.

Fastlane için Ruby sözdizimi temelleri

Fastlane ile çalışmak yalnızca temel Ruby anlayışı gerektirir: metotlar, do-end blokları, semboller (:symbol) ve karma sözdizimi { key: value }. Python'un aksine Ruby, girinti yerine blokları kapatmak için end kullanır. Metotlar parantez olmadan çağrılabilir — bu, Fastlane DSL'sinde aktif olarak kullanılır.

# Fastlane'de kullanılan temel Ruby sözdizimi
def download_assets(version, platform: "ios")
  paths = {
    ios: "ios/Assets.car",
    android: "android/app/src/main/assets"
  }
  url = "https://cdn.example.com/assets/#{version}/#{paths[platform.to_sym]}"
  puts "Downloading from: #{url}"

  unless File.exist?("temp/assets")
    Dir.mkdir("temp/assets")
  end
  result = system("curl -o temp/assets.zip #{url}")
  raise "Download failed" unless result
end

download_assets("1.2.3", platform: "android")

Örnekte, download_assets metodu bir version argümanı ve isteğe bağlı adlandırılmış platform parametresi (varsayılan "ios") alır. #{...} ile dize enterpolasyonu, değerleri doğrudan dizelere yerleştirir. unless, if'in tersidir — koşul yanlış olduğunda kodu çalıştırır.

Fastlane: Ruby ile mobil derleme otomasyonu

Fastlane Ruby ile yazılmış açık kaynaklı bir araçtır. gem install fastlane ile yüklenir ve mobil geliştiricinin en rutin görevlerini otomatikleştirmek için bir dizi komut sağlar: ekran görüntüsü alma, kod imzalama, TestFlight ve Google Play Console'da yayınlama.

Fastlane araçlardan oluşur: sigh (sertifika yönetimi), match (ekiplerde sertifika senkronizasyonu), gym (iOS derlemeleri), gradle (Android derlemeleri), deliver (iOS yayını), supply (Android yayını), snapshot (ekran görüntüleri), scan (test). Tüm araçlara tek bir Fastfile'dan erişilebilir.

Büyük projelerde Fastlane, tek bir hatta 50'den fazla eylemi işler: sürüm artırma, CDN'den varlık indirme, derleme, imzalama, App Store Connect'e yükleme, Slack bildirimi gönderme. Tüm hat tek bir komutla çalışır: fastlane release.

Fastfile: derleme hattı yapılandırması

Fastfile, bir dizi eylemi (lane) tanımlayan Ruby benzeri bir DSL dosyasıdır. Her lane ayrı bir görevdir: beta (test derlemesi), release, screenshots. Lane'ler, iletilen parametrelerle diğer lane'leri çağırabilir.

# Fastfile — iOS uygulama derleme hattı yapılandırması
fastlane_version "2.220.0"

default_platform :ios

platform :ios do
  desc "TestFlight derlemesi oluşturma ve dağıtma"
  lane :beta do |options|
    increment_build_number(
      build_number: options[:build]
    )
    match(type: :appstore)
    gym(
      scheme: "MyApp",
      export_method: "app-store",
      configuration: "Release"
    )
    upload_to_testflight(
      app_identifier: "com.example.myapp"
    )
    slack(
      message: "Build #{options[:build]} TestFlight'a yüklendi"
    )
  end
end

Beta lane sırasıyla şunları yapar: derleme numarasını artırma (increment_build_number), sertifikaları senkronize etme (match), arşiv oluşturma (gym), TestFlight'a yükleme (upload_to_testflight) ve Slack bildirimi gönderme. :build parametresi, lane'e adlandırılmış argüman olarak iletilir.

Fastfile'da Android yapılandırması

Fastlane, tek bir Fastfile'da her iki platformu da destekler. Android için, platform :android içinde gradle, supply ve google_play_track_version_codes eylemleriyle bir lane kullanın.

platform :android do
  desc "APK oluşturma ve Google Play Internal Testing'de yayınlama"
  lane :beta do
    gradle(
      task: "assemble",
      build_type: "Release",
      flavor: "Production"
    )
    supply(
      track: "internal",
      apk_paths: ["app/build/outputs/apk/release/app-release.apk"]
    )
  end
end

iOS ve Android için temel Fastlane eylemleri

Fastlane, 200'den fazla yerleşik eylem içerir. Aşağıda mobil geliştirme için en önemlileri, kategorilere göre düzenlenmiştir.

Match: güvenli sertifika yönetimi

match, geliştiriciler arasında iOS sertifikalarını ve sağlama profillerini senkronize etmek için bir Fastlane gem'idir. Tüm sırlar şifrelenmiş bir Git deposunda veya S3'te saklanır. Match, sertifikalar eksikse otomatik olarak oluşturur ve süresi dolduğunda yeniler.

# Yeni bir proje için match başlatma
$ fastlane match init

# App Store sertifikaları oluşturma ve senkronize etme
$ fastlane match appstore

# Ekip için Development sertifikaları oluşturma
$ fastlane match development

# Süresi dolduğunda tüm sertifikaları yenileme
$ fastlane match --force

Match, özel anahtarları yalnızca geliştiricilerin bildiği bir parola ile saklar. Her geliştirici sertifika deposunu klonlar ve mevcut profilleri yüklemek için match'i çalıştırır. Apple sertifikaları 1 yıl geçerlidir; match onları otomatik olarak yeniler.

Fastlane'in CI/CD sistemleriyle entegrasyonu

Fastlane herhangi bir CI/CD platformuyla entegre olur: GitHub Actions, GitLab CI, CircleCI, Bitrise, Jenkins ve Xcode Cloud (xcode-build aracılığıyla). Fastlane, CI'da fastlane <lane_name> kullanılarak çalıştırılır ve herhangi bir adım başarısız olursa hata kodu döndürür.

GitHub Actions kurulumu, Ruby ve fastlane'in yüklenmesini ve bundle exec fastlane aracılığıyla lane'in çalıştırılmasını içerir. iOS derlemeleri bir macOS runner gerektirir. Android derlemeleri, daha ucuz olan ubuntu-latest'i kullanabilir.

# .github/workflows/deploy.yml — Fastlane ile CI/CD
name: Deploy Mobile App
on:
  push:
    branches: [main]

jobs:
  ios-deploy:
    runs-on: macos-14
    steps:
      - uses: actions/checkout@v4
      - uses: ruby/setup-ruby@v1
        with:
          ruby-version: "3.3"
      - run: bundle install
      - run: bundle exec fastlane beta
      - env:
          MATCH_PASSWORD: ${{ secrets.MATCH_PASSWORD }}

İş akışı, main'e push yapıldığında çalışır. macOS runner, Fastfile'dan bundle exec fastlane beta'yı çalıştırır. MATCH_PASSWORD, sertifika şifre çözme için GitHub Secrets aracılığıyla iletilir. Lane tamamlandıktan sonra bir Slack eylemi bildirim gönderir.

Ruby Gems ve Fastlane eklentileri

RubyGems, Ruby için paket yöneticisidir. Fastlane, eklentiler aracılığıyla genişletilir — yeni eylemler ekleyen gem'ler. fastlane-plugin-versioning eklentisi sürümleri yönetir, fastlane-plugin-firebase_app_distribution derlemeleri Firebase'e yükler. GitHub'da 500'den fazla Fastlane eklentisi vardır.

Proje kökündeki Gemfile, tekrarlanabilir derlemeler için tüm bağımlılıkların sürümlerini sabitler. bundle install, Gemfile.lock'tan gem'leri yükler. Mobil geliştirme için temel gem'ler şunları içerir: fastlane, cocoapods (iOS bağımlılıkları), xcodeproj (.xcodeproj işleme).

# Mobil proje için Gemfile
source "https://rubygems.org"

gem "fastlane", "~> 2.220"

plugins_path = File.join(File.dirname(__FILE__), 'fastlane', 'Pluginfile')
eval_gemfile(plugins_path) if File.exist?(plugins_path)

Fastlane ve alternatifleri: yaklaşım karşılaştırması

Fastlane tek otomasyon aracı değildir. Mobil ekip için önemli kriterlere göre ana alternatiflerle karşılaştıralım.

Fastlane, karmaşık hatlar için en esnek araç olmaya devam ediyor. Bitrise, Ruby geliştiricisi olmayan ekipler için uygundur. Xcode Cloud basit iOS projeleri için çalışır. GitHub Actions, ekip zaten GitHub kullanıyorsa idealdir.