Apple uygulamanızda Firebase'i yükleme seçenekleri

Swift Package Manager

Firebase, yeni projeler için Swift Package Manager'ı önerir.

Xcode üzerinden

Swift Package Manager desteği için 26.2 veya sonraki bir sürüm gerekir.

1. CocoaPods tabanlı bir projeden taşıma işlemi yapıyorsanız Xcode projenizden CocoaPods'u kaldırmak için pod deintegrate komutunu çalıştırın. CocoaPods tarafından oluşturulan .xcworkspace dosyası daha sonra güvenle silinebilir. Firebase'i bir projeye ilk kez ekliyorsanız bu adımı yoksayabilirsiniz.

2. Xcode'da File > Add Packages'a (Dosya > Paket Ekle) giderek Firebase kitaplıklarını yükleyin.

3. Görüntülenen istemde Firebase GitHub deposunu seçin:

   https://github.com/firebase/firebase-ios-sdk.git
   

4. Kullanmak istediğiniz Firebase sürümünü seçin. Yeni projeler için Firebase'in en yeni sürümünü kullanmanızı öneririz.

5. Uygulamanıza eklemek istediğiniz Firebase kitaplıklarını seçin.

İşlemi tamamladığınızda Xcode, paket bağımlılıklarınıza çözüm bulmaya ve bunları arka planda indirmeye başlar.

Package.swift üzerinden

Firebase'i bir Swift paketine Package.swift manifesti aracılığıyla entegre etmek için Firebase'i paketinizin dependencies dizisine ekleyebilirsiniz. Daha fazla bilgi için Swift Package Manager belgelerine bakın.

dependencies: [

  .package(name: "Firebase",
           url: "https://github.com/firebase/firebase-ios-sdk.git",
           from: "8.0"),
  // ...

],

Ardından, Firebase ürününe bağlı olan tüm hedeflerde bu ürünü ilgili hedefin dependencies dizisine ekleyin.

.target(
  name: "MyTargetName",
  dependencies: [
    .product(name: "FirebaseAuth", package: "Firebase"),
    // ...
  ]
),

Ürüne özgü dikkat edilmesi gereken noktalar

Bazı Firebase ürünlerinin düzgün çalışması için ek entegrasyon adımları gerekir.

Google Analytics

Google Analytics, geçişli olarak dahil edilmişse hedefinizin derleme ayarlarına -ObjC bağlayıcı işaretinin eklenmesini gerektirir.

Crashlytics

Crashlytics, hata ayıklama simgeleri yüklemenizi gerektiriyor.

Derleme sonrasında hata ayıklama sembollerini otomatik olarak yüklemek için Xcode'da komut dosyası çalıştırma derleme aşamasını kullanabilirsiniz. Çalıştırma komut dosyasını burada bulabilirsiniz:

${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run

Sembolleri yüklemek için kullanabileceğiniz bir diğer seçenek de upload-symbols komut dosyasını kullanmaktır. Komut dosyasını proje dosyanızın bir alt dizinine (ör. scripts/upload-symbols) yerleştirin ve komut dosyasının yürütülebilir olduğundan emin olun:

chmod +x scripts/upload-symbols

Bu komut dosyası, dSYM dosyalarını manuel olarak yüklemek için kullanılabilir. Komut dosyasıyla ilgili kullanım notları ve ek talimatlar için upload-symbols komutunu herhangi bir parametre olmadan çalıştırın.

CocoaPods

Firebase, Swift Package Manager'ın yanı sıra CocoaPods ile yüklemeyi de destekler.

Firebase'in CocoaPods dağıtımı için Xcode 26.2 ve CocoaPods 1.12.0 veya sonraki sürümler gerekir. CocoaPods kullanarak Firebase'i nasıl yükleyeceğiniz aşağıda açıklanmıştır:

1. Henüz bir Podfile'ınız yoksa oluşturun. Proje dizininizin kökünden aşağıdaki komutu çalıştırın:

   pod init

2. Uygulamanızda kullanmak istediğiniz Firebase pod'larını Podfile'ınıza ekleyin.

   Desteklenen Firebase ürünlerinden herhangi birini uygulamanıza ekleyebilirsiniz.

   Analytics etkinleştirildi

   # Add the Firebase pod for Google Analytics
   pod 'FirebaseAnalytics'
   
   # For Analytics without IDFA collection capability, use this pod instead
   # pod FirebaseAnalytics/Core
   
   # Add the pods for any other Firebase products you want to use in your app
   # For example, to use Firebase Authentication and Cloud Firestore
   pod 'FirebaseAuth'
   pod 'FirebaseFirestore'

   Cihaz düzeyinde reklam kimliği olan IDFA hakkında daha fazla bilgi edinmek için Apple'ın Kullanıcı Gizliliği ve Veri Kullanımı ve Uygulama İzleme Şeffaflığı belgelerini inceleyin.

   Analytics etkinleştirilmedi

   # Add the pods for the Firebase products you want to use in your app
   # For example, to use Firebase Authentication and Cloud Firestore
   pod 'FirebaseAuth'
   pod 'FirebaseFirestore'

3. Pod'ları yükleyin, ardından projeyi Xcode'da görmek için .xcworkspace dosyanızı açın:

   pod install --repo-update

   open your-project.xcworkspace

Ürüne özgü hususlar

Bazı Firebase ürünlerinin düzgün çalışması için ek entegrasyon adımları gerekir.

Crashlytics

Crashlytics, hata ayıklama sembolleri yüklemenizi gerektiriyor.

Derleme sonrasında hata ayıklama sembollerini otomatik olarak yüklemek için Xcode'da komut dosyası çalıştırma derleme aşamasını kullanabilirsiniz. Çalıştırma komut dosyasını burada bulabilirsiniz:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Carthage

Carthage desteği deneyseldir. Carthage aracılığıyla uygulamanıza Firebase ekleme talimatları için GitHub'daki talimatları inceleyin.

Manuel olarak entegre etme

Firebase, bağımlılık yöneticisi kullanmadan Firebase'i entegre etmek isteyen kullanıcılar için önceden oluşturulmuş bir ikili XCFramework dağıtımı sağlar. Firebase'i yüklemek için:

1. Çerçeve SDK'sı ZIP dosyasını indirin. Bu dosya, tüm Firebase SDK'ları için mevcut tüm hedef mimarilere ait mimari dilimlerini içerir. Bu nedenle, indirme işlemi biraz zaman alabilir.

2. Dosyanın sıkıştırmasını açın, ardından uygulamanıza eklemek istediğiniz çerçeveler için README dosyasını inceleyin.

3. Hedefinizin derleme ayarlarındaki Other Linker Settings dosyanıza -ObjC bağlayıcı işaretini ekleyin.