Firebase'i Apple projenize ekleyin

Ön koşullar

  • Aşağıdakileri yükleyin:

    • Xcode 15.2 veya sonraki sürümler
  • Projenizin şu gereklilikleri karşıladığından emin olun:

    • Projeniz şu platform sürümlerini veya sonraki sürümleri hedeflemelidir:
      • iOS 13
      • macOS 10.15
      • tvOS 13
      • watchOS 7
  • Uygulamanızı çalıştırmak için fiziksel bir Apple cihazı kurun veya simülatör kullanın.

Xcode projeniz yoksa ve bir Firebase'i denemek istiyorsanız hızlı başlangıç örneklerimizden birini indirebilirsiniz.

1. Adım: Firebase projesi oluşturun

Firebase'i Apple uygulamanıza ekleyebilmek için öncelikle bir Firebase oluşturmanız gerekir projenize bağlanabilirsiniz. Ziyaret edin: Şu konular hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama: Firebase projeleri.

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

Firebase'i Apple uygulamanızda kullanmak için uygulamanızı Firebase projesi. Uygulamanızı kaydetme işlemi genellikle "ekleme" olarak adlandırılır uygulamanızı belirler.

  1. Firebase konsoluna gidin.

  2. Projeye genel bakış sayfasının ortasındaki iOS+ simgesini tıklayın. kurulum iş akışını başlatın.

    Firebase projenize daha önce uygulama eklediyseniz Uygulama ekle'yi tıklayın tıklayın.

  3. Uygulamanızın paket kimliğini paket kimliği alanına 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'ınızı edinmek için GoogleService-Info.plist dosyasını indir'i tıklayın platformların yapılandırma dosyasına (GoogleService-Info.plist) bakın.

  2. Yapılandırma dosyanızı Xcode projenizin köküne taşıyın. İstenirse Yapılandırma dosyasını tüm hedeflere eklemeyi seçin.

Projenizde birden fazla paket kimliği varsa her paketi ilişkilendirmeniz gerekir. Firebase konsolunda kayıtlı bir uygulamayla kimlik doğrulaması yaparak her uygulamanın kendine ait GoogleService-Info.plist dosyası var.

4. Adım: Firebase SDK'larını uygulamanıza ekleyin

Firebase bağımlılıklarını yükleyip yönetmek için Swift Package Manager'ı kullanın.

  1. Xcode'da, uygulama projeniz açıkken Dosya > Paket Ekle'yi tıklayın.
  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 ekleyin. IDFA toplamasız Analytics için özelliği yerine FirebaseAnalyticsWithoutAdId ekleyin.

İşlemi tamamladığınızda, Xcode otomatik olarak arka planda tutmalarını sağlar.

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

Son adım, uygulamanıza başlatma kodu eklemektir. Sahip olduğunuz Bunu, uygulamanıza Firebase'i eklerken yapmışsınızdır. Bir örnek proje hızlı başlangıç kılavuzundan yararlanmaya başlayabilirsiniz.

  1. FirebaseCore modülünü UIApplicationDelegate ve diğer Yetki verdiğiniz uygulamanın kullandığı Firebase modülleri. Örneğin, Cloud Firestore ve Authentication özelliklerini kullanmak için:

    SwiftUI

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Swift

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Şunu yapılandır: FirebaseApp paylaşılan örneğinizin application(_:didFinishLaunchingWithOptions:) yöntemi:

    SwiftUI

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Swift

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. SwiftUI kullanıyorsanız bir uygulama temsilcisi oluşturmanız ve bunu eklemeniz gerekir App struct'ınıza UIApplicationDelegateAdaptor veya NSApplicationDelegateAdaptor. Uygulama yetkisi kaydırmayı da devre dışı bırakmanız gerekir. Örneğin, 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 üzerinde kontrol sahibi olduğunuz Firebase konsoluna doğrulama Firebase başarıyla yüklendi.

Hepsi bu kadar! Sonraki adımlara geçebilirsiniz.

Ancak kurulum konusunda sorun yaşıyorsanız şu sayfayı ziyaret edin: Apple platformlarında sorun giderme ve SSS.

Kullanılabilen kitaplıklar

Bu bölümde, Apple platformlarında desteklenen Firebase ürünleri listelenmektedir. Öğren aşağıdaki Firebase Apple platform kitaplıkları hakkında daha fazla bilgi edinin:

Hizmet veya Ürün Kapsüller SwiftPM Kitaplıkları Google Analytics.">Analytics eklensin mi?
AdMob pod 'Google-Mobile-Ads-SDK' Yok
Analytics pod 'FirebaseAnalytics' FirebaseAnalytics
App Check pod 'FirebaseAppCheck' FirebaseAppCheck
App Distribution pod 'FirebaseAppDistribution' FirebaseAppDistribution
Authentication pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
Cloud Functions for Firebase Client SDK pod 'FirebaseFunctions' FirebaseFunctions
Cloud Messaging pod 'FirebaseMessaging' FirebaseMessaging
Cloud Storage pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
Dynamic Links pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
In-App Messaging pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(zorunlu)
Firebase yükleme pod 'FirebaseInstallations' FirebaseInstallations
Firebase ML Özel Model API'si pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Performance Monitoring pod 'FirebasePerformance' FirebasePerformance
Realtime Database pod 'FirebaseDatabase' FirebaseDatabase
Remote Config pod 'FirebaseRemoteConfig' FirebaseRemoteConfig
Vertex AI in Firebase Yok FirebaseVertexAI-Preview

Swift Package Manager'ı kullanmadan entegre et

Swift Package Manager'ı kullanmak istemiyorsanız Firebase SDK'larını CocoaPods kullanarak veya çerçeveleri doğrudan içe aktararak.

CocoaPods

CocoaPods entegrasyonu hakkında daha fazla bilgiyi şuradan edinebilirsiniz: burada bulabilirsiniz.

Çerçeveler

Zip dosyası, iOS platformunun yanı sıra artık .xcframework bileşenini de içeriyor. dosyası olarak da kaydedebilir. Ayrıntılar için Firebase BENİOKU BENİOKU Apple platformları SDK'sı GitHub ,

  1. framework SDK'sının ZIP dosyasını indirin. Bu ~200 MB'lık bir dosyadır ve biraz zaman alabilir.

  2. Dosyayı arşivden çıkartın ve ardından dahil etmek istediğiniz çerçeveleri entegre edin dokunun.

    Entegrasyon talimatlarını aşağıdaki yerlerden birinde bulabilirsiniz:

    Çerçeve sürümleri veya bağımlılıkları hakkında bilgi için şuraya bakın: İndirilen zip dağıtımı içinde METADATA.md dosya var.

  3. URL'yi -ObjC bağlayıcı işareti Other Linker Settingsnda, hedefinizin derleme ayarlarından yapabilirsiniz.

Sonraki adımlar

Firebase hakkında bilgi edinin:

Uygulamanıza Firebase hizmetlerini ekleyin: