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

Swift Package Manager

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

Xcode aracılığıyla

Swift Package Manager desteği için 16.2 veya sonraki sürümler gerekir.

  1. CocoaPods tabanlı bir projeden geçiş 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üvenle silinebilir. Firebase'i bir projeye ilk kez ekliyorsanız bu adımı yoksayabilirsiniz.

  2. Xcode'da File > Add Packages (Dosya > Paket Ekle) seçeneğine 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 Package.swiftmanifest aracılığıyla bir Swift paketine 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 herhangi bir hedefte bu bağımlılığı ilgili hedefin dependencies dizisine ekleyin.

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

Ürüne özel hususlar

Bazı Firebase ürünlerinin doğru şekilde ç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 gerektiriyor.

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 kullanabileceğiniz bir diğer seçenek ise upload-symbols komut dosyasını kullanmaktır. Komut dosyasını proje dosyanızın bir alt dizinine (örneğin 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. Kullanım notları ve komut dosyasıyla ilgili 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 destekler.

Firebase'in CocoaPods dağıtımı için Xcode 16.2 ve CocoaPods 1.12.0 veya üzeri sürümler gerekir. CocoaPods kullanarak Firebase'i nasıl yükleyeceğiniz 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 etkin 

    # 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 şekilde çalışması için ek entegrasyon adımları gerekir.

Crashlytics

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

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

Carthage desteği deneyseldir. Carthage aracılığıyla Firebase'i uygulamanıza dahil etme talimatlarını GitHub'da bulabilirsiniz.

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ılabilir tüm hedef mimarilere yönelik mimari dilimleri içerdiğinden indirilmesi biraz zaman alabilir.

  2. Dosyayı açın ve uygulamanıza eklemek istediğiniz çerçeveler için README dosyasını inceleyin.

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