Firebase'i Apple uygulamanıza yükleyin

Swift Paket Yöneticisi

Firebase, yeni projeler için Swift Paket Yöneticisini önerir.

Xcode aracılığıyla

Swift Paket Yöneticisi desteği 14.1 veya üzerini gerektirir.

  1. CocoaPods tabanlı bir projeden geçiş yapıyorsanız, CocoaPod'ları 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 göz ardı edilebilir.

  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.

İşiniz bittiğinde Xcode, paket bağımlılıklarınızı çözmeye ve bunları arka planda indirmeye başlayacaktır.

Package.swift aracılığıyla

Firebase'i bir Package.swift bildirimi aracılığıyla bir Swift paketine entegre etmek için Firebase'i paketinizin dependencies dizisine ekleyebilirsiniz. Daha fazla ayrıntı için Swift Paket Yöneticisi belgelerine bakın.

dependencies: [

  .package(name: "Firebase",
           url: "https://github.com/firebase/firebase-ios-sdk.git",
           from: "8.0"),
  // ...

],

Daha sonra Firebase ürününe bağlı olan herhangi bir hedefte, onu o hedefin dependencies dizisine ekleyin.

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

Ürüne özel hususlar

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

Google Analytics

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

Crashlytics

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

Derleme sonrasında hata ayıklama sembollerini otomatik olarak yüklemek için Xcode için bir komut dosyası çalıştırma aşamasını kullanabilirsiniz. Çalıştırma komut dosyasını burada bulun:

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

Sembolleri yüklemek için başka bir seçenek de upload-symbols komut dosyasını kullanmaktır. Komut dosyasını proje dosyanızın bir alt dizinine yerleştirin (örneğin scripts/upload-symbols ), ardından komut dosyasının çalıştırılabilir 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ına ilişkin kullanım notları ve ek talimatlar için, herhangi bir parametre olmadan upload-symbols çalıştırın.

CocoaPod'lar

Firebase, Swift Paket Yöneticisine ek olarak CocoaPod'larla kurulumu destekler.

Firebase'in CocoaPods dağıtımı, Xcode 14.1 ve CocoaPods 1.12.0 veya üstünü gerektirir. Firebase'i CocoaPod'ları kullanarak nasıl yükleyeceğiniz aşağıda açıklanmıştır:

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

    pod init
  2. Uygulamanızda kullanmak istediğiniz Firebase bölmelerini Pod dosyanıza ekleyin.

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

    Analiz 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'

    Apple'ın Kullanıcı Gizliliği ve Veri Kullanımı ve Uygulama İzleme Şeffaflığı belgelerinde cihaz düzeyinde reklam tanımlayıcı olan IDFA hakkında daha fazla bilgi edinin.

    Analiz 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. Bölmeleri 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 düzgün çalışması için ekstra entegrasyon adımları gerekir.

Crashlytics

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

Derleme sonrasında hata ayıklama sembollerini otomatik olarak yüklemek için Xcode için bir komut dosyası çalıştırma aşamasını kullanabilirsiniz. Çalıştırma komut dosyasını burada bulun:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Kartaca

Kartaca desteği deneyseldir. Firebase'i Carthage aracılığıyla uygulamanıza dahil etmek için GitHub'daki talimatlara bakın.

Manuel olarak entegre edin

Firebase, Firebase'i bir 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. Çerçeve SDK zip dosyasını indirin. Bu dosya, tüm Firebase SDK'ları için mevcut tüm hedef mimarilere yönelik mimari dilimler içerir ve bu nedenle indirilmesi biraz zaman alabilir.

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

  3. Hedefinizin derleme ayarlarındaki Other Linker Settings Ayarlarınıza -ObjC bağlayıcı bayrağını ekleyin.