Önkoşullar
Aşağıdakileri kurun:
- Xcode 12.2 veya üstü
- CocoaPods 1.10.0 veya üstü
Projenizin şu gereksinimleri karşıladığından emin olun:
- Projeniz iOS 10 veya sonraki bir sürümünü hedeflemelidir.
Uygulamanızı çalıştırmak için fiziksel bir iOS cihazı kurun veya iOS simülatörünü kullanın.
İOS'ta Bulut Mesajlaşma için ön koşullar şunlardır:
- Fiziksel bir iOS cihazı kurun.
- Apple Geliştirici hesabınız için bir Apple Push Bildirimi Kimlik Doğrulama Anahtarı edinin.
- Xcode'da Uygulama> Yetenekler altında Push Bildirimleri 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ünü denemek istiyorsanız hızlı başlangıç örneklerimizden birini indirebilirsiniz.
1. Adım : Firebase projesi oluşturun
İOS uygulamanıza Firebase eklemeden önce, iOS uygulamanıza bağlanmak için bir Firebase projesi oluşturmanız gerekir. Firebase projeleri hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama bölümünü ziyaret edin.
2. Adım : Uygulamanızı Firebase'e kaydedin
Bir Firebase projeniz olduktan sonra, iOS uygulamanızı buna ekleyebilirsiniz.
Birden çok derleme varyantının nasıl işleneceği de dahil olmak üzere, bir Firebase projesine uygulama eklemeye yönelik en iyi uygulamalar ve dikkate alınması gereken noktalar hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama sayfasını ziyaret edin.
Projeye genel bakış sayfasının
, kurulum iş akışını başlatmak için 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.
İOS paket kimliği alanına uygulamanızın paket kimliğini girin.
Paket kimliği , Apple'ın ekosistemindeki bir uygulamayı benzersiz şekilde tanımlar.
Paket kimliğinizi bulun: iOS 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, iOS 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 kaydolduktan sonra bu Firebase iOS uygulaması için değiştirilemeyeceğini unutmayın.
(İsteğe bağlı) Diğer uygulama bilgilerini girin: Uygulama takma adı ve App Store Kimliği .
Uygulama takma adı : Yalnızca Firebase konsolunda 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 : Firebase yapılandırma dosyası ekleyin
Firebase iOS yapılandırma dosyanızı (
GoogleService-Info.plist
) almak 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ına
(2)
gibi ek karakterlerin 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 eklemeyi 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 konsolundaki kayıtlı bir uygulamayla ilişkilendirmeniz gerekir.
4. Adım : Firebase SDK'larını uygulamanıza ekleyin
Firebase kitaplıklarını yüklemek için CocoaPods kullanmanızı öneririz . Bununla birlikte, CocoaPod'ları kullanmak istemiyorsanız, SDK çerçevelerini doğrudan entegre edebilir veya Swift Paket Yöneticisini (beta) kullanabilirsiniz .
Hızlı başlangıç örneklerinden birini kullanıyor musunuz? Xcode projesi ve Podfile (kapsüller ile) zaten mevcut, ancak yine de Firebase yapılandırma dosyanızı eklemeniz ve bölmeleri yüklemeniz gerekir.
Zaten sahip değilseniz bir Pod dosyası oluşturun:
cd your-project-directory
pod init
Pod Dosyanıza, uygulamanızda kullanmak istediğiniz Firebase bölmelerini ekleyin.
Desteklenen Firebase ürünlerinden herhangi birini iOS uygulamanıza ekleyebilirsiniz.
Analytics etkinleştirildi
platform :ios, ‘10.0’
# Add the Firebase pod for Google Analytics pod 'Firebase/Analytics'
# 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 'Firebase/Auth' pod 'Firebase/Firestore'Analytics etkinleştirilmedi
platform :ios, ‘10.0’
# Add the pods for the Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'Bölmeleri yükleyin, ardından projeyi
.xcworkspace
görmek için.xcworkspace
dosyanızı açın:pod install
open your-project.xcworkspace
5. Adım : Uygulamanızda Firebase'i başlatın
Son adım, uygulamanıza başlatma kodunu eklemektir. Firebase'i uygulamanıza eklemenin bir parçası olarak bunu zaten yapmış olabilirsiniz. Hızlı başlangıç örnek projesi kullanıyorsanız , bu sizin için yapılmıştır.
- Sizin de Firebase modülü içe
UIApplicationDelegate
:Swift
import Firebase
Amaç-C
@import Firebase;
- Genellikle uygulamanızın uygulamasında bir
FirebaseApp
paylaşılan örneği yapılandırınapplication:didFinishLaunchingWithOptions:
yöntem:Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Amaç-C
// Use Firebase library to configure APIs [FIRApp configure];
- Firebase Analytics'i eklediyseniz, 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 atlayabilirsiniz.
Kullanılabilir kapsüller
Bu bölümde, iOS için desteklenen Firebase ürünleri ve bunların kapsülleri listelenmektedir. Bu Firebase iOS kitaplıkları hakkında daha fazla bilgi edinin:
Hizmet veya Ürün | Kapsüller | Analytics eklensin mi? |
---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' | |
Analitik | pod 'Firebase/Analytics' | |
Uygulama Dağıtımı | pod 'Firebase/AppDistribution' | |
Doğrulama | pod 'Firebase/Auth' | |
Cloud Firestore | pod 'Firebase/Firestore' | |
Firebase Client SDK için Cloud Functions | pod 'Firebase/Functions' | |
Bulut Mesajlaşma | pod 'Firebase/Messaging' | |
Bulut depolama | pod 'Firebase/Storage' | |
Firebase Crashlytics | pod 'Firebase/Crashlytics' | |
Dinamik Bağlantılar | pod 'Firebase/DynamicLinks' | |
Uygulama İçi Mesajlaşma | pod 'Firebase/InAppMessaging' | (gereklidir) |
Firebase ML Özel Model API'leri | pod 'Firebase/MLModelDownloader' | |
Performans İzleme | pod 'Firebase/Performance' | |
Gerçek Zamanlı Veritabanı | pod 'Firebase/Database' | |
Uzaktan Yapılandırma | pod 'Firebase/RemoteConfig' |
CocoaPods olmadan entegre edin
Cocoapod'ları kullanmak istemiyorsanız, çerçeveleri doğrudan içe aktararak veya Swift Paket Yöneticisi'ni kullanarak Firebase SDK'larından yararlanabilirsiniz.
Çerçeveler
İOS platformunu desteklemenin yanı sıra, zip artık topluluk tabanlı Catalyst desteği ekleyen .xcframework dosyalarını da içeriyor. Ayrıntılar için GitHub'da Firebase iOS SDK README sayfasına bakın.
Çerçeve SDK zip dosyasını indirin. Bu ~ 200MB'lık bir dosyadır ve indirilmesi biraz zaman alabilir.
Dosyanın Sıkıştırılmış ve ardından incelemek
README
uygulamanızda dahil etmek istediğiniz çerçeveleri.ObjC
bağlayıcı bayrağını , hedefinizin derleme ayarlarındakiOther Linker Settings
ekleyin.
Swift Paket Yöneticisi
Swift Paket Yöneticisi desteği şu anda beta aşamasındadır. GitHub'daki belgeleri takip edin ve herhangi bir geri bildiriminizi GitHub sorun izleyicisine gönderin.
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 Anlama sayfasını ziyaret edin.
Örnek Firebase uygulamalarını keşfedin.
Firebase iOS Codelab ile uygulamalı deneyim edinin .
GitHub'da 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.
- Projenizin birden çok Firebase hizmetinde kullanımına ilişkin genel bir fikir edinmek için Firebase konsolundaki Kullanım ve faturalandırma kontrol panelini izleyin.
- Firebase başlatma kontrol listesini inceleyin .
Firebase hizmetlerini uygulamanıza ekleyin:
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 bildirimler gönderin.
Uygulamanızın Crashlytics ile ne zaman ve neden kilitlendiğini öğrenin .