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

Swift Paket Yöneticisi

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

Xcode aracılığıyla

Swift Package Manager desteği 15.2 veya sonraki bir sürümü gerektirir.

  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 .xcworkspace oluşturuldu sonra güvenle silebilirsiniz. Firebase'i bir projeye ilk kez ekliyorsanız bu adımı atlayabilirsiniz.

  2. Xcode'da, şu konuma giderek Firebase kitaplıklarını yükleyin: Dosya > Paket Ekle'yi tıklayın.

  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 eklemek istediğiniz Firebase kitaplıklarını seçin.

İşiniz bittiğinde Xcode paket bağımlılıklarınızı çözümlemeye başlar ve arka planda indirir.

Package.swift üzerinden

Firebase'i Package.swift manifest dosyası aracılığıyla bir Swift paketine entegre etmek için: Firebase'i, paketinizin dependencies dizisine ekleyin. Daha fazla bilgi için bkz. "the" Swift Package Manager belgeleri.

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 bunu dependencies dizisi anlamına gelir.

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

Ürüne özgü hususlar

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

Google Analytics

Google Analytics, aktarmalı olarak dahil edilmişse hedefinizin derleme ayarlarına -ObjC bağlayıcı işaretinin eklenmesi 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ı şu adreste bulabilirsiniz:

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

Sembol yüklemenin bir diğer seçeneği de upload-symbols komut dosyası. Komut dosyasını proje dosyanızın bir alt dizinine (ör. scripts/upload-symbols) yerleştirin, 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. Nasıl yükleyeceğiniz aşağıda açıklanmıştır CocoaPods kullanan Firebase:

  1. Henüz yoksa bir Podfile oluşturun. Bu aşağıdaki komutu çalıştırın:

    pod init

  2. Uygulamanızda kullanmak istediğiniz Firebase kapsüllerini Podfile'ınıza ekleyin.

    Desteklenen metinlerden herhangi birini Firebase ürünlerini uygulamanıza ekleyin.

    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 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. Kapsülleri yükleyin, ardından projeyi şurada görmek için .xcworkspace dosyanızı açın: X kodu:

    pod install --repo-update
     
    open your-project.xcworkspace

Ürüne özgü dikkat edilmesi gereken noktalar

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

Crashlytics

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

Xcode için komut dosyası derleme aşamasını kullanarak hata ayıklama işlemini otomatik olarak yükleyebilirsiniz görebilirsiniz. Çalıştırma komut dosyasını şu adreste bulabilirsiniz:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Kartaca

Carthage desteği deneyseldir. Bkz. GitHub'daki talimatlar Firebase'i uygulamanıza Carthage aracılığıyla dahil ettiğinizden emin olun.

Manuel olarak entegre etme

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

  1. framework SDK'sının ZIP dosyasını indirin. Bu dosya mimari dilimlerini içeriyor hedef mimariler için çalıştığından emin olun. Bu nedenle, indirilmesi biraz zaman alabilir.

  2. Dosyayı arşivden çıkartın, ardından yüklemek istediğiniz çerçeveler için README dosyasını inceleyin dahil edin.

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