Firebase'i Apple projenize ekleyin

Ön koşullar

  • Aşağıdakileri yükleyin:

    • Xcode 26.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 yeni sürümleri hedeflemelidir:
      • iOS 15
      • macOS 10.15
      • tvOS 15
      • watchOS 7

  • Fiziksel bir Apple cihaz kurun veya uygulamanızı çalıştırmak için simülatör kullanın.

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 kaydedin

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) edinmek için Download GoogleService-Info.plist'i (GoogleService-Info.plist'i İndir) 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: Firebase SDK'larını uygulamanıza ekleyin

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

Firebase SDK'larını Apple projenize eklemenin farklı yolları hakkında bilgi edinmek için
  1. Xcode'da, uygulama projeniz açıkken File > Add Packages'a (Dosya > Paket Ekle) 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, tüm Analytics özelliklerini sağlar. Ayrıca, tek tek özellikleri de seçebilirsiniz. Daha fazla bilgi için Firebase SDK'sında Google Analytics için modüllerin en son düzenlenmesiyle ilgili SSS bölümüne 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 başlatma 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 UIApplicationDelegateAdaptor veya NSApplicationDelegateAdaptor aracılığıyla App yapınıza 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ğinizi Firebase konsoluna doğrulama göndermek üzere uygulamanızı çalıştırabilirsiniz.

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

Ancak kurulumda sorun yaşıyorsanız Apple platformları sorun giderme ve SSS sayfasını ziyaret edin.

Kullanılabilen kitaplıklar

Bu bölümde, Apple platformlarında desteklenen Firebase ürünleri listelenmektedir. Bu Firebase Apple platformu kitaplıkları hakkında daha fazla bilgi edinin:

Hizmet veya Ürün Kitaplık / Çerçeve Adı Analytics ekleyelim mi?
AdMob GoogleMobileAds
Firebase AI Logic 1
 FirebaseAILogic
Analytics FirebaseAnalytics
App Check FirebaseAppCheck
App Distribution FirebaseAppDistribution
Authentication FirebaseAuth
Cloud Firestore FirebaseFirestore
Cloud Functions for Firebase Client SDK FirebaseFunctions
Cloud Messaging FirebaseMessaging
Cloud Storage FirebaseStorage
Crashlytics FirebaseCrashlytics
In-App Messaging FirebaseInAppMessaging (zorunlu)
Firebase yükleme FirebaseInstallations
Performance Monitoring FirebasePerformance
Realtime Database FirebaseDatabase
Remote Config FirebaseRemoteConfig
SQL Connect 2 FirebaseDataConnect
DESTEĞİ SONA ERDİRİLMİŞ VEYA DESTEKLENMEYEN KÜTÜPHANELER
Dynamic Links FirebaseDynamicLinks
Firebase ML Özel Model API'leri FirebaseMLModelDownloader

1 Firebase AI Logic (FirebaseAILogic) daha önce "Firebase'de Vertex AI" olarak adlandırılıyordu ve FirebaseVertexAI modülü altında dağıtılıyordu. Firebase AI Logic da daha önce FirebaseAI modülü altında dağıtılıyordu.

2 Firebase SQL Connect, daha önce "Firebase Data Connect" olarak adlandırılıyordu.

Swift Package Manager'ı kullanmadan entegrasyon

Swift Package Manager'ı kullanmak istemiyorsanız önceden derlenmiş çerçeveleri doğrudan içe aktararak Firebase'i entegre etmeye devam edebilirsiniz.

Ç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 bakın .

  1. Framework SDK zip dosyasını indirin. Bu dosya yaklaşık 200 MB boyutundadır ve 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 yerlerde 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ına -ObjC bağlayıcı işaretini Other Linker Flags ekleyin.

Sonraki adımlar

Firebase hakkında bilgi edinin:

Uygulamanıza Firebase hizmetleri ekleyin: