Mac Sahibi Olmadan iOS Uygulamalarını App Store’a Yayımlamak: GitHub Actions ile Özgürleşin

Mac Sahibi Olmadan iOS Uygulamalarını App Store’a Yayımlamak: GitHub Actions ile Özgürleşin

Günümüzde mobil uygulama geliştirme dünyasına adım atmak isteyen birçok yazılımcı için en büyük engellerden biri, Apple ekosisteminin getirdiği donanım kısıtlamalarıdır. Özellikle iOS uygulaması geliştirmek ve App Store’a göndermek için bir Mac bilgisayara sahip olmak genellikle bir zorunluluk olarak görülür. Ancak, yüksek maliyetli bir Mac yatırımı yapmadan da bu süreci başarıyla tamamlamak mümkün müdür? Bu makalede, bu sorunun cevabını GitHub Actions’ın ücretsiz macOS koşucuları (runners) ile nasıl verdiğimizi, adım adım teknik detaylarla, gerçek dünya senaryolarıyla ve pratik örneklerle ele alacağız. Bu sayede, hem bütçesini düşünen geliştiriciler hem de mevcut CI/CD (Sürekli Entegrasyon/Sürekli Dağıtım) süreçlerini optimize etmek isteyenler için kapsamlı bir rehber sunmayı hedefliyoruz.

Mac Sahibi Olmadan iOS Geliştirmenin Zorlukları Nelerdir? Ve Çözüm Yolları

iOS uygulama geliştirme serüvenine atılmak isteyen birçok hevesli yazılımcı için ilk ve en önemli bariyer genellikle donanım maliyetidir. Apple’ın geliştirme araçları olan Xcode ve iOS SDK’sı, doğal olarak sadece macOS işletim sistemi üzerinde çalışır. Bu durum, Windows veya Linux tabanlı sistemler kullanan geliştiriciler için App Store’a uygulama gönderme hayallerini bir Mac satın alma zorunluluğuyla gölgeler. Yeni bir Mac bilgisayarın, özellikle de geliştirme için yeterli performansı sunan bir modelin, önemli bir yatırım gerektirmesi, birçok kişi için caydırıcı olabilir. Bu maliyet engeli, yetenekli geliştiricilerin Apple ekosistemine dahil olmasını zorlaştırırken, aynı zamanda mevcut projeler için ek donanım altyapısı kurma yükünü de beraberinde getirir. Peki, bu durum gerçekten bir çıkmaz sokak mıdır? Kesinlikle hayır. Teknoloji dünyası, bu tür kısıtlamaları aşmak için sürekli yeni çözümler üretmektedir.

Bulut tabanlı çözümler ve otomasyon araçları, Mac sahibi olma zorunluluğunu ortadan kaldıran güçlü alternatifler sunar. Sürekli Entegrasyon (CI) ve Sürekli Dağıtım (CD) yaklaşımları, yazılım geliştirme süreçlerini otomatikleştirerek, kodun derlenmesinden test edilmesine ve dağıtılmasına kadar tüm adımları insan müdahalesi olmadan gerçekleştirmeyi amaçlar. Geleneksel olarak, bu otomasyon süreçleri için de genellikle şirket içi sunucular veya özel donanımlar kullanılırdı. Ancak günümüzde, GitHub Actions gibi platformlar, bu CI/CD yeteneklerini bulut üzerinden, üstelik belirli bir limit dahilinde ücretsiz olarak sunarak oyunun kurallarını değiştirmiştir. Özellikle GitHub Actions’ın sağladığı macOS koşucuları (runners), geliştiricilere kendi Mac’leri olmadan Xcode ortamını kullanma ve iOS uygulamalarını derleme, test etme ve App Store’a gönderme imkanı tanır. Bu sayede, bir Mac satın alma maliyeti ve bakım yükü tamamen ortadan kalkar. Geliştiriciler, sadece kodlarına odaklanarak, bulutun gücünü kullanarak projelerini dünyaya açabilirler. Bu yaklaşım, hem bireysel geliştiriciler için bir kurtarıcı niteliğindedir hem de küçük ve orta ölçekli ekiplerin daha çevik ve maliyet etkin bir şekilde çalışmasına olanak tanır. Artık “Mac’im yok, iOS uygulaması geliştiremem” bahanesi geçerliliğini yitirmiştir; çünkü bulut tabanlı otomasyon, bu engeli aşmak için güçlü bir köprü görevi görmektedir. Bu çözüm, sadece maliyet avantajı sağlamakla kalmaz, aynı zamanda CI/CD’nin getirdiği kalite, hız ve güvenilirlik gibi faydaları da beraberinde getirir.

GitHub Actions ve Ücretsiz macOS Koşucuları: Temel Kavramlara Giriş

GitHub Actions, yazılım geliştirme iş akışlarını otomatikleştirmenizi sağlayan, GitHub tarafından sunulan bir Sürekli Entegrasyon (CI) ve Sürekli Dağıtım (CD) platformudur. Temel olarak, bir depoda (repository) belirli bir olay (örneğin, kod gönderme, çekme isteği açma) meydana geldiğinde otomatik olarak çalışan özelleştirilebilir iş akışları (workflows) tanımlamanıza olanak tanır. Bu iş akışları, genellikle YAML formatında yazılan yapılandırma dosyaları aracılığıyla belirlenir ve bir veya daha fazla iş (job) içerir. Her iş, sanal makinelerde (koşucular/runners) çalıştırılan bir dizi adımdan (steps) oluşur. GitHub Actions’ın en dikkat çekici özelliklerinden biri, farklı işletim sistemlerine sahip koşucular sunmasıdır: Linux, Windows ve bizim konumuz için hayati önem taşıyan macOS. Bu macOS koşucuları, Xcode gibi Apple’a özel geliştirme araçlarını barındırdığı için iOS uygulamalarını derlemek ve test etmek için ideal bir ortam sağlar.

Peki, bu macOS koşucuları neden bu kadar önemli ve nasıl ücretsiz oluyor? GitHub, açık kaynak projeleri ve bireysel kullanıcılar için belirli bir limit dahilinde ücretsiz kullanım süresi sunar. Bu limit, genellikle ayda binlerce dakika çalışma süresi içerir ki bu, birçok bağımsız geliştirici veya küçük proje için fazlasıyla yeterlidir. Bu koşucular, GitHub’ın kendi altyapısında barındırılan, önceden yapılandırılmış sanal makinelerdir. Yani, bir geliştirici olarak sizin bir Mac satın almanıza, kurmanıza veya bakımını yapmanıza gerek kalmaz. Sadece bir .github/workflows dizini altında bir YAML dosyası oluşturarak, kodunuzu bu bulut tabanlı Mac’lerde çalıştırmalarını söylersiniz. İş akışınız tetiklendiğinde, GitHub bir macOS koşucusu tahsis eder, projenizi klonlar, gerekli bağımlılıkları yükler ve sizin tanımladığınız adımları sırasıyla yürütür. Bu adımlar arasında Xcode ile uygulamayı derlemek, testleri çalıştırmak, sertifikaları yönetmek ve hatta App Store Connect’e (eskiden iTunes Connect) uygulamayı yüklemek gibi işlemler yer alabilir. Ücretsiz limitin ötesine geçildiğinde ise cüzi miktarlarda ödeme yaparak bu hizmeti kullanmaya devam edebilirsiniz. Bu esneklik ve maliyet etkinliği, GitHub Actions’ı Mac sahibi olmayan iOS geliştiricileri için vazgeçilmez bir araç haline getirmektedir. Ayrıca, bu koşucular genellikle en son Xcode sürümlerini ve diğer geliştirme araçlarını barındırır, bu da güncel teknolojilerle çalışmayı kolaylaştırır. Kısacası, GitHub Actions’ın macOS koşucuları, cebinizde bir Mac taşımanıza gerek kalmadan, Apple ekosisteminin kapılarını aralayan sanal bir köprü görevi görür. Bu, geliştirme süreçlerini demokratikleştirir ve daha geniş bir kitleye ulaşılabilir kılar.

App Store’a Dağıtım Sürecinin Temelleri: Xcode ve Sertifikalar Nasıl Çalışır?

iOS uygulamalarını App Store’a gönderme süreci, otomasyona geçmeden önce anlaşılması gereken birkaç temel bileşene dayanır. Bu bileşenler, Apple’ın güvenlik ve kalite standartlarını sağlamak için tasarlanmıştır ve her geliştiricinin bilmesi gereken önemli adımlardır. İlk olarak, bir Apple Developer Program üyeliği olmazsa olmazdır. Yıllık belirli bir ücret karşılığında bu programa kaydolduğunuzda, uygulamalarınızı test cihazlarına yükleme, App Store’a gönderme ve çeşitli geliştirici araçlarına erişim yeteneği kazanırsınız. Bu üyelik, sertifika ve profil yönetimi için temel bir ön koşuldur.

Sertifikalar, Apple’ın geliştirici kimliğinizi ve uygulamanızın gerçekliğini doğrulamak için kullandığı dijital imzalardır. İki ana sertifika türü vardır:

1. Geliştirme Sertifikası (Development Certificate): Uygulamaları fiziksel iOS cihazlarında test etmek için kullanılır.
2. Dağıtım Sertifikası (Distribution Certificate): Uygulamaları App Store’a veya kurumsal ortamlara dağıtmak için kullanılır.

Bu sertifikalar, bir anahtar çifti (public ve private key) içerir ve genellikle yerel Mac’inizdeki Anahtar Zinciri Erişimi (Keychain Access) uygulaması aracılığıyla yönetilir. Ancak Mac’imiz olmadığı için bu sertifikaları otomasyon ortamında nasıl yöneteceğimiz kritik bir sorudur.

Provisioning Profilleri (Sağlama Profilleri), bir uygulamanın belirli bir cihazda (geliştirme profilleri için) veya belirli bir dağıtım yöntemiyle (dağıtım profilleri için) çalışmasına izin veren dosyalardır. Bir provisioning profili şunları içerir:

• Bir veya daha fazla geliştirme/dağıtım sertifikası.
• Uygulamanın çalışmasına izin verilen cihazların listesi (geliştirme profilleri için).
• Uygulamanın kullanabileceği belirli yetenekler (capabilities) veya hizmetler (örneğin, Push Bildirimleri, iCloud, Uygulama Grupları).
• Uygulama Kimliği (App ID): Uygulamanızı benzersiz şekilde tanımlayan bir dize (örneğin, com.sirketim.uygulamam).

Xcode, bu sertifikaları ve profilleri kullanarak uygulamanızı imzalar ve derler. Uygulamanızın başarılı bir şekilde App Store’a gönderilebilmesi için doğru dağıtım sertifikası ve provisioning profili ile imzalanmış olması gerekir. Otomasyon ortamında, bu sertifika ve profillerin güvenli bir şekilde GitHub Actions koşucusuna sağlanması ve Xcode’un bunları kullanacak şekilde yapılandırılması gerekmektedir. Bu genellikle, sertifikaların ve özel anahtarların şifrelenmiş bir şekilde depolanması ve iş akışı sırasında geçici olarak sisteme yüklenmesiyle yapılır. Fastlane gibi araçlar, bu karmaşık süreci büyük ölçüde basitleştirerek, sertifika ve profil yönetimini otomatize etmemize yardımcı olur. Bu temel bilgileri anladıktan sonra, Mac’siz dağıtım sürecinin teknik adımlarını daha net bir şekilde kavrayabiliriz. Bu süreçler, Apple’ın güvenlik ve ekosistem bütünlüğünü sağlama mekanizmalarının temelini oluşturur ve doğru şekilde yönetilmeleri, başarılı bir uygulama yayınlama için şarttır.

GitHub Actions İş Akışı Oluşturma: Adım Adım Rehber

GitHub Actions ile Mac olmadan iOS uygulamanızı App Store’a göndermenin ilk ve en kritik adımı, doğru bir iş akışı (workflow) dosyası oluşturmaktır. Bu dosya, projenizin kök dizininde .github/workflows klasörünün içine yerleştirilir ve genellikle main.yml veya ci.yml gibi bir isim alır. İş akışı dosyası, projeniz üzerinde hangi işlemlerin, ne zaman ve hangi koşullar altında yapılacağını tanımlayan bir YAML dosyasıdır. Aşağıda, temel bir iOS dağıtım iş akışı için adım adım bir rehber ve kod örneği bulunmaktadır.

Öncelikle, iş akışınızın ne zaman tetikleneceğini belirtmelisiniz. Genellikle bu, push (koda yapılan değişiklikler gönderildiğinde) veya pull_request (çekme isteği açıldığında) olaylarıdır.

name: iOS App Store Dağıtımı

on:
  push:
    branches:
      - main # main branch'ine push yapıldığında çalıştır

jobs:
  build-and-deploy:
    runs-on: macos-latest # macOS koşucusu kullan
    
    steps:
    - name: Depoyu Klonla
      uses: actions/checkout@v4 # Projeyi koşucuya klonla

    - name: Ruby Kurulumu ve Fastlane Bağımlılıkları
      uses: ruby/setup-ruby@v1
      with:
        ruby-version: '3.x' # Projenizin ihtiyacına göre Ruby sürümünü ayarlayın
        bundler-cache: true # Gemfile.lock varsa bağımlılıkları önbelleğe alır
    
    - name: Cocoapods Kurulumu
      run: |
        gem install cocoapods
        cd iOSAppKlasoru # Projenizin iOS klasörüne gidin
        pod install --repo-update # Pod bağımlılıklarını yükle
      
    - name: Sertifika ve Profil Yönetimi (Fastlane match kullanılıyorsa)
      env:
        FASTLANE_USER: ${{ secrets.FASTLANE_USER }} # App Store Connect kullanıcı adı
        FASTLANE_PASSWORD: ${{ secrets.FASTLANE_PASSWORD }} # App Store Connect şifresi
        MATCH_PASSWORD: ${{ secrets.MATCH_PASSWORD }} # match şifresi (varsa)
        # Diğer gerekli ortam değişkenleri
      run: |
        cd iOSAppKlasoru
        bundle exec fastlane match appstore --readonly # Mevcut sertifikaları indir
        # Alternatif olarak, sertifikaları manuel olarak yükleyebilirsiniz:
        # echo "${{ secrets.P12_BASE64 }}" | base64 --decode > Certificates.p12
        # security import Certificates.p12 -k ~/Library/Keychains/login.keychain -P ${{ secrets.P12_PASSWORD }} -A
        # mkdir -p ~/Library/MobileDevice/Provisioning\ Profiles/
        # echo "${{ secrets.PROVISIONING_PROFILE_BASE64 }}" | base64 --decode > ~/Library/MobileDevice/Provisioning\ Profiles/YourProfile.mobileprovision

    - name: Uygulamayı Derle (Fastlane gym kullanılıyorsa)
      env:
        FASTLANE_USER: ${{ secrets.FASTLANE_USER }}
        FASTLANE_PASSWORD: ${{ secrets.FASTLANE_PASSWORD }}
        APP_STORE_CONNECT_API_KEY_ID: ${{ secrets.APP_STORE_CONNECT_API_KEY_ID }}
        APP_STORE_CONNECT_API_KEY_ISSUER_ID: ${{ secrets.APP_STORE_CONNECT_API_KEY_ISSUER_ID }}
        APP_STORE_CONNECT_API_KEY_BASE64: ${{ secrets.APP_STORE_CONNECT_API_KEY_BASE64 }} # .p8 dosyasının base64 hali
      run: |
        cd iOSAppKlasoru
        bundle exec fastlane beta # Fastfile'daki beta lane'ini çalıştır (genellikle derleme ve test içerir)
        # Veya doğrudan gym kullanın:
        # bundle exec fastlane gym --scheme "YourAppScheme" --configuration "Release" --export_method appstore --output_directory build
        
    - name: Testleri Çalıştır (İsteğe Bağlı)
      run: |
        cd iOSAppKlasoru
        bundle exec fastlane scan # Fastfile'daki test lane'ini çalıştır
        # Veya doğrudan Xcodebuild ile:
        # xcodebuild test -workspace "YourApp.xcworkspace" -scheme "YourAppScheme" -destination "platform=iOS Simulator,name=iPhone 15"

    - name: App Store Connect'e Yükle (Fastlane deliver kullanılıyorsa)
      env:
        FASTLANE_USER: ${{ secrets.FASTLANE_USER }}
        FASTLANE_PASSWORD: ${{ secrets.FASTLANE_PASSWORD }}
        APP_STORE_CONNECT_API_KEY_ID: ${{ secrets.APP_STORE_CONNECT_API_KEY_ID }}
        APP_STORE_CONNECT_API_KEY_ISSUER_ID: ${{ secrets.APP_STORE_CONNECT_API_KEY_ISSUER_ID }}
        APP_STORE_CONNECT_API_KEY_BASE64: ${{ secrets.APP_STORE_CONNECT_API_KEY_BASE64 }}
      run: |
        cd iOSAppKlasoru
        bundle exec fastlane deploy # Fastfile'daki deploy lane'ini çalıştır (genellikle deliver içerir)
        # Veya doğrudan deliver kullanın:
        # bundle exec fastlane deliver --force --submit_for_review true --automatic_release true

    - name: Yapıtları Yükle (İsteğe Bağlı)
      uses: actions/upload-artifact@v4
      with:
        name: iOS-App-Build
        path: iOSAppKlasoru/build/*.ipa # Oluşan IPA dosyasını sakla

Bu örnek iş akışı, temel adımları göstermektedir. Her step (adım), bir name (isim) ve bir run (çalıştırılacak komut) veya uses (mevcut bir GitHub Action’ı kullan) anahtarına sahiptir. runs-on: macos-latest ifadesi, işin en güncel macOS koşucusunda çalışacağını belirtir. env anahtarı altında, hassas bilgileri doğrudan dosyaya yazmak yerine GitHub Secrets (sırlar) kullanarak ortam değişkenleri tanımlarız. Bu sırlar, GitHub deponuzun ayarlarında güvenli bir şekilde saklanır ve iş akışı sırasında çağrılır. Özellikle FASTLANE_USER, FASTLANE_PASSWORD ve App Store Connect API anahtarları gibi bilgiler bu şekilde korunmalıdır. cd iOSAppKlasoru komutu, projenizin iOS uygulama kodunu içeren dizine geçmek için kullanılır. Bu dizin adı projenize göre değişecektir. bundle exec fastlane komutları, Fastlane araçlarını kullanarak derleme, test ve dağıtım işlemlerini otomatikleştirmeyi sağlar. Bu yapılandırma ile Mac’iniz olmadan bulut üzerinde iOS uygulamanızı başarılı bir şekilde derleyebilir ve App Store’a gönderme sürecinin temelini atmış olursunuz. Her adımın detaylı çıktısını GitHub Actions arayüzünden takip edebilir, olası hataları tespit edip giderebilirsiniz.

Otomatik Derleme ve Test Süreçleri: Güvenilir Bir CI Altyapısı Kurmak

Otomatik derleme ve test süreçleri, herhangi bir CI/CD hattının kalbidir ve özellikle Mac olmadan iOS uygulamaları geliştirirken hayati öneme sahiptir. Bu süreçler, kodunuzdaki hataları erken aşamada yakalamanızı, uygulamanızın kalitesini artırmanızı ve yayınlama sürecini hızlandırmanızı sağlar. GitHub Actions’ın macOS koşucuları üzerinde bu adımları yapılandırmak, güvenilir ve tekrarlanabilir bir geliştirme akışı oluşturmanın anahtarıdır.

Derleme (Build) Adımı: Uygulamanızın kaynak kodunu, çalıştırılabilir bir ikili dosyaya (genellikle bir .ipa dosyası) dönüştürme işlemidir. Bu adımda Xcode, projenizin tüm bağımlılıklarını çözer, kodunuzu derler ve uygulamayı imzalar. GitHub Actions iş akışınızda bu adımı genellikle Fastlane’in gym aracıyla otomatikleştiririz. gym, Xcode’un xcodebuild komutunu saran ve derleme sürecini çok daha basit hale getiren bir Fastlane aracıdır.

Örnek bir Fastfile (Fastlane yapılandırma dosyası) içinde build_app lane’i şöyle görünebilir:

lane :build_app do
  increment_build_number(xcodeproj: "YourApp.xcodeproj") # İsteğe bağlı: Her derlemede build numarasını artır
  gym(
    workspace: "YourApp.xcworkspace", # Eğer Cocoapods kullanıyorsanız .xcworkspace
    scheme: "YourAppScheme",
    configuration: "Release",
    export_method: "appstore", # App Store için dağıtım metodu
    output_directory: "build", # IPA dosyasının kaydedileceği dizin
    output_name: "YourApp" # IPA dosyasının adı
  )
end

Bu build_app lane’ini GitHub Actions iş akışınızda bundle exec fastlane build_app komutuyla çağırabilirsiniz. Derleme sırasında, koşucuda doğru Xcode sürümünün seçildiğinden (genellikle xcode-select -s /Applications/Xcode.app/Contents/Developer ile otomatik olarak yapılır) ve tüm sertifikaların ve provisioning profillerinin doğru şekilde yüklendiğinden emin olmalısınız.

Test Adımı: Derleme başarılı olduktan sonra, uygulamanızın beklenen şekilde çalıştığından emin olmak için testlerin çalıştırılması gerekir. Bu, birim testleri (unit tests) ve kullanıcı arayüzü testleri (UI tests) içerebilir. Otomatik testler, regresyon hatalarını yakalamanın ve kod kalitesini sürdürmenin en etkili yoludur. Fastlane’in scan aracı, bu süreci otomatikleştirmek için mükemmeldir.

Örnek bir Fastfile içinde run_tests lane’i:

lane :run_tests do
  scan(
    workspace: "YourApp.xcworkspace",
    scheme: "YourAppScheme",
    destination: "platform=iOS Simulator,name=iPhone 15", # Testlerin çalışacağı simülatör
    output_directory: "test_output",
    output_types: "html,junit", # Test sonuçlarını farklı formatlarda kaydet
    clean: true
  )
end

GitHub Actions iş akışınızda bu lane’i bundle exec fastlane run_tests ile çağırabilirsiniz. Test sonuçlarını HTML veya JUnit formatında kaydederek, GitHub Actions arayüzünde daha okunabilir bir raporlama elde edebilirsiniz.

Önbellekleme (Caching): Her derlemede bağımlılıkları (Cocoapods podları gibi) sıfırdan indirmek zaman alıcı ve kota tüketici olabilir. GitHub Actions’ın önbellekleme (caching) özelliği sayesinde, daha önce indirilen bağımlılıkları sonraki çalıştırmalar için saklayabilir ve derleme sürelerini önemli ölçüde kısaltabilirsiniz.

- name: Cocoapods Önbelleğini Yükle
  uses: actions/cache@v4
  with:
    path: Pods # Önbelleğe alınacak dizin
    key: ${{ runner.os }}-pods-${{ hashFiles('**/Podfile.lock') }} # Anahtar, Podfile.lock değiştiğinde önbelleği geçersiz kılar
    restore-keys: |
      ${{ runner.os }}-pods-

- name: Cocoapods Kurulumu
  run: |
    cd iOSAppKlasoru
    pod install --repo-update # Eğer önbellekte yoksa veya değiştiyse yeniden yükle

Bu adımlar, Mac olmadan bulut tabanlı bir CI/CD ortamında iOS uygulamanız için sağlam bir derleme ve test altyapısı oluşturmanızı sağlar. Güvenilir testler ve hızlı derlemeler, geliştirme sürecinizin verimliliğini artırırken, son kullanıcıya daha kaliteli bir ürün sunmanıza yardımcı olur.

Fastlane ile App Store Connect’e Dağıtımın Otomatikleştirilmesi

Fastlane, iOS ve Android uygulamalarının dağıtımını otomatikleştirmek için tasarlanmış açık kaynaklı bir araç setidir. Mac olmadan App Store’a uygulama gönderme sürecinde Fastlane, sertifika ve provisioning profili yönetiminden derlemeye, ekran görüntüsü çekmekten App Store Connect’e yüklemeye kadar her adımı basitleştirir. GitHub Actions ile Fastlane’i birleştirmek, manuel süreçlerin getirdiği zaman kaybını ve hata riskini ortadan kaldırır.

Fastlane’i kullanmaya başlamak için projenizin kök dizininde Fastfile ve Appfile adında iki ana dosya oluşturmanız gerekir. Fastfile, dağıtım iş akışınızı tanımlayan Ruby kodunu içerirken, Appfile uygulamanızın App Store Connect kimliğini ve bundle ID’sini barındırır.

1. Fastlane Kurulumu:
Projenizin kök dizininde Gemfile oluşturun ve içine Fastlane’i ekleyin:

source "https://rubygems.org"

gem "fastlane"

Ardından, terminalde bundle install komutunu çalıştırarak Fastlane’i yükleyin.

2. Appfile Yapılandırması:
Appfile dosyanızda uygulamanızın temel bilgilerini belirtin:

app_identifier "com.sirketiniz.uygulamaniz" # Uygulamanızın Bundle ID'si
apple_id "your_apple_id@example.com" # Apple Developer hesabınızın e-posta adresi
team_id "YOUR_TEAM_ID" # Apple Developer Team ID'niz (App Store Connect'ten bulabilirsiniz)

3. Fastfile ile Sertifika ve Profil Yönetimi (match):
match, Fastlane’in sertifika ve provisioning profillerini git deposunda şifreli bir şekilde merkezi olarak yönetmenizi sağlayan aracıdır. Bu, birden fazla geliştirici veya CI/CD ortamı için sertifika yönetimini büyük ölçüde basitleştirir.

Fastfile içinde match kullanımı:

lane :setup_certificates do
  match(type: "appstore", # App Store dağıtımı için sertifika ve profil
        git_url: "https://github.com/your-org/certs.git", # Sertifikaların saklandığı özel git deposu
        readonly: true) # Sadece oku modunda, CI/CD ortamında yeni sertifika oluşturmaz
end

Bu adımda, MATCH_PASSWORD ve FASTLANE_USER, FASTLANE_PASSWORD gibi ortam değişkenlerini GitHub Secrets olarak tanımlamanız gerekecektir. match çalıştırıldığında, belirtilen git deposundan şifrelenmiş sertifikaları ve profilleri indirir, şifresini çözer ve koşucuya yükler. readonly: true parametresi, CI ortamında yeni sertifikaların yanlışlıkla oluşturulmasını engeller.

4. App Store Connect’e Yükleme (deliver):
Uygulamanız derlendikten ve imzalandıktan sonra, deliver aracı App Store Connect’e yükleme işlemini gerçekleştirir. Bu araç, IPA dosyasını, meta verileri (uygulama adı, açıklama, anahtar kelimeler vb.) ve ekran görüntülerini App Store Connect’e gönderir.

Fastfile içinde deploy_to_app_store lane’i:

lane :deploy_to_app_store do
  # Önceki adımlarda uygulamanın derlendiğinden emin olun (örneğin gym ile)
  # gym(scheme: "YourAppScheme", configuration: "Release", export_method: "appstore")

  deliver(
    force: true, # Meta verilerde değişiklik yoksa bile zorla yükle
    submit_for_review: true, # Otomatik olarak incelemeye gönder
    automatic_release: true, # Apple onayladıktan sonra otomatik yayınla
    # metadata_path: "./fastlane/metadata", # Meta verilerin bulunduğu klasör
    # screenshots_path: "./fastlane/screenshots", # Ekran görüntülerinin bulunduğu klasör
    api_key: app_store_connect_api_key # API anahtarı ile kimlik doğrulama
  )
end

deliver kullanırken, Apple ID ve şifre yerine App Store Connect API Anahtarı (API Key) kullanmak çok daha güvenli ve tavsiye edilen bir yöntemdir. Bu anahtar, App Store Connect’ten oluşturulur ve bir .p8 uzantılı dosya olarak indirilir. Bu .p8 dosyasının içeriğini base64 ile kodlayıp GitHub Secret olarak saklayabilir ve Fastlane’e aşağıdaki gibi geçirebilirsiniz:

# Fastfile içinde
def app_store_connect_api_key
  @app_store_connect_api_key ||= begin
    api_key_base64 = ENV["APP_STORE_CONNECT_API_KEY_BASE64"]
    api_key_content = Base64.decode64(api_key_base64)

    Fastlane::AppStoreConnect::Api.for_key(
      key_id: ENV["APP_STORE_CONNECT_API_KEY_ID"],
      issuer_id: ENV["APP_STORE_CONNECT_API_KEY_ISSUER_ID"],
      key_content: api_key_content
    )
  end
end

GitHub Actions iş akışınızda bu lane’i bundle exec fastlane deploy_to_app_store komutuyla çağırabilirsiniz. Fastlane, bu komutla uygulamanızı App Store Connect’e başarılı bir şekilde yükleyecek ve isteğe bağlı olarak incelemeye gönderecektir. Bu otomasyon, Mac olmadan iOS uygulamalarını App Store’a gönderme sürecini son derece verimli ve güvenilir hale getirir.

Sık Karşılaşılan Sorunlar ve Çözümleri: Hata Ayıklama İpuçları

Mac olmadan GitHub Actions üzerinde iOS uygulama dağıtımı yaparken, çeşitli sorunlarla karşılaşmak olasıdır. Bu sorunlar genellikle sertifika yönetiminden ortam yapılandırmasına, bağımlılık çakışmalarından Fastlane hatalarına kadar geniş bir yelpazede yer alabilir. İşte sık karşılaşılan bazı sorunlar ve bunlara yönelik çözüm ipuçları:

1. Sertifika ve Provisioning Profili Hataları:
* Sorun: “No signing identity found” (İmzalama kimliği bulunamadı) veya “Provisioning profile doesn’t match” (Provisioning profili eşleşmiyor) gibi hatalar.
* Çözüm:
* match kullanıyorsanız, match deposunun doğru olduğundan ve readonly: true modunda bile sertifikaların başarılı bir şekilde indirildiğinden emin olun.
* MATCH_PASSWORD, FASTLANE_USER, FASTLANE_PASSWORD gibi GitHub Secrets’ın doğru ve güncel olduğundan emin olun.
* match komutunu bundle exec fastlane match appstore --force --readonly ile çalıştırarak sertifikaları yeniden indirmeyi deneyin.
* App Store Connect’teki sertifikaların süresinin dolmadığından ve provisioning profillerinin geçerli olduğundan emin olun. Bazen profilleri manuel olarak yenilemek gerekebilir.
* Xcode projenizin “Signing & Capabilities” ayarlarında “Automatically manage signing” seçeneğinin kapalı olduğundan ve Fastlane’in kullandığı profilleri beklediğinden emin olun.

2. Bağımlılık Yükleme Sorunları (Cocoapods, Ruby Gems):
* Sorun: pod install veya bundle install komutları sırasında hatalar, “command not found” (komut bulunamadı) mesajları.
* Çözüm:
* Ruby sürümünün doğru kurulduğundan emin olun. ruby/setup-ruby@v1 Action’ını kullanırken ruby-version parametresini kontrol edin.
* bundle install veya pod install komutlarını çalıştırmadan önce doğru dizine (cd iOSAppKlasoru) geçtiğinizden emin olun.
* bundler-cache: true kullanıyorsanız, Podfile.lock veya Gemfile.lock dosyalarınızın güncel olduğundan emin olun. Bazen önbelleği temizlemek ve yeniden oluşturmak gerekebilir.
* Cocoapods’un sistemde yüklü olduğundan emin olmak için gem install cocoapods adımını ekleyin.

3. Xcode Derleme Hataları:
* Sorun: gym veya xcodebuild komutları sırasında “Build failed” (Derleme başarısız) veya spesifik derleyici hataları.
* Çözüm:
* Hata mesajını dikkatlice okuyun. Genellikle hata, eksik bir kütüphane, yanlış bir ayar veya kodunuzdaki bir hatadan kaynaklanır.
* Xcode projenizin şeması (scheme) ve yapılandırması (configuration) Fastlane’de belirtilenlerle eşleştiğinden emin olun.
* Koşucunun kullandığı Xcode sürümünün projenizle uyumlu olduğundan emin olun. GitHub Actions, farklı Xcode sürümleri sunar (örneğin, macos-latest-xlarge daha güncel Xcode sürümlerine sahip olabilir).
* Yerel Mac’inizde (eğer varsa) veya bir sanal Mac ortamında projeyi derlemeyi deneyerek hatanın kaynağını daha kolay teşhis edebilirsiniz.

4. Fastlane Hataları ve App Store Connect Yükleme Sorunları:
* Sorun: deliver komutu sırasında “App Store Connect API key invalid” (API anahtarı geçersiz) veya “iTunes Connect API limited” (iTunes Connect API limitli) gibi hatalar.
* Çözüm:
* App Store Connect API Anahtarınızın (.p8 dosyası) içeriğinin base64 kodlamasını doğru yaptığınızdan ve APP_STORE_CONNECT_API_KEY_ID, APP_STORE_CONNECT_API_KEY_ISSUER_ID GitHub Secrets’ın doğru olduğundan emin olun.
* API anahtarının süresinin dolmadığından ve gerekli izinlere sahip olduğundan emin olun (App Store Connect’te “Kullanıcılar ve Erişim” bölümünden kontrol edilebilir).
* Apple ID ve şifre ile kimlik doğrulama kullanıyorsanız, FASTLANE_USER ve FASTLANE_PASSWORD‘un doğru olduğundan ve iki faktörlü kimlik doğrulama (2FA) durumunda Fastlane’in bu durumu yönetebildiğinden emin olun. Genellikle 2FA için geçici bir uygulama özgü şifre (app-specific password) oluşturmak daha güvenlidir.
* Fastlane’in güncel sürümünü kullandığınızdan emin olun (bundle update fastlane).

5. Zaman Aşımı (Timeout) Sorunları:
* Sorun: İş akışının belirli bir adımda çok uzun sürmesi ve zaman aşımına uğraması.
* Çözüm:
* Uzun süren adımları (örneğin, bağımlılık yükleme) önbellekleme ile optimize edin.
* Testlerinizi daha verimli hale getirin veya birden fazla işe bölerek paralel çalıştırmayı düşünün.
* Gerekirse, GitHub Actions’ın ücretsiz limitlerini aşmamak için daha küçük, daha odaklı iş akışları oluşturun.

Hata ayıklama sürecinde en önemli ipucu, GitHub Actions’ın sağladığı detaylı logları (kayıtları) dikkatlice incelemektir. Her adımın çıktısı, sorunun nerede olduğunu anlamanıza yardımcı olacak değerli bilgiler içerir. Sabır ve sistematik bir yaklaşımla, karşılaştığınız çoğu sorunu çözebilirsiniz.

Alternatifler ve İleri Düzey Optimizasyonlar: Daha Fazla Güç ve Esneklik

GitHub Actions’ın ücretsiz macOS koşucuları, Mac sahibi olmadan iOS uygulama dağıtımı için harika bir başlangıç noktası sunsa da, projeler büyüdükçe veya daha spesifik ihtiyaçlar ortaya çıktıkça alternatif çözümler ve ileri düzey optimizasyonlar gündeme gelebilir. Bu bölümde, GitHub Actions’ın ötesine geçebilecek seçenekleri ve mevcut iş akışınızı daha verimli hale getirme yollarını inceleyeceğiz.

1. Kendi Barındırılan Koşucular (Self-Hosted Runners):
GitHub Actions, kendi donanımınızda veya sanal sunucunuzda çalışan koşucular kurmanıza izin verir. Eğer bir Mac’e sahipseniz (veya bir sanal Mac sunucusu kiraladıysanız), bunu kendi koşucunuz olarak yapılandırabilirsiniz.
* Avantajları:
* Daha fazla kontrol: İstediğiniz Xcode sürümünü, bağımlılıkları ve özel yazılımları yükleyebilirsiniz.
* Daha uzun çalışma süreleri: GitHub’ın ücretsiz koşucularındaki zaman aşımı ve kota kısıtlamalarına tabi olmazsınız.
* Daha güçlü donanım: Kendi donanımınızın performansını kullanabilirsiniz.
* Dezavantajları:
* Bakım ve maliyet: Donanım ve yazılımın kurulumu, bakımı ve güncellenmesi sizin sorumluluğunuzdadır.
* Güvenlik: Kendi koşucunuzun güvenliğini sağlamak önemlidir.

2. Diğer Bulut Tabanlı CI/CD Hizmetleri:
GitHub Actions tek seçenek değildir. iOS geliştirme için optimize edilmiş birçok başka CI/CD hizmeti bulunmaktadır.
* Bitrise: Özellikle mobil CI/CD için tasarlanmış, güçlü ve görsel bir arayüze sahip bir platformdur. Geniş bir entegrasyon yelpazesi ve önceden tanımlanmış adımları (steps) sayesinde iOS dağıtımını kolaylaştırır. Ücretsiz katmanı mevcuttur.
* CircleCI: Esnek yapılandırma seçenekleri ve güçlü entegrasyonlarıyla bilinen popüler bir CI/CD platformudur. macOS ortamı sunar ve ücretsiz katmanı bulunur.
* Codemagic: Flutter ve iOS/Android uygulamaları için özel olarak tasarlanmış, hızlı ve kullanımı kolay bir CI/CD hizmetidir. Ücretsiz katmanı vardır ve özellikle Flutter projeleri için tercih edilir.
* Azure DevOps Pipelines / GitLab CI/CD: Büyük ölçekli projeler ve kurumsal ortamlar için kapsamlı CI/CD çözümleri sunar. macOS koşucuları mevcuttur ancak genellikle ücretlidir.
Bu platformlar, genellikle daha gelişmiş raporlama, güvenlik özellikleri ve entegrasyonlar sunar. Projenizin büyüklüğüne ve bütçenize göre değerlendirilebilirler.

3. İleri Düzey Optimizasyonlar:
* Matris Derlemeler (Matrix Builds): Uygulamanızı farklı Xcode sürümleri, iOS sürümleri veya cihaz konfigürasyonları üzerinde paralel olarak derlemek ve test etmek için matris stratejilerini kullanabilirsiniz. Bu, test kapsamını artırır ve uyumluluk sorunlarını erken aşamada yakalar.
* Koşullu İş Akışları (Conditional Workflows): Sadece belirli durumlarda (örneğin, main branch’ine yapılan push’larda veya belirli etiketlerle) çalışacak iş akışları tanımlayabilirsiniz. Bu, gereksiz koşucu kullanımını önler ve maliyetleri düşürür.
* Derleme Süresi Optimizasyonu:
* Önbellekleme: actions/cache kullanarak bağımlılıkları (Cocoapods, Carthage, Swift Package Manager) önbelleğe alın.
* Paralel Çalıştırma: Mümkünse, testleri veya farklı derleme adımlarını paralel işlerde çalıştırın.
* İmaj Optimizasyonu: Koşucunun imajını (image) projenizin ihtiyaçlarına göre özelleştirebilirsiniz (eğer kendi koşucunuz varsa).
* Bildirimler ve Raporlama: GitHub Actions’ı Slack, Microsoft Teams veya e-posta gibi araçlarla entegre ederek iş akışı durumları hakkında anında bildirimler alabilirsiniz. Test sonuçlarını GitHub Actions arayüzünde görselleştirmek için uygun formatlarda (örneğin JUnit XML) çıktı almayı sağlayın.
* Güvenlik Entegrasyonları: Statik kod analizi (SwiftLint gibi), güvenlik taramaları ve bağımlılık denetimleri gibi adımları CI/CD iş akışınıza entegre ederek uygulamanızın güvenliğini artırabilirsiniz.

Bu alternatifler ve optimizasyonlar, Mac olmadan iOS uygulama geliştirme ve dağıtım sürecinizi daha sağlam, verimli ve ölçeklenebilir hale getirmenize yardımcı olacaktır. Başlangıçta GitHub Actions’ın ücretsiz macOS koşucuları ile yola çıkmak, bu ileri düzey kavramları öğrenmek ve uygulamak için harika bir temel oluşturur.

Sonuç: Mac’siz iOS Geliştirmenin Geleceği ve Sıkça Sorulan Sorular

Mac sahibi olmadan iOS uygulamalarını App Store’a göndermek, GitHub Actions’ın ücretsiz macOS koşucuları sayesinde artık bir hayal değil, tamamen ulaşılabilir bir gerçektir. Bu makale boyunca, bu iddialı hedefe nasıl ulaşılabileceğini adım adım ele aldık. Geliştiricilerin karşılaştığı donanım maliyeti engelini, bulut tabanlı Sürekli Entegrasyon ve Sürekli Dağıtım (CI/CD) çözümleriyle nasıl aşabileceğimizi, temel kavramlardan ileri düzey optimizasyonlara kadar detaylı bir şekilde inceledik. GitHub Actions’ın esnek yapısı, Fastlane gibi güçlü otomasyon araçlarıyla birleştiğinde, Xcode sertifika yönetiminden uygulamanın derlenmesi, test edilmesi ve App Store Connect’e yüklenmesine kadar tüm süreci otomatikleştirmemize olanak tanır. Bu yaklaşım, sadece maliyet avantajı sağlamakla kalmaz, aynı zamanda geliştirme süreçlerini hızlandırır, hataları azaltır ve genel ürün kalitesini artırır.

Gelecekte, bulut tabanlı geliştirme ve CI/CD çözümlerinin mobil uygulama geliştirme ekosistemindeki rolünün daha da büyümesi beklenmektedir. Apple’ın kendi donanım kısıtlamalarına rağmen, bu tür otomasyon platformları sayesinde iOS geliştirme daha erişilebilir hale gelmekte, yetenekli yazılımcıların önündeki engeller kalkmaktadır. Bu durum, mobil uygulama pazarında daha fazla yenilik ve rekabet anlamına gelmektedir. Artık bir Mac’e sahip olmak, iOS geliştiricisi olmak için bir zorunluluk olmaktan çıkmış, bir tercih meselesi haline gelmiştir. Bu dönüşüm, yazılım geliştirme dünyasında demokratikleşmenin önemli bir adımıdır.

Sıkça Sorulan Sorular

1. Mac olmadan iOS uygulaması geliştirmek gerçekten mümkün mü?
   Evet, kesinlikle mümkün. GitHub Actions’ın ücretsiz macOS koşucuları gibi bulut tabanlı CI/CD hizmetleri sayesinde, kodunuzu bir Mac ortamında derleyebilir, test edebilir ve App Store’a gönderebilirsiniz. Kendi yerel bilgisayarınız Windows veya Linux tabanlı olabilir, sadece kodunuzu yazmak için bir IDE’ye (örneğin, VS Code, AppCode) ihtiyacınız var.
2. GitHub Actions’ın ücretsiz macOS koşucularının limitleri nelerdir?
   GitHub Actions, açık kaynak projeleri ve bireysel kullanıcılar için belirli bir ücretsiz kullanım kotası sunar. Bu genellikle ayda binlerce dakika çalışma süresi anlamına gelir. Bu kota, çoğu küçük ve orta ölçekli proje için yeterlidir. Limit aşıldığında, dakika başına cüzi bir ücret ödeyerek kullanıma devam edebilirsiniz. Detaylı ve güncel limitler için GitHub Actions fiyatlandırma sayfasına bakmanız önerilir.
3. Sertifika ve provisioning profili yönetimi güvenli mi?
   Evet, Fastlane’in match aracı ve GitHub Secrets’ı kullanarak sertifika ve provisioning profillerini güvenli bir şekilde yönetebilirsiniz. match, sertifikalarınızı şifreli bir git deposunda saklar ve sadece yetkili CI/CD ortamlarının erişmesine izin verir. GitHub Secrets ise hassas bilgilerinizi (şifreler, API anahtarları) şifreli bir şekilde saklar ve iş akışı sırasında güvenli bir şekilde erişilmesini sağlar.
4. Hangi Fastlane araçları bu süreçte kritik rol oynar?
   Bu süreçte en kritik Fastlane araçları şunlardır:
   • match: Sertifika ve provisioning profili yönetimi için.
   • gym: Uygulamayı derlemek ve .ipa dosyası oluşturmak için.
   • scan: Uygulamanın birim ve UI testlerini çalıştırmak için.
   • deliver: Uygulamayı App Store Connect’e yüklemek ve meta verileri yönetmek için.
5. Bu yöntemin dezavantajları var mı?
   Evet, bazı dezavantajları olabilir:
   • Hata Ayıklama Zorluğu: Yerel bir Mac’iniz olmadığında, CI/CD ortamındaki hataları ayıklamak bazen daha zorlayıcı olabilir. Logları dikkatlice incelemek ve küçük değişikliklerle denemeler yapmak gerekebilir.
   • Performans ve Zaman Aşımı: Ücretsiz koşucuların performansı sınırlı olabilir ve yoğun projelerde derleme süreleri uzayabilir, bu da zaman aşımı sorunlarına yol açabilir.
   • Xcode Güncellemeleri: GitHub Actions koşucuları genellikle güncel Xcode sürümlerini sunsa da, belirli bir eski Xcode sürümüne ihtiyacınız varsa veya bir güncelleme sonrası uyumsuzluk yaşarsanız kontrolünüz daha sınırlı olabilir.

#iOSGeliştirme #GitHubActions #CI/CD #MacOlmadan #AppStore #Fastlane #OtomatikDağıtım