Ön koşullar
Aşağıdakileri yükleyin:
- Xcode 14.1 veya sonraki sürümler
Projenizin şu gereklilikleri karşıladığından emin olun:
- Projeniz şu platform sürümlerini veya sonraki sürümleri hedeflemelidir:
- iOS 11
- macOS 10.13
- tvOS 12
- watchOS 6
- Projeniz şu platform sürümlerini veya sonraki sürümleri hedeflemelidir:
Uygulamanızı çalıştırmak için fiziksel bir Apple cihazı kurun veya simülatör kullanın.
- Google Hesabınızı kullanarak Firebase'de oturum açın.
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
Firebase'i Apple uygulamanıza eklemeden önce uygulamanıza bağlanacak bir Firebase projesi oluşturmanız gerekir. Firebase projeleri hakkında daha fazla bilgi için Firebase Projelerini Anlama 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ı kaydetme işlemine genellikle uygulamanızı projenize "ekleme" denir.
Firebase konsoluna gidin.
Kurulum iş akışını başlatmak için projeye genel bakış sayfasının ortasındaki iOS+ simgesini tıklayın.
Firebase projenize daha önce uygulama eklediyseniz platform seçeneklerini görüntülemek için Uygulama ekle'yi tıklayın.
Uygulamanızın paket kimliğini paket kimliği alanına girin.
(İsteğe bağlı) Diğer uygulama bilgilerini girin: Uygulama takma adı ve App Store kimliği.
Uygulamayı kaydet'i tıklayın.
3. Adım: Firebase yapılandırma dosyası ekleyin
Firebase Apple platforms yapılandırma dosyanızı (
GoogleService-Info.plist
) edinmek için GoogleService-Info.plist dosyasını indir'i tıklayın.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ği 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: Firebase SDK'larını uygulamanıza ekleyin
Firebase bağımlılıklarını yükleyip yönetmek için Swift Package Manager'ı kullanın.
- Xcode'da, uygulamanız açıkken File > Add Packages'a (Dosya > Paket Ekle) 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 etkinse
FirebaseAnalytics
eklediğinizden emin olun. IDFA toplama özelliği olmayan Analytics için bunun yerineFirebaseAnalyticsWithoutAdId
ekleyin.
https://github.com/firebase/firebase-ios-sdk
İşlem tamamlandığında Xcode, arka planda bağımlılıklarınızı otomatik olarak çözümlemeye ve indirmeye başlar.
5. Adım: Uygulamanızda Firebase'i başlatın
Son adım, uygulamanıza başlatma kodu eklemektir. Bu işlemi uygulamanıza Firebase'i eklerken yapmış olabilirsiniz. Örnek hızlı başlangıç projesi kullanıyorsanız bu işlem sizin yerinize yapılmıştır.
FirebaseCore
modülünüUIApplicationDelegate
uygulamanıza ve yetki verdiğiniz kullanıcının kullandığı diğer tüm Firebase modüllerini içe aktarın. Örneğin, Cloud Firestore ve Authentication'ı kullanmak için:Hızlı Kullanıcı Arayüzü
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Uygulama yetkilinizin
application(_:didFinishLaunchingWithOptions:)
yöntemindeFirebaseApp
paylaşılan bir örnek yapılandırın:Hızlı Kullanıcı Arayüzü
// Use Firebase library to configure APIs FirebaseApp.configure()
Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- SwiftUI kullanıyorsanız bir uygulama temsilcisi oluşturmanız ve
UIApplicationDelegateAdaptor
veyaNSApplicationDelegateAdaptor
aracılığıylaApp
yapınıza eklemeniz gerekir. Uygulama yetkilendirmesi kaydırmayı da devre dışı bırakmanız gerekir. Daha fazla bilgi için SwiftUI talimatlarına bakın.Hızlı Kullanıcı Arayüzü
@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ı eklediyseniz Firebase'i başarıyla yüklediğiniz Firebase konsoluna doğrulama göndermek için uygulamanızı çalıştırabilirsiniz.
Hepsi bu kadar! Sonraki adımlara geçebilirsiniz.
Kurulum konusunda sorun yaşıyorsanız Apple platformlarında sorun giderme ve SSS sayfasını ziyaret edin.
Kullanılabilen kitaplıklar
Bu bölümde, Apple platformlarında desteklenen Firebase ürünleri listelenmektedir. Aşağıdaki Firebase Apple platform kitaplıkları hakkında daha fazla bilgi edinin:
Firebase Apple platformlar SDK'sı GitHub deposu
Hizmet veya Ürün | Kapsüller | SwiftPM Kitaplıkları | Analytics eklensin mi? |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' |
Yok | |
Analizler | pod 'FirebaseAnalytics' |
FirebaseAnalytics |
|
Uygulama Kontrolü | pod 'FirebaseAppCheck' |
FirebaseAppCheck |
|
Uygulama Dağıtımı | pod 'FirebaseAppDistribution' |
FirebaseAppDistribution |
|
Kimlik Doğrulama | pod 'FirebaseAuth' |
FirebaseAuth |
|
Cloud Firestore | pod 'FirebaseFirestore' |
FirebaseFirestore |
|
Cloud Functions for Firebase İstemci SDK'sı | pod 'FirebaseFunctions' |
FirebaseFunctions |
|
Bulut Mesajlaşma | pod 'FirebaseMessaging' |
FirebaseMessaging |
|
Cloud Storage | pod 'FirebaseStorage' |
FirebaseStorage |
|
Crashlytics | pod 'FirebaseCrashlytics' |
FirebaseCrashlytics |
|
Dinamik Bağlantılar | pod 'FirebaseDynamicLinks' |
FirebaseDynamicLinks |
|
Uygulama içi mesajlaşma | pod 'FirebaseInAppMessaging' |
FirebaseInAppMessaging |
(zorunlu) |
Firebase yüklemeleri | pod 'FirebaseInstallations' |
FirebaseInstallations |
|
Firebase ML Özel Model API'leri | pod 'FirebaseMLModelDownloader' |
FirebaseMLModelDownloader |
|
Performans İzleme | pod 'FirebasePerformance' |
FirebasePerformance |
|
Gerçek Zamanlı Veritabanı | pod 'FirebaseDatabase' |
FirebaseDatabase |
|
Remote Config | pod 'FirebaseRemoteConfig' |
FirebaseRemoteConfig |
|
Firebase için Vertex AI | Yok | FirebaseVertexAI-Preview |
Swift Package Manager'ı kullanmadan entegre et
Swift Package Manager'ı kullanmak istemiyorsanız CocoaPods kullanarak veya çerçeveleri doğrudan içe aktararak Firebase SDK'larından yararlanabilirsiniz.
CocoaPods
CocoaPods entegrasyonu hakkında daha fazla bilgiyi kılavuzumuzda bulabilirsiniz.
Çerçeveler
Zip dosyası, iOS platformunu desteklemenin yanı sıra artık .xcframework
dosyalarını da içeriyor. Ayrıntılı bilgi için GitHub'daki Firebase Apple platformlar SDK'sı BENİOKU bölümünü inceleyin.
framework SDK'sının ZIP dosyasını indirin. Yaklaşık 200 MB boyutunda olan bu dosyanın indirilmesi biraz zaman alabilir.
Dosyayı açın ve 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ındaki
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.Hedefinizin derleme ayarlarında,
Other Linker Settings
bölümüne-ObjC
bağlayıcı işaretini ekleyin.
Sonraki adımlar
Firebase hakkında bilgi edinin:
Firebase projeleri ve projelere yönelik en iyi uygulamalar hakkında daha fazla bilgi için Firebase Projelerini Anlama sayfasını ziyaret edin.
Örnek Firebase uygulamalarını keşfedin.
Firebase iOS Codelab ile uygulamalı deneyim edinin.
GitHub'daki açık kaynak kodu keşfedin.
Uygulamanızı kullanıma sunmaya hazırlanma:
- Google Cloud Console'da projeniz için bütçe uyarıları oluşturun.
- Birden çok Firebase hizmeti genelinde projenizin kullanımıyla ilgili genel bir fikir edinmek için Firebase konsolundaki Kullanım ve faturalandırma kontrol panelini izleyin.
- Firebase lansmanı kontrol listesini inceleyin.
Firebase ve Apple projenizle ilgili sorun mu yaşıyorsunuz? Apple platformlarında sorun giderme ve SSS sayfasını ziyaret edin.
Uygulamanıza Firebase hizmetlerini 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.
Cloud Storage ile fotoğraflar ve videolar gibi dosyaları depolayın.
Cloud Functions ile güvenli bir ortamda çalışan arka uç kodunu tetikleyin.
Cloud Messaging ile bildirim gönderin.
Crashlytics ile uygulamanızın ne zaman ve neden kilitlendiğini öğrenin.