Firebase'i Apple projenize ekleyin

Ön koşullar

  • Aşağıdakileri yükleyin:

    • Xcode 16.2 veya sonraki sürümler

  • Projenizin aşağıdaki koşulları karşıladığından emin olun:

    • Projeniz aşağıdaki platform sürümlerini veya daha yenilerini hedeflemelidir:
      • iOS 13
      • macOS 10.15
      • tvOS 13
      • watchOS 7

  • Fiziksel bir Apple cihaz kurun veya uygulamanızı çalıştırmak için 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 öncelikle uygulamanıza bağlanacak bir Firebase projesi oluşturmanız gerekir. Firebase projeleri hakkında daha fazla bilgi edinmek için Firebase projelerini anlama başlıklı makaleyi inceleyin.

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

Firebase'i Apple uygulamanızda kullanmak için uygulamanızı Firebase projenize kaydetmeniz gerekir. Uygulamanızı kaydetme işlemi 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 zaten 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. Uygulamanızın Firebase yapılandırma dosyasını (GoogleService-Info.plist) almak için GoogleService-Info.plist'i indir'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ği varsa her paketi Firebase konsolunda kayıtlı bir uygulamayla ilişkilendirmeniz gerekir. Böylece her uygulamanın kendi GoogleService-Info.plist dosyası olabilir.

4. adım: Uygulamanıza Firebase SDK'larını ekleyin

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

  1. Xcode'da, uygulamanız açıkken File > Add Packages (Dosya > Paket Ekle) 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 etkinse FirebaseAnalytics eklediğinizden emin olun. Bu sürümde tüm analiz özellikleri bulunur. Ayrıca, tek tek özellikleri de seçebilirsiniz. Firebase SDK'sında Google Analytics için modüllerin en son düzenlenmesiyle ilgili SSS bölümümüze bakın.

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

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

Son adım, uygulamanıza ilk kullanıma hazırlama kodu eklemektir. Firebase'i uygulamanıza ekleme sürecinde bunu yapmış olabilirsiniz. Hızlı başlangıç örnek projesi kullanıyorsanız bu işlem sizin için yapılmıştır.

  1. FirebaseCore modülünü UIApplicationDelegate dosyanıza 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
// ...

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

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

    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 App yapınızda UIApplicationDelegateAdaptor veya NSApplicationDelegateAdaptor aracılığıyla eklemeniz gerekir. Ayrıca uygulama temsilcisi karıştırmayı da devre dışı bırakmanız gerekir. 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'i başarıyla yüklediğiniz Firebase konsoluna doğrulama göndermek için uygulamanızı çalıştırabilirsiniz.

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

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

Hizmet veya Ürün Kapsüller SwiftPM Kitaplıkları Analytics ekleyelim mi?
AdMob pod 'Google-Mobile-Ads-SDK' Yok
Firebase AI Logic 1
 pod 'FirebaseAI' FirebaseAI
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
Data Connect Yok FirebaseDataConnect
Dynamic Links pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
In-App Messaging pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(zorunlu)
Firebase yükleme pod 'FirebaseInstallations' FirebaseInstallations
Firebase ML Özel Model API'leri pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Performance Monitoring pod 'FirebasePerformance' FirebasePerformance
Realtime Database pod 'FirebaseDatabase' FirebaseDatabase
Remote Config pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

1 Firebase AI Logic, daha önce pod 'FirebaseVertexAI' pod'u ve SwiftPM Library FirebaseVertexAI ile birlikte "Vertex AI in Firebase" olarak adlandırılıyordu.

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 yararlanmaya devam edebilirsiniz.

CocoaPods

CocoaPods entegrasyonu hakkında daha fazla bilgiyi rehberimizde bulabilirsiniz.

Çerçeveler

iOS platformunu desteklemenin yanı sıra, zip dosyası artık .xcframework dosyalarını da içeriyor. Ayrıntılar için GitHub'daki Firebase Apple platformları SDK'sı README dosyasına göz atın.

  1. Framework SDK zip dosyasını indirin. Bu dosyanın boyutu yaklaşık 200 MB olduğundan indirilmesi biraz zaman alabilir.

  2. Dosyanın sıkıştırmasını açın ve ardından uygulamanıza eklemek 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 edinmek için indirilen ZIP dağıtımındaki METADATA.md dosyasına bakın.

  3. Hedefinizin derleme ayarlarına Other Linker Settings içinde -ObjC bağlayıcı işaretini ekleyin.

Sonraki adımlar

Firebase hakkında bilgi edinin:

Uygulamanıza Firebase hizmetleri ekleyin: