Swift Package Manager
Firebase, yeni projeler için Swift Package Manager'ı önerir.
Xcode üzerinden
Swift Package Manager desteği için 15.2 veya sonraki bir sürüm gerekir.
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 oluşturulan.xcworkspace
dosyası daha sonra güvenle silinebilir. Firebase'i bir projeye ilk kez ekliyorsanız bu adımı atlayabilirsiniz.Xcode'da Dosya > Paket Ekle'ye giderek Firebase kitaplıklarını yükleyin.
Görüntülenen istemde Firebase GitHub deposunu seçin:
https://github.com/firebase/firebase-ios-sdk.git
Kullanmak istediğiniz Firebase sürümünü seçin. Yeni projelerde Firebase'in en yeni sürümünü kullanmanızı öneririz.
Uygulamanıza dahil etmek istediğiniz Firebase kitaplıklarını seçin.
İşlemi tamamladığınızda Xcode, paket bağımlılıklarınıza çözüm bulmaya ve bunları arka planda indirmeye başlar.
Package.swift
üzerinden
Firebase'i bir Package.swift
manifesti aracılığıyla 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"),
// ...
],
Ardından, bir Firebase ürününe bağlı olan herhangi bir hedefte bu ürünü ilgili hedefin dependencies
dizisine ekleyin.
.target(
name: "MyTargetName",
dependencies: [
.product(name: "FirebaseAuth", package: "Firebase"),
// ...
]
),
Ürüne özgü hususlar
Bazı Firebase ürünlerinin düzgün şekilde çalışabilmesi için ek entegrasyon adımları gerekir.
Google Analytics
Google Analytics, aktarmalı olarak dahil edilmişse -ObjC
bağlayıcı işaretini hedefinizin derleme ayarlarına eklemenizi gerektirir.
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ı burada bulabilirsiniz:
${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run
Simge yüklemek için upload-symbols
komut dosyasını da kullanabilirsiniz. Komut dosyasını proje dosyanızın bir alt dizinine (ör. scripts/upload-symbols
) yerleştirin ve 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. Firebase'i CocoaPods kullanarak yüklemek için:
Henüz yoksa bir Podfile oluşturun. Proje dizininizin kökünden aşağıdaki komutu çalıştırın:
pod init
Pod dosyanıza, uygulamanızda kullanmak istediğiniz Firebase kapsüllerini 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ığı dokümanlarından edinebilirsiniz.
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'
Kapsülleri 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 şekilde çalışabilmesi için ek entegrasyon adımları 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ı burada bulabilirsiniz:
"${PODS_ROOT}/FirebaseCrashlytics/run"
Kartaca
Carthage desteği deneyseldir. Firebase'i Carthage aracılığıyla uygulamanıza dahil etmeyle ilgili GitHub'daki talimatları inceleyin.
Manuel olarak entegrasyon
Firebase, bağımlılık yöneticisi kullanmadan Firebase'i entegre etmek isteyen kullanıcılar için önceden derlenmiş bir XCFramework dağıtımı sağlar. Firebase'i yüklemek için:
Çerçeve SDK'sı zip dosyasını indirin. Bu dosya, tüm Firebase SDK'ları için kullanılabilen tüm hedef mimarilerin mimari dilimlerini içerir. Bu nedenle, indirmesi biraz zaman alabilir.
Dosyayı açın, ardından uygulamanıza dahil etmek istediğiniz çerçeveler için
README
dosyasını inceleyin.Hedefinizin derleme ayarlarına
Other Linker Settings
-ObjC
bağlayıcı işaretini ekleyin.