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 yapıyorsanız pod deintegrate komutunu çalıştırarak CocoaPods'u Xcode projenizden kaldırın. CocoaPods tarafından oluşturulan .xcworkspace dosyası daha sonra güvenli bir şekilde silinebilir. Firebase'i bir projeye ilk kez ekliyorsanız bu adımı atlayabilirsiniz.

2. Xcode'da File > Add Packages (Dosya > Paket Ekle) bölümüne 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 dahil etmek 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 Package.swift manifest aracılığıyla Swift paketine entegre etmek için Firebase'i paketinizin dependencies dizisine ekleyebilirsiniz. Daha fazla bilgi için Swift Package Manager dokümanlarına 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 herhangi bir hedefte bu bağımlılığı hedefin dependencies dizisine ekleyin.

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

Ürüne özel hususlar

Bazı Firebase ürünlerinin doğru ç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 sembolleri yüklemenizi gerektirir.

Derleme sonrası hata ayıklama sembollerini otomatik olarak yüklemek için Xcode'da bir run script build phase kullanabilirsiniz. Çalıştırma komut dosyasını burada bulabilirsiniz:

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

Sembol yüklemek için 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ının kullanım notları ve ek talimatları için upload-symbols komutunu 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 bir sürüm gerekir. CocoaPods'u kullanarak Firebase'i yükleme adımları aşağıda açıklanmıştır:

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

   pod init

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

   Uygulamanıza desteklenen Firebase ürünlerinden herhangi birini 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 tanımlayıcısı olan IDFA hakkında daha fazla bilgiyi Apple'ın User Privacy and Data Use (Kullanıcı Gizliliği ve Veri Kullanımı) ve App Tracking Transparency (Uygulama Takibinde Şeffaflık) belgelerinde bulabilirsiniz.

   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'leri 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 özel hususlar

Bazı Firebase ürünlerinin doğru çalışması için ek entegrasyon adımları gerekir.

Crashlytics

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

Derleme sonrası hata ayıklama sembollerini otomatik olarak yüklemek için Xcode'da bir run script build phase kullanabilirsiniz. Çalıştırma komut dosyasını burada bulabilirsiniz:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Kartaca

Kartaca desteği deneyseldir. Firebase'i Carthage aracılığıyla uygulamanıza dahil etme hakkında GitHub'daki talimatları inceleyin.

Manuel olarak entegre etme

Firebase, Firebase'i bağımlılık yöneticisi kullanmadan 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. Framework SDK zip dosyasını indirin. Bu dosya, tüm Firebase SDK'ları için kullanılabilen tüm hedef mimarilerle ilgili mimari dilimleri içerir. Bu nedenle, indirilmesi biraz zaman alabilir.

2. Dosyayı açın, ardından uygulamanıza eklemek istediğiniz çerçeveler için README simgesini inceleyin.

3. Hedefinizin derleme ayarlarına Other Linker Settings -ObjC bağlayıcı işareti ekleyin.