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 11
      • tvOS 15
      • watchOS 8

  • 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 kaydedin

Apple uygulamanızda Firebase'i 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 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 paketin kendi GoogleService-Info.plist dosyası olabilmesi için her paket kimliğini Firebase konsolunda kayıtlı bir uygulamayla ilişkilendirmeniz gerekir.

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.

  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, bağımlılıklarınızı otomatik olarak çözümlemeye ve arka planda 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 ve uygulama temsilcinizin kullandığı diğer Firebase modüllerini içe 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 FirebaseApp application(_:didFinishLaunchingWithOptions:) yönteminde paylaşılan bir örnek 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şturup aracılığıyla UIApplicationDelegateAdaptor veya NSApplicationDelegateAdaptor kullanarak 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ğiniz 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ında sorun giderme ve SSS başlıklı makaleyi inceleyin.

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: