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

Swift Paket Yöneticisi

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

Xcode ile

Swift Package Manager desteği, 14.1 veya üzerini gerektirir.

  1. CocoaPods tabanlı bir projeden taşıma işlemi gerçekleştiriyorsanı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üvenli bir şekilde silinebilir. Firebase'i bir projeye ilk kez ekliyorsanız bu adım yoksayılabilir.

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

Bitirdiğinizde Xcode paket bağımlılıklarınızı çözümlemeye ve bunları arka planda indirmeye başlar.

Package.swift üzerinden

Firebase'i Package.swift manifest 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"),
  // ...

],

Daha sonra, bir Firebase ürününe bağlı herhangi bir hedefte, bunu söz konusu hedefin dependencies dizisine ekleyin.

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

Ürüne özel dikkat edilmesi gereken noktalar

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

Google Analytics

Google Analytics, geçişli olarak dahil edilirse -ObjC bağlayıcı işaretinin hedefinizin derleme ayarlarına eklenmesini gerektirir.

Crashlytics

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

Geliştirme sonrası hata ayıklama simgelerini otomatik olarak yüklemek amacıyla Xcode için bir komut dosyası derleme aşamasını kullanabilirsiniz. Çalıştır komut dosyasını burada bulabilirsiniz:

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

Simgeleri yüklemenin bir diğer yolu da upload-symbols komut dosyasını kullanmaktır. Komut dosyasını proje dosyanızın bir alt dizinine (örneğin, 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. Kullanım notları ve komut dosyasıyla ilgili ek talimatlar için upload-symbols parametresini hiçbir 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 14.1 ve CocoaPods 1.12.0 veya sonraki sürümleri gerekir. CocoaPods'u kullanarak Firebase'i şu şekilde yükleyebilirsiniz:

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

    pod init

  2. Uygulamanızda kullanmak istediğiniz Firebase kapsüllerini Podfile'ınıza 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ığı belgelerinde bulabilirsiniz.

    Analiz 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 ve projeyi Xcode'da görmek için .xcworkspace dosyanızı açın:

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

Ürüne özel dikkat edilmesi gereken noktalar

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

Crashlytics

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

Geliştirme sonrası hata ayıklama simgelerini otomatik olarak yüklemek amacıyla Xcode için bir komut dosyası derleme aşamasını kullanabilirsiniz. Çalıştır komut dosyasını burada bulabilirsiniz:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Kartaca

Carthage desteği deneyseldir. Carthage aracılığıyla Firebase'i uygulamanıza eklemek için GitHub ile ilgili talimatları inceleyin.

Manuel olarak entegre etme

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

  1. framework SDK zip'ini indirin. Bu dosya, tüm Firebase SDK'larında mevcut hedef mimarilerin tamamı için mimari dilimleri içerdiğinden indirilmesi biraz zaman alabilir.

  2. Dosyayı arşivden çıkartın, ardından uygulamanıza eklemek istediğiniz çerçeveler için README bölümünü inceleyin.

  3. Hedefinizin derleme ayarlarındaki Other Linker Settings bölümüne -ObjC bağlayıcı işaretini ekleyin.