Swift Paket Yöneticisi
Firebase Apple SDK'sının v8.0.0 sürümünden itibaren, Firebase'in Swift Paket Yöneticisi desteği beta sürümü dışındadır ve genel kullanıma açıktır. Swift Paket Yöneticisi kullanıcıları için CocoaPods gerekli değildir.
Firebase sürüm 8 ve üzeri için önerilen yükleme yöntemi Swift Paket Yöneticisi'dir.
Xcode ile
Swift Paket Yöneticisi desteği 13.3.1 veya üzeri gerektirir.
CocoaPods tabanlı bir projeden geçiş yapıyorsanız, CocoaPod'ları 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.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 projeler için Firebase'in en yeni sürümünü kullanmanızı öneririz.
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
Firebase'i bir Package.swift
bildirimi aracılığıyla bir Swift paketine entegre etmek için paketinizin dependencies
dizisine Firebase 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, onu o hedefin dependencies
dizisine ekleyin.
.target(
name: "MyTargetName",
dependencies: [
.product(name: "FirebaseAuth", package: "Firebase"),
// ...
]
),
Ürüne özel hususlar
Bazı Firebase ürünleri, düzgün çalışması için ekstra entegrasyon adımları gerektirir.
Google Analytics
Google Analytics, geçişli olarak dahil edilmişse, hedefinizin yapı ayarlarına -ObjC
bağlayıcı bayrağının eklenmesini gerektirir.
Crashlytics
Crashlytics, hata ayıklama sembollerini yüklemenizi gerektirir.
Derleme sonrası hata ayıklama sembollerini otomatik olarak yüklemek için Xcode için bir çalıştırma komut dosyası oluşturma 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. Komut dosyasını proje dosyanızın bir alt dizinine yerleştirin (örneğin scripts/upload-symbols
), 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ına ilişkin 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 13.3.1 ve CocoaPods 1.10.0 veya üstünü gerektirir. Firebase'i CocoaPods kullanarak nasıl kuracağınız aşağıda açıklanmıştır:
Henüz yoksa bir Pod dosyası 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 bölmelerini ekleyin.
Desteklenen Firebase ürünlerinden herhangi birini uygulamanıza ekleyebilirsiniz.
Analytics 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.
Analytics 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'
Bölmeleri kurun, ardından projeyi Xcode'da görmek için
.xcworkspace
dosyanızı açın:pod install --repo-update
tutucu9 l10n-yeropen your-project.xcworkspace
Ürüne özel hususlar
Bazı Firebase ürünleri, düzgün çalışması için ekstra entegrasyon adımları gerektirir.
Crashlytics
Crashlytics, hata ayıklama sembollerini yüklemenizi gerektirir.
Derleme sonrası hata ayıklama sembollerini otomatik olarak yüklemek için Xcode için bir çalıştırma komut dosyası oluşturma 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 yüklemek için:
Çerçeve SDK zip dosyasını indirin. Bu dosya, tüm Firebase SDK'ları için mevcut tüm hedef mimariler için mimari dilimleri içerir ve bu nedenle indirilmesi biraz zaman alabilir.
Dosyayı açın, ardından uygulamanıza dahil etmek istediğiniz çerçeveler için
README
.-ObjC
bağlayıcı bayrağını , hedefinizin oluşturma ayarlarındakiOther Linker Settings
ekleyin.