Önkoşullar
Aşağıdakileri yükleyin:
- Xcode 14.1 veya üzeri
Projenizin şu gereksinimleri karşıladığından emin olun:
- Projeniz şu platform sürümlerini veya sonraki sürümlerini hedeflemelidir:
- iOS 11
- macOS 10.13
- tvOS 12
- watchOS 6
- Projeniz şu platform sürümlerini veya sonraki sürümlerini hedeflemelidir:
Uygulamanızı çalıştırmak için fiziksel bir Apple cihazı kurun veya bir simülatör kullanın.
Bulut Mesajlaşmayı kullanmak istiyor musunuz?
Apple platformlarında Cloud Messaging için önkoşullar şunlardır:
- Fiziksel bir Apple cihazı kurun.
- Apple Geliştirici hesabınız için bir Apple Anında Bildirim Kimlik Doğrulama Anahtarı edinin.
- Uygulama > Yetenekler altında Xcode'da Anında Bildirimleri etkinleştirin.
- Google hesabınızı kullanarak Firebase'de oturum açın .
Henüz 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
Firebase'i Apple uygulamanıza ekleyebilmeniz için önce uygulamanıza bağlanacak 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.
Firebase projesi oluşturma
Firebase konsolunda Proje ekle'yi tıklayın.
Firebase kaynaklarını mevcut bir Google Cloud projesine eklemek için proje adını girin veya açılır menüden seçin.
Yeni bir proje oluşturmak için istediğiniz proje adını girin. İsteğe bağlı olarak proje adının altında görüntülenen proje kimliğini de düzenleyebilirsiniz.
İstenirse Firebase şartlarını inceleyip kabul edin.
Devam'ı tıklayın.
(İsteğe bağlı) Projeniz için, aşağıdaki Firebase ürünlerinden herhangi birini kullanırken en iyi deneyimi yaşamanıza olanak tanıyan Google Analytics'i kurun:
Mevcut bir Google Analytics hesabını seçin veya yeni bir hesap oluşturun.
Yeni bir hesap oluşturursanız Analytics raporlama konumunuzu seçin ve ardından projeniz için veri paylaşım ayarlarını ve Google Analytics şartlarını kabul edin.
Proje oluştur'u (veya mevcut bir Google Cloud projesini kullanıyorsanız Firebase Ekle'yi ) tıklayın.
Firebase, Firebase projeniz için kaynakları otomatik olarak hazırlar. İşlem tamamlandığında Firebase konsolundaki Firebase projenizin genel bakış sayfasına yönlendirileceksiniz.
2. Adım : Uygulamanızı Firebase'e kaydedin
Firebase'i Apple uygulamanızda kullanmak için uygulamanızı Firebase projenize kaydetmeniz gerekir. Uygulamanızı kaydetmeye genellikle uygulamanızı projenize "eklemek" denir.
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.
Paket kimliği nedir ve onu nerede bulabilirsiniz?
Paket kimliği, Apple'ın ekosistemindeki bir uygulamayı benzersiz şekilde tanımlar.
Paket kimliğinizi bulun: Projenizi Xcode'da açın, proje gezgininde üst düzey uygulamayı seçin ve 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 App Store Kimliği .
Firebase'de Uygulama takma adı ve App Store Kimliği nasıl kullanılır?
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ıza ekleyebilirsiniz.
Uygulamayı kaydet'i tıklayın.
3. Adım : 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.
Bu yapılandırma dosyası hakkında bilmeniz gerekenler nelerdir?
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 Anlayın sayfasını ziyaret edin.
Firebase yapılandırma dosyanızı istediğiniz zaman tekrar indirebilirsiniz.
Yapılandırma dosyası adına
(2)gibi ek karakterler eklenmediğinden emin olun.
Yapılandırma dosyanızı Xcode projenizin kök dizinine 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 bağımlılıklarını yüklemek ve yönetmek için Swift Paket Yöneticisini kullanın.
- Xcode'da uygulama projeniz açıkken Dosya > Paket Ekle'ye 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
FirebaseAnalyticseklediğinizden emin olun. IDFA toplama özelliği olmayan Analytics için bunun yerine
FirebaseAnalyticsWithoutAdIdekleyin.
https://github.com/firebase/firebase-ios-sdk
Bitirdiğinizde Xcode, bağımlılıklarınızı arka planda otomatik olarak çözmeye ve indirmeye başlayacaktır.
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.
-
FirebaseCoremodülünü
UIApplicationDelegateve uygulama temsilcinizin kullandığı diğer Firebase modüllerine 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
FirebaseApppaylaşılan örneğini 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
UIApplicationDelegateAdaptorveya
NSApplicationDelegateAdaptoraracılığıyla
Appyapınıza eklemelisiniz. Ayrıca uygulama temsilcisinin swizzling özelliğini 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ı eklediyseniz, Firebase konsoluna Firebase'i başarıyla yüklediğinize dair doğrulama göndermek için uygulamanızı çalıştırabilirsiniz.
Bu kadar! Sonraki adımlara geçebilirsiniz.
Ancak kurulum konusunda sorun yaşıyorsanız Apple platformları sorun giderme ve SSS bölümünü ziyaret edin.
Mevcut kütüphaneler
Bu bölümde Apple platformları için desteklenen Firebase ürünleri listelenmektedir. Bu Firebase Apple platform kitaplıkları hakkında daha fazla bilgi edinin:
|Hizmet veya Ürün||Kapsüller||SwiftPM Kütüphaneleri||Analytics eklensin mi?|
|AdMob|| ||Yok|
|Analitik|| || |
|Uygulama Kontrolü|| || |
|Uygulama Dağıtımı|| || |
|Kimlik doğrulama|| || |
|Bulut Firestore|| || |
|Firebase İstemci SDK'sı için Bulut İşlevleri|| || |
|Bulut Mesajlaşma|| || |
|Bulut depolama|| || |
|Crashlytics|| || |
|Dinamik Bağlantılar|| || |
|Uygulama İçi Mesajlaşma|| || |
(gerekli)
|Firebase kurulumları|| || |
|Firebase ML Özel Model API'leri|| || |
|Performans İzleme|| || |
|Gerçek Zamanlı Veritabanı|| || |
|Uzaktan Yapılandırma|| || |
Swift Paket Yöneticisini kullanmadan entegrasyon
Swift Paket Yöneticisini kullanmak istemiyorsanız CocoaPod'ları kullanarak veya çerçeveleri doğrudan içe aktararak Firebase SDK'larından yararlanmaya devam edebilirsiniz.
CocoaPod'lar
Kılavuzumuzdan CocoaPods entegrasyonu hakkında daha fazla bilgi edinin.
Çerçeveler
Zip, iOS platformunu desteklemenin yanı sıra artık
.xcframework dosyalarını da içeriyor. Ayrıntılar için GitHub'daki Firebase Apple platformları SDK README'sine bakın.
Çerçeve SDK zip dosyasını indirin. Bu yaklaşık 200 MB'lık 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ındaki
README.mddosyasında.
Çerçeve sürümleri veya bağımlılıklarla ilgili bilgi için indirilen zip dağıtımındaki
METADATA.mddosyasına bakın.
Hedefinizin derleme ayarlarındaki
Other Linker SettingsAyarlarınıza
-ObjCbağlayıcı bayrağını ekleyin.
Sonraki adımlar
Firebase hakkında bilgi edinin:
Firebase projeleri ve projelere yönelik 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 edinin.
GitHub'daki açık kaynak kodunu keşfedin.
Uygulamanızı başlatmaya hazırlanın:
Firebase ve Apple projenizle ilgili sorun mu yaşıyorsunuz? Apple platformları sorun giderme ve SSS bölümünü ziyaret edin.
Firebase hizmetlerini uygulamanıza ekleyin:
Analytics ile kullanıcı davranışına ilişkin öngörüler elde edin.
Kimlik Doğrulama ile kullanıcı kimlik doğrulamasını ayarlayın.
Fotoğraf ve video gibi dosyaları Bulut Depolama ile 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.