Firebase'i Apple projenize ekleyin

Ön koşullar

  • Aşağıdakileri yükleyin:

    • Xcode 14.1 veya üzeri
  • Projenizin şu gereklilikleri karşıladığından emin olun:

    • Projeniz aşağıdaki platform sürümlerini veya sonraki sürümleri hedeflemelidir:
      • iOS 11
      • macOS 10.13
      • tvOS 12
      • watchOS 6
  • Fiziksel bir Apple cihazı kurun veya uygulamanızı çalıştırmak için simülatör kullanın.

Halihazırda bir Xcode projeniz yoksa ve sadece 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 ekleyebilmek için öncelikle uygulamanıza bağlamak üzere bir Firebase projesi oluşturmanız gerekir. Firebase projeleri hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama sayfasını ziyaret edin.

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

Apple uygulamanızda Firebase'i kullanmak için uygulamanızı Firebase projenize kaydetmeniz gerekir. Uygulamanızı kaydetmek, genellikle uygulamanızı projenize "ekleme" 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+ simgesini tıklayın.

    Firebase projenize bir uygulama eklediyseniz platform seçeneklerini görüntülemek için Uygulama ekle'yi 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 platforms yapılandırma dosyanızı (GoogleService-Info.plist) almak için Download GoogleService-Info.plist (GoogleService-Info.plist dosyasını indirin) seçeneğini 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 eklemeyi seçin.

Projenizde birden fazla paket kimliği 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ı yüklemek ve yönetmek için Swift Package Manager'ı kullanın.

  1. Xcode'da, uygulama projeniz açıkken File > Add Packages'a (Dosya > Paket Ekle) gidin.
  2. İstendiğinde Firebase Apple platform 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 projesini eklediğinizden emin olun. IDFA toplama özelliksiz Analytics için bunun yerine FirebaseAnalyticsWithoutAdId özelliğini ekleyin.

İşlem tamamlandığında Xcode, arka planda bağımlılıklarınızı çözümlemeye ve indirmeye otomatik olarak başlar.

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

Son adım, uygulamanıza ilk kullanıma hazırlama kodunu eklemektir. Uygulamanıza Firebase'i eklerken bu işlemi daha önce yapmış olabilirsiniz. Hızlı başlangıç örnek projesini kullanıyorsanız bunu yapabilirsiniz.

  1. FirebaseCore modülünü UIApplicationDelegate ve uygulamanızda yetki verdiğiniz diğer Firebase modüllerini içe aktarın. Örneğin, Cloud Firestore ve Authentication'ı kullanmak için:

    Hızlı Kullanıcı Arayüzü

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

    Swift

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Uygulama temsilcinizin application(_:didFinishLaunchingWithOptions:) yönteminde FirebaseApp paylaşılan örneğini yapılandırın:

    Hızlı Kullanıcı Arayüzü

    // 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 yetkisi vermeniz ve bunu UIApplicationDelegateAdaptor veya NSApplicationDelegateAdaptor aracılığıyla App struct'ınıza eklemeniz gerekir. Uygulama yetkisini kaydırmayı da devre dışı bırakmanız gerekir. Daha fazla bilgi için SwiftUI talimatlarına bakın.

    Hızlı Kullanıcı Arayüzü

    @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'i başarıyla yüklediğinize dair Firebase konsoluna doğrulama göndermek için uygulamanızı çalıştırabilirsiniz.

Hepsi bu kadar! Sonraki adımlara atlayabilirsiniz.

Kurulum sırasında sorun yaşıyorsanız Apple platformları ile ilgili sorunları giderme ve SSS sayfasını ziyaret edin.

Kullanılabilen kitaplıklar

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 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 entegrasyon

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

CocoaPods

CocoaPods entegrasyonu hakkında daha fazla bilgiyi kılavuzumuzda bulabilirsiniz.

Çerçeveler

Zip dosyası, iOS platformunu desteklemenin yanı sıra artık .xcframework dosyalarını da içeriyor. Ayrıntılı bilgi için GitHub'daki BENİOKU Firebase Apple platformları SDK'sı bölümüne bakın.

  1. framework SDK zip'ini indirin. Bu dosya yaklaşık 200 MB boyutundadır ve indirilmesi biraz zaman alabilir.

  2. Dosyayı arşivden çıkartın, ardından uygulamanıza eklemek istediğiniz çerçeveleri entegre edin.

    Entegrasyon talimatlarını aşağıda belirtilen yerlerde 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ı işaretini, hedefinizin derleme ayarlarından Other Linker Settings bölümüne ekleyin.

Sonraki adımlar

Firebase hakkında bilgi edinin:

Uygulamanıza Firebase hizmetlerini ekleyin: