Önkoşullar
Aşağıdakileri yükleyin:
- Xcode 13.3.1 veya üstü
Projenizin şu gereksinimleri karşıladığından emin olun:
- Projeniz bu platform sürümlerini veya daha sonrasını hedeflemelidir:
- iOS 10
- macOS 10.12
- tvOS 12
- watchOS 6
- Projeniz bu platform sürümlerini veya daha sonrasını hedeflemelidir:
Uygulamanızı çalıştırmak için fiziksel bir Apple cihazı kurun veya bir simülatör kullanın.
Bulut Mesajlaşma'yı kullanmak istiyor musunuz?
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.
- Xcode'da App > Capabilities altında 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ünü denemek istiyorsanız, hızlı başlangıç örneklerimizden birini indirebilirsiniz.
Adım 1 : Bir Firebase projesi oluşturun
Firebase'i Apple uygulamanıza eklemeden önce 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 Anlayın sayfasını ziyaret edin.
Bir Firebase projesi oluşturun
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. Proje adının altında görüntülenen proje kimliğini de isteğe bağlı olarak düzenleyebilirsiniz.
İstenirse Firebase şartlarını inceleyin ve kabul edin.
Devam'ı tıklayın.
(İsteğe bağlı) Aşağıdaki Firebase ürünlerinden herhangi birini kullanarak en iyi deneyimi yaşamanızı sağlayan projeniz için Google Analytics'i kurun:
Ya mevcut bir Google Analytics hesabını seçin ya da 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 projesi kullanıyorsanız Firebase Ekle'yi ) tıklayın.
Firebase, Firebase projeniz için kaynakları otomatik olarak sağlar. İş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.
Projeye genel bakış sayfasının ortasında, 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.
Paket kimliği alanına uygulamanızın paket kimliğini girin.
Paket kimliği nedir ve onu nerede bulursunuz?
Paket kimliği , Apple 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 harf duyarlı olduğunu ve Firebase projenize kaydolduktan 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 .
Firebase'de Uygulama takma adı ve Uygulama Mağazası Kimliği nasıl kullanılır?
Uygulama takma adı : Yalnızca Firebase konsolunda görebileceğiniz dahili, kullanışlı bir tanımlayıcı
App Store Kimliği : Kullanıcıları App Store sayfanıza yönlendirmek için Firebase Dynamic Links ve dönüşüm etkinliklerini Google Ads'e aktarmak için Google Analytics tarafından 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) almak 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 yeniden 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 dizinine 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 etkinse,
FirebaseAnalyticseklediğinizden emin olun. IDFA toplama özelliği olmayan Analytics için bunun yerine
FirebaseAnalyticsWithoutAdIdekleyin.
https://github.com/firebase/firebase-ios-sdk
Bittiğinde, Xcode otomatik olarak bağımlılıklarınızı arka planda çözmeye ve indirmeye başlayacaktır.
Adım 5 : Uygulamanızda Firebase'i başlatın
Son adım, uygulamanıza başlatma kodu eklemektir. Bunu, uygulamanıza Firebase eklemenin bir parçası olarak zaten yapmış olabilirsiniz. Bir hızlı başlangıç örneği proje kullanıyorsanız, bu sizin için yapılmıştır.
-
UIApplicationDelegate
FirebaseCoremodülünü ve uygulama temsilcinizin kullandığı diğer Firebase modüllerini içe aktarın. Örneğin, Cloud Firestore ve Kimlik Doğrulamayı kullanmak için:
Süratli
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Amaç-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Uygulama temsilcinizin
application(_:didFinishLaunchingWithOptions:)yönteminde bir
FirebaseApppaylaşılan örneği yapılandırın:
Süratli
// Use Firebase library to configure APIs FirebaseApp.configure()
Amaç-C
// Use Firebase library to configure APIs [FIRApp configure];
- 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 atlayabilirsiniz.
Yine de kurulum yapmakta sorun yaşıyorsanız, Apple platformlarında 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 platform kitaplıkları hakkında daha fazla bilgi edinin:
|Hizmet veya Ürün||bölmeler||SwiftPM Kitaplıkları||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|| || |
(gereklidir)
|Firebase kurulumları|| || |
|Firebase ML Özel Model API'leri|| || |
|Performans İzleme|| || |
|Gerçek Zamanlı Veritabanı|| || |
|Uzak Yapılandırma|| || |
Swift Paket Yöneticisini kullanmadan entegre edin
Swift Paket Yöneticisi'ni kullanmak istemiyorsanız, CocoaPod'ları kullanarak veya çerçeveleri doğrudan içe aktararak Firebase SDK'larından yararlanmaya devam edebilirsiniz.
CocoaPod'lar
Kılavuzumuzda 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'ye bakın.
Çerçeve SDK zip dosyasını indirin. Bu ~200MB'lık bir dosyadır ve indirilmesi biraz zaman alabilir.
Dosyayı açın, ardından uygulamanıza dahil etmek istediğiniz çerçeveler için
README.
-ObjCbağlayıcı bayrağını , hedefinizin oluşturma ayarlarındaki
Other Linker Settingsekleyin.
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 elde edin.
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ında 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.
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.
Crashlytics ile uygulamanızın ne zaman ve neden kilitlendiğini öğrenin.