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 15.2 veya sonraki bir sürüm gerekir.

  1. CocoaPods tabanlı bir projeden geçiş yapıyorsanız CocoaPods'u Xcode projenizden 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ı atlayabilirsiniz.

  2. Xcode'da Dosya > Paket Ekle'ye 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 projelerde 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 bir Package.swift manifesti aracılığıyla 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, bir Firebase ürününe bağlı olan herhangi bir hedefte bu ürünü ilgili hedefin dependencies dizisine ekleyin.

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

Ürüne özgü hususlar

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

Google Analytics

Google Analytics, aktarmalı olarak dahil edilmişse -ObjC bağlayıcı işaretini hedefinizin derleme ayarlarına eklemenizi 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 komut dosyası çalıştırma derleme aşaması kullanabilirsiniz. Çalıştırma komut dosyasını burada bulabilirsiniz:

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

Simge yüklemek için upload-symbols komut dosyasını da kullanabilirsiniz. Komut dosyasını proje dosyanızın bir alt dizinine (ör. scripts/upload-symbols) yerleştirin ve ardından 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ı ile ilgili kullanım notları ve ek talimatlar için upload-symbols komutunu parametre olmadan çalıştırın.

CocoaPods

Firebase, Swift Package Manager'a ek olarak CocoaPods ile yüklemeyi destekler.

Firebase'ın CocoaPods dağıtımı için Xcode 15.2 ve CocoaPods 1.12.0 veya üzeri sürümler gerekir. Firebase'i CocoaPods kullanarak yüklemek için:

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

    pod init
  2. Pod dosyanıza, uygulamanızda kullanmak istediğiniz Firebase kapsüllerini ekleyin.

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

    Analytics etkin

    # Add the Firebase pod for Google Analytics
    pod 'FirebaseAnalytics'
    
    # For Analytics without IDFA collection capability, use this pod instead
    # pod ‘Firebase/AnalyticsWithoutAdIdSupport’
    
    # 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 bilgiyi Apple'ın Kullanıcı Gizliliği ve Veri Kullanımı ile Uygulama İzleme Şeffaflığı dokümanlarından edinebilirsiniz.

    Analytics etkin değil

    # 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. Kapsülleri 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 şekilde çalışabilmesi 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 komut dosyası çalıştırma derleme aşaması kullanabilirsiniz. Çalıştırma komut dosyasını burada bulabilirsiniz:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Kartaca

Carthage desteği deneyseldir. Firebase'i Carthage aracılığıyla uygulamanıza dahil etmeyle ilgili GitHub'daki talimatları inceleyin.

Manuel olarak entegrasyon

Firebase, bağımlılık yöneticisi kullanmadan Firebase'i entegre etmek isteyen kullanıcılar için önceden derlenmiş bir 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 kullanılabilen tüm hedef mimarilerin mimari dilimlerini içerir. Bu nedenle, indirmesi biraz zaman alabilir.

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

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