Firebase'i Apple projenize ekleyin

Ön koşullar

  • Aşağıdakileri yükleyin:

    • Xcode 14.1 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 11
      • macOS 10.13
      • tvOS 12
      • watchOS 6
  • 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ı vardır.

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 etkinleştirilmişse 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'ı 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şturup bunu eklemeniz gerekir UIApplicationDelegateAdaptor veyaApp 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ı eklediyseniz üzerinde çalıştığınız Firebase konsoluna doğrulamanızı 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ı Analytics eklensin mi?
AdMob pod 'Google-Mobile-Ads-SDK' Yok
Analizler pod 'FirebaseAnalytics' FirebaseAnalytics
Uygulama Kontrolü pod 'FirebaseAppCheck' FirebaseAppCheck
Uygulama Dağıtımı pod 'FirebaseAppDistribution' FirebaseAppDistribution
Kimlik Doğrulama pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
Cloud Functions for Firebase İstemci SDK'sı pod 'FirebaseFunctions' FirebaseFunctions
Bulut Mesajlaşma pod 'FirebaseMessaging' FirebaseMessaging
Cloud Storage pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
Dinamik Bağlantılar pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
Uygulama içi mesajlaşma pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(zorunlu)
Firebase yüklemeleri pod 'FirebaseInstallations' FirebaseInstallations
Firebase ML Özel Model API'leri pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Performans İzleme pod 'FirebasePerformance' FirebasePerformance
Gerçek Zamanlı Veritabanı pod 'FirebaseDatabase' FirebaseDatabase
Remote Config pod 'FirebaseRemoteConfig' FirebaseRemoteConfig
Firebase için Vertex AI 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. dosyalar. 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: