Önkoşullar
Aşağıdakileri yükleyin:
- Xcode 13.3.1 veya üstü
Projenizin şu gereksinimleri karşıladığından emin olun:
- Projeniz şu platform sürümlerini veya sonraki sürümleri hedeflemelidir:
- iOS 11
- macOS 10.13
- tvOS 12
- OS 6 izle
- Projeniz şu platform sürümlerini veya sonraki sürümleri hedeflemelidir:
Uygulamanızı çalıştırmak için fiziksel bir Apple aygıtı kurun veya bir simülatör kullanın.
Apple platformlarında Bulut Mesajlaşma için ön koşullar şunlardır:
- Fiziksel bir Apple aygıtı kurun.
- Apple Geliştirici hesabınız için bir Apple Anında Bildirim Kimlik Doğrulama Anahtarı edinin.
- App > Capabilities altında Xcode'da Push Bildirimlerini etkinleştirin.
- Google hesabınızı kullanarak Firebase'de oturum açın .
Halihazırda bir Xcode projeniz yoksa ve yalnızca bir Firebase ürünü denemek istiyorsanız, hızlı başlangıç örneklerimizden birini indirebilirsiniz.
Adım 1 : Bir Firebase projesi oluşturun
Firebase'i Apple uygulamanıza ekleyebilmeniz için uygulamanıza bağlanmak üzere bir Firebase projesi oluşturmanız gerekir. Firebase projeleri hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlayın sayfasını ziyaret edin.
2. Adım : Uygulamanızı Firebase'e kaydedin
Firebase'i Apple uygulamanızda kullanmak için uygulamanızı Firebase projenize kaydetmeniz gerekir. Uygulamanızı kaydettirmek genellikle uygulamanızı projenize "eklemek" olarak adlandırılır.
Firebase konsoluna gidin.
Kurulum iş akışını başlatmak için projeye genel bakış sayfasının ortasındaki iOS+ simgesine tıklayın.
Firebase projenize zaten bir uygulama eklediyseniz platform seçeneklerini görüntülemek için Uygulama ekle'yi tıklayın.
Paket kimliği alanına uygulamanızın paket kimliğini girin.
Bir paket kimliği, Apple'ın ekosistemindeki bir uygulamayı benzersiz şekilde tanımlar.
Paket kimliğinizi bulun: projenizi Xcode'da açın, proje gezgininde en üst düzey uygulamayı seçin, ardından Genel sekmesini seçin.
Paket Tanımlayıcı alanının değeri, paket kimliğidir (örneğin,
com.yourcompany.yourproject
).Paket kimliği değerinin büyük/küçük harfe duyarlı olduğunu ve Firebase projenize kaydedildikten sonra bu Firebase uygulaması için değiştirilemeyeceğini unutmayın.
(İsteğe bağlı) Diğer uygulama bilgilerini girin: Uygulama takma adı ve Uygulama Mağazası Kimliği .
Uygulama takma adı : Firebase konsolunda yalnızca sizin görebileceğiniz dahili, kullanışlı bir tanımlayıcı
App Store Kimliği : Firebase Dynamic Links tarafından kullanıcıları App Store sayfanıza yönlendirmek için ve Google Analytics tarafından dönüşüm etkinliklerini Google Ads'e aktarmak için kullanılır. Uygulamanızın henüz bir App Store Kimliği yoksa, kimliği daha sonra Proje ayarlarınızdan ekleyebilirsiniz.
Uygulamayı kaydet'i tıklayın.
3. Adım : Bir Firebase yapılandırma dosyası ekleyin
Firebase Apple platformları yapılandırma dosyanızı (
GoogleService-Info.plist
) edinmek için GoogleService-Info.plist'i İndir'i tıklayın.Firebase yapılandırma dosyası, projeniz için benzersiz ancak gizli olmayan tanımlayıcılar içerir. Bu yapılandırma dosyası hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama sayfasını ziyaret edin.
Firebase yapılandırma dosyanızı istediğiniz zaman tekrar indirebilirsiniz.
Yapılandırma dosyası adının sonuna
(2)
gibi ek karakterler eklenmediğinden emin olun.
Yapılandırma dosyanızı Xcode projenizin köküne taşıyın. İstenirse, yapılandırma dosyasını tüm hedeflere eklemek için seçin.
Projenizde birden fazla paket kimliğiniz varsa, her uygulamanın kendi GoogleService-Info.plist
dosyasına sahip olabilmesi için her paket kimliğini Firebase konsolunda kayıtlı bir uygulamayla ilişkilendirmeniz gerekir.
4. Adım : Uygulamanıza Firebase SDK'ları ekleyin
Firebase bağımlılıklarını kurmak ve yönetmek için Swift Paket Yöneticisi'ni kullanın.
- Xcode'da, uygulama projeniz açıkken File > Add Packages seçeneğine gidin.
- İstendiğinde, Firebase Apple platformları SDK deposunu ekleyin:
- Kullanmak istediğiniz SDK sürümünü seçin.
Kullanmak istediğiniz Firebase kitaplıklarını seçin.
Firebase projenizde Google Analytics etkinleştirilmişse
FirebaseAnalytics
eklediğinizden emin olun. IDFA toplama özelliği olmayan Analytics için bunun yerineFirebaseAnalyticsWithoutAdId
ekleyin.
https://github.com/firebase/firebase-ios-sdk
Bittiğinde, Xcode otomatik olarak arka planda bağımlılıklarınızı çözmeye ve indirmeye başlayacaktır.
5. Adım : Uygulamanızda Firebase'i başlatın
Son adım, uygulamanıza başlatma kodu eklemektir. Bunu, Firebase'i uygulamanıza eklemenin bir parçası olarak zaten yapmış olabilirsiniz. Bir hızlı başlangıç örnek projesi kullanıyorsanız, bu sizin için yapılmıştır.
-
UIApplicationDelegate
uygulamanızaFirebaseCore
modülünü ve uygulama temsilcinizin kullandığı diğer Firebase modüllerini içe aktarın. Örneğin, Cloud Firestore ve Authentication'ı kullanmak için:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Süratli
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Amaç-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Uygulama temsilcinizin
application(_:didFinishLaunchingWithOptions:)
yönteminde birFirebaseApp
paylaşılan örneği yapılandırın:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Süratli
// Use Firebase library to configure APIs FirebaseApp.configure()
Amaç-C
// Use Firebase library to configure APIs [FIRApp configure];
- SwiftUI kullanıyorsanız, bir uygulama temsilcisi oluşturmalı ve bunu
UIApplicationDelegateAdaptor
veyaNSApplicationDelegateAdaptor
aracılığıylaApp
yapınıza eklemelisiniz. Uygulama temsilcisi swizzling'i de devre dışı bırakmalısınız. Daha fazla bilgi için SwiftUI talimatlarına bakın.SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- Google Analytics için Firebase SDK'sını dahil ettiyseniz, Firebase'i başarıyla yüklediğinize dair doğrulamayı Firebase konsoluna göndermek için uygulamanızı çalıştırabilirsiniz.
Bu kadar! Sonraki adımlara geçebilirsiniz.
Kurulumda sorun yaşıyorsanız, Apple platformları sorun giderme ve SSS sayfasını ziyaret edin.
Kullanılabilir kitaplıklar
Bu bölüm, Apple platformları için desteklenen Firebase ürünlerini listeler. Bu Firebase Apple platformu kitaplıkları hakkında daha fazla bilgi edinin:
Firebase Apple platformları SDK GitHub deposu
Hizmet veya Ürün | Bölmeler | SwiftPM Kitaplıkları | Analitik eklensin mi? |
---|---|---|---|
adMob | pod 'Google-Mobile-Ads-SDK' | Yok | |
Analitik | pod 'FirebaseAnalytics' | FirebaseAnalytics | |
Uygulama Kontrolü | pod 'FirebaseAppCheck' | FirebaseAppCheck | |
Uygulama Dağıtımı | pod 'FirebaseAppDistribution' | FirebaseAppDistribution | |
kimlik doğrulama | pod 'FirebaseAuth' | FirebaseAuth | |
Bulut Firestore | pod 'FirebaseFirestore' | FirebaseFirestore | |
Firebase İstemci SDK'sı için Bulut İşlevleri | pod 'FirebaseFunctions' | FirebaseFunctions | |
Bulut Mesajlaşma | pod 'FirebaseMessaging' | FirebaseMessaging | |
Bulut depolama | pod 'FirebaseStorage' | FirebaseStorage | |
Crashlytics | pod 'FirebaseCrashlytics' | FirebaseCrashlytics | |
Dinamik Bağlantılar | pod 'FirebaseDynamicLinks' | FirebaseDynamicLinks | |
Uygulama İçi Mesajlaşma | pod 'FirebaseInAppMessaging' | FirebaseInAppMessaging | (gerekli) |
Firebase kurulumları | pod 'FirebaseInstallations' | FirebaseInstallations | |
Firebase ML Özel Model API'leri | pod 'FirebaseMLModelDownloader' | FirebaseMLModelDownloader | |
Performans İzleme | pod 'FirebasePerformance' | FirebasePerformance | |
Gerçek Zamanlı Veritabanı | pod 'FirebaseDatabase' | FirebaseDatabase | |
Uzak Yapılandırma | pod 'FirebaseRemoteConfig' | FirebaseRemoteConfig |
Swift Paket Yöneticisi kullanmadan entegre edin
Swift Paket Yöneticisi'ni kullanmak istemiyorsanız, yine de CocoaPod'ları kullanarak veya çerçeveleri doğrudan içe aktararak Firebase SDK'larından yararlanabilirsiniz.
CocoaPod'lar
Rehberimizde CocoaPods entegrasyonu hakkında daha fazla bilgi edinin.
çerçeveler
iOS platformunu desteklemeye ek olarak, zip artık .xcframework
dosyalarını da içeriyor. Ayrıntılar için GitHub'da Firebase Apple platformları SDK README'ye bakın.
Çerçeve SDK zip dosyasını indirin. Bu ~200MB'lik bir dosyadır ve indirilmesi biraz zaman alabilir.
Dosyayı açın ve ardından uygulamanıza dahil etmek istediğiniz çerçeveleri entegre edin.
Entegrasyon talimatlarını aşağıdaki yerlerden birinde bulabilirsiniz:
- Firebase iOS SDK GitHub deposunda .
- İndirilen zip dağıtımı içindeki
README.md
dosyasında.
Çerçeve sürümleri veya bağımlılıkları hakkında bilgi için indirilen zip dağıtımındaki
METADATA.md
dosyasına bakın.-ObjC
bağlayıcı bayrağını, hedefinizin yapı ayarlarındaOther Linker Settings
ekleyin.
Sonraki adımlar
Firebase hakkında bilgi edinin:
Firebase projeleri ve projeler için en iyi uygulamalar hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlayın sayfasını ziyaret edin.
Örnek Firebase uygulamalarını keşfedin.
Firebase iOS Codelab ile uygulamalı deneyim kazanın.
GitHub'daki açık kaynak kodunu keşfedin.
Uygulamanızı başlatmaya hazırlanın:
- Google Cloud Console'da projeniz için bütçe uyarıları ayarlayın.
- Birden fazla Firebase hizmetinde projenizin kullanımının genel bir resmini elde etmek için Firebase konsolundaki Kullanım ve faturalandırma kontrol panelini izleyin.
- Firebase başlatma kontrol listesini inceleyin.
Firebase ve Apple projenizle ilgili sorun mu yaşıyorsunuz? Apple platformları sorun giderme ve SSS sayfasını ziyaret edin.
Uygulamanıza Firebase hizmetleri ekleyin:
Analytics ile kullanıcı davranışı hakkında bilgi edinin.
Kimlik Doğrulama ile kullanıcı kimlik doğrulamasını ayarlayın.
Kullanıcı bilgileri gibi verileri Cloud Firestore veya Realtime Database ile depolayın.
Fotoğraflar ve videolar gibi dosyaları Cloud Storage ile depolayın.
Cloud Functions ile güvenli bir ortamda çalışan arka uç kodunu tetikleyin.
Bulut Mesajlaşma ile bildirim gönderin.
Crashlytics ile uygulamanızın ne zaman ve neden kilitlendiğini öğrenin.