Catch up on highlights from Firebase at Google I/O 2023. Learn more

Apple projenize Firebase ekleyin

Önkoşullar

  • Aşağıdakileri yükleyin:

    • Xcode 13.3.1 veya üstü

  • Projenizin şu gereksinimleri karşıladığından emin olun:

    • Projeniz şu platform sürümlerini veya sonraki sürümleri hedeflemelidir:
      • iOS 11
      • macOS 10.13
      • tvOS 12
      • OS 6 izle

  • Uygulamanızı çalıştırmak için fiziksel bir Apple aygıtı kurun veya bir simülatör kullanın.

Halihazırda bir Xcode projeniz yoksa ve yalnızca bir Firebase ürünü denemek istiyorsanız, hızlı başlangıç ​​örneklerimizden birini indirebilirsiniz.

Adım 1 : Bir Firebase projesi oluşturun

Firebase'i Apple uygulamanıza ekleyebilmeniz için uygulamanıza bağlanmak üzere 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.

2. Adım : Uygulamanızı Firebase'e kaydedin

Firebase'i Apple uygulamanızda kullanmak için uygulamanızı Firebase projenize kaydetmeniz gerekir. Uygulamanızı kaydettirmek genellikle uygulamanızı projenize "eklemek" olarak adlandırılır.

  1. Firebase konsoluna gidin.

  2. 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.

  3. Paket kimliği alanına uygulamanızın paket kimliğini girin.

  4. (İsteğe bağlı) Diğer uygulama bilgilerini girin: Uygulama takma adı ve Uygulama Mağazası Kimliği .

  5. Uygulamayı kaydet'i tıklayın.

3. Adım : Bir Firebase yapılandırma dosyası ekleyin

  1. Firebase Apple platformları yapılandırma dosyanızı ( GoogleService-Info.plist ) edinmek için GoogleService-Info.plist'i İndir'i tıklayın.

  2. Yapılandırma dosyanızı Xcode projenizin köküne 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.

  1. Xcode'da, uygulama projeniz açıkken File > Add Packages seçeneğine gidin.
  2. İstendiğinde, Firebase Apple platformları SDK deposunu ekleyin:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. Kullanmak istediğiniz SDK sürümünü seçin.

  4. Kullanmak istediğiniz Firebase kitaplıklarını seçin.

    Firebase projenizde Google Analytics etkinleştirilmişse FirebaseAnalytics eklediğinizden emin olun. IDFA toplama özelliği olmayan Analytics için bunun yerine FirebaseAnalyticsWithoutAdId ekleyin.

Bittiğinde, Xcode otomatik olarak arka planda bağımlılıklarınızı çözmeye ve indirmeye başlayacaktır.

5. Adım : Uygulamanızda Firebase'i başlatın

Son adım, uygulamanıza başlatma kodu eklemektir. Bunu, Firebase'i uygulamanıza eklemenin bir parçası olarak zaten yapmış olabilirsiniz. Bir hızlı başlangıç ​​örnek projesi kullanıyorsanız, bu sizin için yapılmıştır.

  1. UIApplicationDelegate uygulamanıza FirebaseCore modülünü ve uygulama temsilcinizin kullandığı diğer Firebase modüllerini içe 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;
// ...
  2. Uygulama temsilcinizin application(_:didFinishLaunchingWithOptions:) yönteminde bir FirebaseApp paylaşılan örneği 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];
  3. SwiftUI kullanıyorsanız, bir uygulama temsilcisi oluşturmalı ve bunu UIApplicationDelegateAdaptor veya NSApplicationDelegateAdaptor aracılığıyla App yapınıza eklemelisiniz. Uygulama temsilcisi swizzling'i 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()
      }
    }
  }
}
  4. Google Analytics için Firebase SDK'sını dahil ettiyseniz, 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 geçebilirsiniz.

Kurulumda sorun yaşıyorsanız, Apple platformları 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 platformu kitaplıkları hakkında daha fazla bilgi edinin:

Hizmet veya Ürün Bölmeler SwiftPM Kitaplıkları Analitik eklensin mi?
adMob pod 'Google-Mobile-Ads-SDK' Yok
Analitik pod 'FirebaseAnalytics' FirebaseAnalytics
Uygulama Kontrolü pod 'FirebaseAppCheck' FirebaseAppCheck
Uygulama Dağıtımı pod 'FirebaseAppDistribution' FirebaseAppDistribution
kimlik doğrulama pod 'FirebaseAuth' FirebaseAuth
Bulut Firestore pod 'FirebaseFirestore' FirebaseFirestore
Firebase İstemci SDK'sı için Bulut İşlevleri pod 'FirebaseFunctions' FirebaseFunctions
Bulut Mesajlaşma pod 'FirebaseMessaging' FirebaseMessaging
Bulut depolama pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
Dinamik Bağlantılar pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
Uygulama İçi Mesajlaşma pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(gerekli)
Firebase kurulumları pod 'FirebaseInstallations' FirebaseInstallations
Firebase ML Özel Model API'leri pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Performans İzleme pod 'FirebasePerformance' FirebasePerformance
Gerçek Zamanlı Veritabanı pod 'FirebaseDatabase' FirebaseDatabase
Uzak Yapılandırma pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

Swift Paket Yöneticisi kullanmadan entegre edin

Swift Paket Yöneticisi'ni kullanmak istemiyorsanız, yine de CocoaPod'ları kullanarak veya çerçeveleri doğrudan içe aktararak Firebase SDK'larından yararlanabilirsiniz.

CocoaPod'lar

Rehberimizde CocoaPods entegrasyonu hakkında daha fazla bilgi edinin.

çerçeveler

iOS platformunu desteklemeye ek olarak, zip artık .xcframework dosyalarını da içeriyor. Ayrıntılar için GitHub'da Firebase Apple platformları SDK README'ye bakın.

  1. Çerçeve SDK zip dosyasını indirin. Bu ~200MB'lik bir dosyadır ve indirilmesi biraz zaman alabilir.

  2. 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:

    Ç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.

  3. -ObjC bağlayıcı bayrağını, hedefinizin yapı ayarlarında Other Linker Settings ekleyin.

Sonraki adımlar

Firebase hakkında bilgi edinin:

Uygulamanıza Firebase hizmetleri ekleyin: