Apple projenize Firebase ekleyin

Ö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
  • Uygulamanızı çalıştırmak için fiziksel bir Apple cihazı kurun veya bir simülatör kullanı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.

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.

  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 App Store Kimliği .

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

3. Adım : 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 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.

  1. Xcode'da uygulama projeniz açıkken Dosya > Paket Ekle'ye gidin.
  2. İstendiğinde Firebase Apple platformları SDK deposunu ekleyin:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Kullanmak istediğiniz SDK sürümünü seçin.
  5. 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 yerine FirebaseAnalyticsWithoutAdId ekleyin.

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.

  1. FirebaseCore modülünü UIApplicationDelegate ve 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;
    // ...
          
  2. Uygulama temsilcinizin application(_:didFinishLaunchingWithOptions:) yönteminde FirebaseApp paylaşı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];
  3. SwiftUI kullanıyorsanız, bir uygulama temsilcisi oluşturmalı ve bunu UIApplicationDelegateAdaptor veya NSApplicationDelegateAdaptor aracılığıyla App yapı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()
          }
        }
      }
    }
          
  4. 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 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
Uzaktan Yapılandırma pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

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.

  1. Çerçeve SDK zip dosyasını indirin. Bu yaklaşık 200 MB'lık 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ıklarla ilgili bilgi için indirilen zip dağıtımındaki METADATA.md dosyasına bakın.

  3. Hedefinizin derleme ayarlarındaki Other Linker Settings Ayarlarınıza -ObjC bağlayıcı bayrağını ekleyin.

Sonraki adımlar

Firebase hakkında bilgi edinin:

Firebase hizmetlerini uygulamanıza ekleyin: