Menambahkan Firebase ke project Apple

Prasyarat

  • Instal yang berikut:

    • Xcode 14.1 atau yang lebih baru
  • Pastikan project Anda memenuhi persyaratan berikut:

    • Project Anda harus menarget versi platform berikut atau yang lebih baru:
      • iOS 11
      • macOS 10.13
      • tvOS 12
      • watchOS 6
  • Siapkan perangkat Apple fisik atau gunakan simulator untuk menjalankan aplikasi Anda.

Jika Anda belum memiliki project Xcode dan hanya ingin mencoba produk Firebase, Anda dapat mendownload salah satu contoh panduan memulai kami.

Langkah 1: Buat project Firebase

Agar dapat menambahkan Firebase ke aplikasi Apple, Anda perlu membuat project Firebase yang akan dihubungkan ke aplikasi Anda. Buka bagian Memahami Project Firebase untuk mempelajari project Firebase lebih lanjut.

Langkah 2: Daftarkan aplikasi Anda ke Firebase

Untuk menggunakan Firebase di aplikasi Apple, Anda perlu mendaftarkan aplikasi ke project Firebase. Mendaftarkan aplikasi sering kali disebut sebagai "menambahkan" aplikasi ke project Anda.

  1. Buka Firebase console.

  2. Di bagian tengah halaman ringkasan project, klik ikon iOS+ untuk meluncurkan alur kerja penyiapan.

    Jika Anda sudah menambahkan aplikasi ke project Firebase, klik Add app untuk menampilkan opsi platform.

  3. Masukkan ID paket aplikasi Anda di kolom bundle ID.

  4. (Opsional) Masukkan informasi lain aplikasi: App nickname dan App Store ID.

  5. Klik Register app.

Langkah 3: Tambahkan file konfigurasi Firebase

  1. Klik Download GoogleService-Info.plist untuk mendapatkan file konfigurasi platform Apple Firebase Anda (GoogleService-Info.plist).

  2. Pindahkan file konfigurasi ke root project Xcode Anda. Jika diminta, pilih untuk menambahkan file konfigurasi ke semua target.

Jika memiliki beberapa ID paket dalam project, Anda harus mengaitkan setiap ID paket dengan aplikasi yang terdaftar di Firebase console, sehingga setiap aplikasi dapat memiliki file GoogleService-Info.plist sendiri.

Langkah 4: Tambahkan Firebase SDK ke aplikasi Anda

Gunakan Swift Package Manager untuk menginstal dan mengelola dependensi Firebase.

  1. Di Xcode, dengan project aplikasi Anda dalam keadaan terbuka, buka File > Add Packages.
  2. Saat diminta, tambahkan repositori SDK platform Apple Firebase:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Pilih versi SDK yang ingin Anda gunakan.
  5. Pilih library Firebase yang ingin Anda gunakan.

    Jika Google Analytics diaktifkan di project Firebase Anda, pastikan untuk menambahkan FirebaseAnalytics. Untuk Analytics tanpa kemampuan pengumpulan IDFA, tambahkan FirebaseAnalyticsWithoutAdId.

Setelah selesai, Xcode akan otomatis mulai me-resolve dan mendownload dependensi Anda di latar belakang.

Langkah 5: Inisialisasi Firebase di aplikasi Anda

Langkah terakhir adalah menambahkan kode inisialisasi ke aplikasi Anda. Anda mungkin sudah melakukannya sebagai bagian dari penambahan Firebase ke aplikasi Anda. Jika Anda menggunakan project contoh panduan memulai, hal ini telah dilakukan untuk Anda.

  1. Impor modul FirebaseCore dalam UIApplicationDelegate Anda, serta semua modul Firebase lainnya yang digunakan oleh delegasi aplikasi Anda. Misalnya, untuk menggunakan Cloud Firestore dan Authentication:

    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. Konfigurasikan instance bersama FirebaseApp di metode application(_:didFinishLaunchingWithOptions:) delegasi aplikasi Anda:

    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. Jika menggunakan SwiftUI, Anda harus membuat delegasi aplikasi dan menambahkannya ke struct App melalui UIApplicationDelegateAdaptor atau NSApplicationDelegateAdaptor. Anda juga harus menonaktifkan swizzling delegasi aplikasi. Untuk mengetahui informasi lebih lanjut, baca petunjuk SwiftUI.

    SwiftUI

    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          
  4. Jika Anda menyertakan Firebase SDK untuk Google Analytics, Anda dapat menjalankan aplikasi untuk mengirim verifikasi ke Firebase console bahwa Anda telah berhasil menginstal Firebase.

Selesai! Anda dapat langsung mengikuti langkah berikutnya.

Jika Anda mengalami kesulitan dalam penyiapan, buka FAQ & pemecahan masalah platform Apple.

Library yang tersedia

Bagian ini mencantumkan produk Firebase yang didukung untuk platform Apple. Pelajari library platform Firebase Apple ini lebih lanjut:

Layanan atau Produk Pod Library SwiftPM Tambahkan Analytics?
AdMob pod 'Google-Mobile-Ads-SDK' T/A
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
Dynamic Links pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
In-App Messaging pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(wajib ada)
Penginstalan Firebase pod 'FirebaseInstallations' FirebaseInstallations
Firebase ML Custom Model API pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Performance Monitoring pod 'FirebasePerformance' FirebasePerformance
Realtime Database pod 'FirebaseDatabase' FirebaseDatabase
Remote Config pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

Melakukan integrasi tanpa menggunakan Swift Package Manager

Jika tidak ingin menggunakan Swift Package Manager, Anda masih dapat memanfaatkan Firebase SDK dengan menggunakan CocoaPods atau mengimpor framework secara langsung.

CocoaPods

Pelajari integrasi CocoaPods lebih lanjut di panduan kami.

Framework

Selain mendukung platform iOS, zip kini menyertakan file .xcframework. Untuk mengetahui detailnya, lihat README Firebase SDK untuk Platform Apple di GitHub.

  1. Download framework SDK zip. File ini berukuran ~200 MB dan mungkin perlu waktu agak lama untuk didownload.

  2. Ekstrak file ini, lalu integrasikan framework yang ingin Anda sertakan dalam aplikasi.

    Anda dapat menemukan petunjuk untuk mengintegrasikan di salah satu dari berikut:

    Untuk mengetahui informasi mengenai versi framework atau dependensi, lihat file METADATA.md dalam distribusi zip yang didownload.

  3. Tambahkan flag linker -ObjC di Other Linker Settings pada setelan build target Anda.

Langkah berikutnya

Mempelajari Firebase:

Menambahkan layanan Firebase ke aplikasi Anda: