Firebase'i Apple projenize ekleyin

Ön koşullar

  • Aşağıdakileri yükleyin:

    • Xcode 26.2 veya sonraki sürümler

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

    • Projeniz şu 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.

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 ekleyebilmek için 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 kaydetme

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ından 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. Paket kimliği alanına uygulamanızın paket kimliğini girin.

  4. (İsteğe bağlı) Diğer uygulama bilgilerini girin: Uygulama takma adı ve uygulama mağazası 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 GoogleService-Info.plist dosyasını 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 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: 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ını öğrenmek 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 analiz özelliklerini sağlar. Özellikleri tek tek de seçebilirsiniz. Daha fazla bilgi için Firebase SDK'sı için Google Analytics'daki modüllerin en son düzenlemesi ile ilgili SSS'ye bakın.

İşlem tamamlandığında Xcode, arka planda bağımlılıklarınızı otomatik olarak çözmeye 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 eklerken bu işlemi 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 swizzling'ini de devre dışı bırakmanız gerekir. Daha fazla bilgi için SwiftUI talimatlarını inceleyin.

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

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ı için desteklenen Firebase ürünleri listelenmektedir. Şu Firebase Apple platform kitaplıkları hakkında daha fazla bilgi edinin:

Hizmet veya Ürün Kitaplık / Çerçeve Adı Analytics eklensin 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Ğİ SONLANDIRILMIŞ VEYA DESTEKLENMEYEN KİTAPLIKLAR
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, daha önce FirebaseAI modülü kapsamında da dağıtılıyordu.

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

Swift Package Manager kullanmadan entegre etme

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

Çerçeveler

ZIP dosyası, iOS platformunu desteklemenin yanı sıra artık .xcframework dosyalarını da içeriyor. Ayrıntılar için GitHub'daki Firebase Apple platformları SDK'sı BENİOKU dosyasına bakın.

  1. Çerçeve SDK'sı 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 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ındaki Other Linker Flags dosyanıza -ObjC bağlayıcı işaretini ekleyin.

Sonraki adımlar

Firebase hakkında bilgi:

Uygulamanıza Firebase hizmetlerini ekleme: