Önkoşullar
Aşağıdakileri yükleyin:
- Xcode 12.5 veya üstü
Projenizin şu gereksinimleri karşıladığından emin olun:
- Projeniz bu platform sürümlerini veya sonraki sürümlerini hedeflemelidir:
- iOS 10
- macOS 10.12
- tvOS 12
- watchOS 6
- Projeniz bu 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şma'yı kullanmak istiyor musunuz?
Apple platformlarında Bulut Mesajlaşma için ön koşullar şunlardır:
- Fiziksel bir Apple cihazı ayarlayın.
- Sizin için bir Apple Push Notification Doğrulama Anahtarı Edinme Elma Geliştirici hesabına .
- > Yetenek App altında Xcode itin Bildirimleri Etkinleştir.
- Firebase oturum açın Google hesabınızı kullanarak.
Zaten bir Xcode projem var ve sadece Firebase ürünü denemek istemiyorsanız, bizim birini indirebilirsiniz hızlı başlangıç örneklerinin .
1. Adım: Bir Firebase projesi oluşturma
Firebase'i Apple uygulamanıza eklemeden önce uygulamanıza bağlanmak için bir Firebase projesi oluşturmanız gerekir. Ziyaret Firebase Projeleri Anlayın Firebase projeleri hakkında daha fazla bilgi edinmek.
Bir Firebase projesi oluşturun
In Firebase konsolunda , Ekle projeyi tıklayın.
Mevcut bir Google Bulut projeye Firebase kaynaklar eklemek için, onun 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, inceleyip kabul Firebase terimleri .
Devam tıklayın.
Aşağıdaki Firebase ürünlerden herhangi birini kullanarak optimal bir deneyime sahip sağlayan projeniz için Google Analytics kadar (İsteğe bağlı) Seti:
Ya mevcut bir seçmek Google Analytics hesabı veya yeni bir hesap oluşturun.
Yeni bir hesap oluşturursanız, seçmek Konum bildiren Analytics sonra projeniz için veri paylaşım ayarları ve Google Analytics şartları kabul.
Tıklayın proje oluştur (veya mevcut bir Google Bulut projesini kullanıyorsanız, Firebase ekle).
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: Firebase ile uygulamanızı kaydedin
Bir Firebase projeniz olduktan sonra buna Apple uygulamanızı ekleyebilirsiniz.
Ziyaret Firebase Projeleri anlama birden inşa varyantları nasıl işleneceğini dahil olmak üzere bir Firebase projeye uygulamalar ekleyerek daha iyi uygulamalar ve değerlendirmeler hakkında bilgi edinmek için.
Git Firebase konsoluna .
Proje genel bakış Sayfanın ortasında, kurulum iş akışını başlatmak için iOS + simgesini tıklayın.
Zaten Firebase projeye bir uygulamayı eklediyseniz, platformu seçeneklerini görüntülemek için uygulama ekleme tıklayın.
Paket kimliği alanına uygulamanızın paket kimliği girin.
Paket kimliği nedir ve onu nerede bulursunuz?
Bir paket kimliği benzersiz Apple'ın ekosistemde bir uygulamayı tanımlar.
Senin paket kimliği bul: sonra Genel sekmesini seçin, proje gezginindeki üst düzey uygulamasını seçin, Xcode projenizi açın.
Paket Tanımlayıcı alanının değeri (örneğin, grup kimliği olan
com.yourcompany.yourproject).
Paket kimliği değerinin büyük/küçük harfe duyarlı olduğunu ve Firebase projenize kaydolduktan sonra bu Firebase uygulaması için değiştirilemeyeceğini unutmayın.
Uygulama rumuz ve App Store ID: (İsteğe bağlı) diğer uygulama bilgilerini girin.
Nasıl Uygulama adı ve Firebase içinde kullanılan App Store Kimliği nelerdir?
Uygulama takma ad: Firebase konsolunda yalnızca size görünür olan bir dahili, kolaylık tanımlayıcı
App Store Kimliği: için Firebase Dinamik bağlantılar Kullandığı App Store sayfasına yönlendirin için Google Analytics ve tarafından Google Reklamları içine alma dönüşüm etkinliklerine . Uygulamanız henüz bir App Store kimliği yoksa, size daha sonra kimlik ekleyebilir Proje ayarlarında .
Kayıt uygulamasını tıklayın.
3. Adım: Firebase yapılandırma dosyası ekle
Senin Firebase Elma platformların yapılandırma dosyası (elde etmek İndir GoogleService-Info.plist'ni tıklayın
GoogleService-Info.plist).
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 aşağıdaki adresi ziyaret Firebase Projeleri anlayın .
Eğer indirebilirsiniz Firebase yapılandırma dosyasını herhangi bir zamanda tekrar.
Emin olun yapılandırma dosya adı gibi ek karakterler ile eklenmez
(2).
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.
Eğer projenizde birden paket kimliği yoksa, Her bir uygulama kendi olabilir böylece Firebase konsolunda tescilli uygulaması ile her paket kimliği ilişkilendirmek gerekir
GoogleService-Info.plist dosyasını.
Adım 4: uygulamanıza Firebase SDK'lerini ekle
Firebase bağımlılıklarını kurmak ve yönetmek için Swift Paket Yöneticisi'ni kullanın.
- Xcode olarak, uygulama açma projesi, gezinilebilen ile Dosya> Swift Paketleri> Paket Bağımlılık Ekle.
- İ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.
Google Analytics Firebase projesinde etkinse, eklemek emin olun
FirebaseAnalytics. IDFA toplama yeteneği olmadan Analytics için eklemek
FirebaseAnalyticsWithoutAdIdyerine.
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: başlat Firebase uygulamanızda
Son adım, uygulamanıza başlatma kodu eklemektir. Bunu, uygulamanıza Firebase eklemenin bir parçası olarak zaten yapmış olabilirsiniz. Eğer bir kullanıyorsanız hızlı başlangıç örnek proje , bu sizin için yapılmıştır.
- Sizin de Firebase modülü içe
UIApplicationDelegate:
Süratli
import Firebase
Amaç-C
@import Firebase;
- Yapılandırma bir
FirebaseApptipik uygulamanızın içinde, örnek paylaşılan
application:didFinishLaunchingWithOptions:yöntemi:
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! Sen atlayabilirsiniz sonraki adımlar .
Eğer sorun olsa ayarlamalar yapıyorum yaşıyorsanız, ziyaret giderme ve SSS Elma platformları .
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|| || |
Bağımlılık yöneticisi olmadan entegre edin
Swift Paket Yöneticisini kullanmak istemiyorsanız, çerçeveleri doğrudan içe aktararak veya CocoaPod'ları kullanarak Firebase SDK'larından yararlanmaya devam edebilirsiniz.
çerçeveler
İOS platformunu destekleyen ek olarak, fermuar şimdi içerir
.xcframework dosyaları. Ayrıntılar için bkz Firebase Elma platformları GitHub'dan SDK BENİOKU .
İndir çerçeve SDK zip . Bu ~200MB'lık bir dosyadır ve indirilmesi biraz zaman alabilir.
Dosyanın Sıkıştırılmış ve ardından incelemek
READMEuygulamanızda eklemek istediğiniz çerçeveler için.
Ekle
-ObjCbağlayıcı işareti sizin de
Other Linker Settingshedefin inşa ayarlarında.
CocoaPod'lar
İçinde CocoaPods entegrasyonu hakkında daha fazla bilgi rehberimiz .
Sonraki adımlar
Firebase hakkında bilgi edinin:
Ziyaret Firebase Projeleri anlayın Firebase proje ve projeler için en iyi uygulamalar hakkında daha fazla bilgi edinmek için.
Explore örnek Firebase uygulamalar .
Deneyim uygulamalı alın Firebase iOS Codelab .
Explore GitHub'dan açık kaynak kodu .
Uygulamanızı başlatmaya hazırlanın:
Firebase ve Apple projenizle ilgili sorun mu yaşıyorsunuz? Ziyaret giderme ve SSS Elma platformları .
Uygulamanıza Firebase hizmetleri ekleyin:
İle kullanıcı davranışı hakkında bilgiler edinin Analytics .
İle kullanıcı kimlik doğrulaması kurma Kimlik .
İle, fotoğraf ve video gibi dosyaları saklayın Bulut Depolama .
Trigger arka uç kod ile güvenli bir ortamda çalışır olduğunu Bulut Fonksiyonlar .
İle bildirimleri gönder Cloud Messaging .
Uygulamanız ile kilitleniyor ne zaman ve neden öğrenin Crashlytics .