Firebase'i Apple uygulamanıza yükleyin

Hızlı Paket Yöneticisi

Firebase Apple SDK'nın v8.0.0 sürümünden başlayarak, Firebase'in Swift Paket Yöneticisi desteği beta sürümünden çıktı ve genel kullanıma açıldı. Swift Paket Yöneticisi kullanıcıları için CocoaPods gerekli değildir.

Firebase sürüm 8 ve üzeri için önerilen kurulum yöntemi Swift Paket Yöneticisi'dir.

Xcode ile

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

1. CocoaPods tabanlı bir projeden geçiş yapıyorsanız, CocoaPods'u Xcode projenizden kaldırmak için pod deintegrate ç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ı kurun

3. Görünen 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 yoluyla 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"),
  // ...

],

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

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

Ürüne özgü 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 edilmişse, hedefinizin yapı ayarlarına -ObjC linker bayrağının eklenmesini gerektirir.

Crashlytics

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

Yapım sonrası hata ayıklama sembollerini otomatik olarak yüklemek için Xcode için bir çalıştırma betiği derleme aşaması kullanabilirsiniz. Çalıştır 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. Betiği proje dosyanızın bir alt dizinine yerleştirin (örneğin scripts/upload-symbols ), ardından betiğin 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ı için kullanım notları ve ek talimatlar için upload-symbols herhangi bir parametre olmadan çalıştırın.

CocoaPod'lar

Firebase, Swift Paket Yöneticisine ek olarak CocoaPods ile kurulumu destekler.

Firebase'in CocoaPods dağıtımı, Xcode 14.1 ve CocoaPods 1.10.0 veya üstünü gerektirir. CocoaPods kullanarak Firebase'i şu şekilde kurabilirsiniz:

1. Henüz sahip değilseniz 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 bölmelerini ekleyin.

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

   Analitik etkinleştirildi

   # 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ısı olan IDFA hakkında daha fazla bilgi edinin.

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

   İkili Firebase bağımlılıkları, varsayılan olarak statik çerçeveler olarak entegre edilmiştir. Firebase'i dinamik bir çerçevenin bağımlılığı olarak kullanıyorsanız, Firebase'i bir çerçeveden veya kitaplıktan kullanmayla ilgili belgeleri okuduğunuzdan emin olun.

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 özgü 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.

Yapım sonrası hata ayıklama sembollerini otomatik olarak yüklemek için Xcode için bir çalıştırma betiği derleme aşaması kullanabilirsiniz. Çalıştır 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, bir bağımlılık yöneticisi kullanmadan Firebase'i entegre etmek isteyen kullanıcılar için önceden oluşturulmuş bir ikili XCFramework dağıtımı sağlar. Firebase'i kurmak için:

1. Çerçeve SDK zip dosyasını indirin. Bu dosya, tüm Firebase SDK'ları için mevcut tüm hedef mimariler için mimari dilimler içerir ve bu nedenle indirilmesi biraz zaman alabilir.

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

3. -ObjC bağlayıcı bayrağını, hedefinizin yapı ayarlarında Other Linker Settings ekleyin.