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 14.1 veya sonraki sürümleri gerektirir.

  1. CocoaPods tabanlı bir projeden veri taşıyorsanız pod deintegrate komutunu çalıştırarak Xcode projenizden CocoaPods'lar. CocoaPods tarafından .xcworkspace oluşturuldu sonra güvenle silebilirsiniz. Bir projeye Firebase ekliyorsanız bu adımı yoksayabilirsiniz.

  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ü dikkat edilmesi gereken noktalar

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

Google Analytics

Google Analytics, hedefinizin-ObjC geçişli olarak dahil ediliyorsa derleme ayarlarını değiştirin.

Crashlytics

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

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:

${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 alt dizinine (örneğin,) yerleştirin scripts/upload-symbols) kullanıyorsanız 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ı için ve komut dosyası için ek talimatlar kullanıyorsanız, upload-symbols dosyasını hiç parametreleridir.

CocoaPods

Firebase, CocoaPod'lar farklı seçenekler vardır.

Firebase'in CocoaPods dağıtımı için Xcode 14.1 ve CocoaPods 1.12.0 veya sonraki sürümler. 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'da bulabilirsiniz. Kullanıcı Gizliliği ve Veri Kullanımı ve Uygulama izleme şeffaflığı belgelerinden faydalanabilirsiniz.

    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 ş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 gerektirir.

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.