Penginstalan & Penyiapan di platform Apple

Firebase Realtime Database adalah database yang dihosting di cloud. Data disimpan sebagai JSON dan disinkronkan secara realtime dengan setiap klien yang terhubung. Ketika Anda mem-build aplikasi lintas platform dengan SDK Android, iOS, dan JavaScript kami, semua klien Anda menggunakan satu instance Realtime Database yang sama dan secara otomatis menerima perubahan data terbaru.

Firebase Realtime Database tersedia di semua platform Apple, termasuk iOS, macOS, macOS Catalyst, tvOS, dan watchOS. Firebase Realtime Database tidak tersedia untuk App Clip. Petunjuk penyiapan di halaman ini merujuk ke iOS dalam contoh tertentu, tetapi bersifat umum dan berfungsi untuk semua target platform Apple.

Prasyarat

  1. Instal Firebase SDK.
  2. Tambahkan aplikasi Anda ke project Firebase di Firebase console.

Membuat Database

  1. Buka bagian Realtime Database di Firebase console. Anda akan diminta untuk memilih project Firebase yang ada. Ikuti alur kerja pembuatan database.

  2. Pilih mode awal untuk Firebase Security Rules Anda:

    Mode pengujian

    Cocok untuk memulai dengan library klien seluler dan web, tetapi memungkinkan siapa pun untuk membaca dan menimpa data Anda. Setelah melakukan pengujian, pastikan untuk meninjau bagian Memahami Aturan Firebase Realtime Database.

    Untuk mulai menggunakan Web, Apple, atau Android SDK, pilih mode pengujian.

    Mode terkunci

    Menolak semua pembacaan dan penulisan dari klien seluler dan web. Server aplikasi terautentikasi masih dapat mengakses database Anda.

  3. Pilih lokasi untuk database.

    Bergantung pada lokasi database, URL untuk database baru akan memiliki salah satu format berikut:

    • DATABASE_NAME.firebaseio.com (untuk database di us-central1)

    • DATABASE_NAME.REGION.firebasedatabase.app (untuk database di semua lokasi lain)

  4. Klik Done.

Saat Anda mengaktifkan Realtime Database, API di Pengelola Cloud API juga akan aktif.

Menambahkan Firebase Realtime Database 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.git
  4. Pilih library Realtime Database.
  5. Tambahkan flag -ObjC ke bagian Other Linker Flags pada setelan build target Anda.
  6. Setelah selesai, Xcode akan otomatis mulai me-resolve dan mendownload dependensi Anda di latar belakang.

Konfigurasi Realtime Database Security Rules

Realtime Database menyediakan bahasa aturan deklaratif sehingga Anda dapat menentukan cara data disusun, diindeks, serta kapan data tersebut dapat dibaca dan ditulisi.

Siapkan Firebase Realtime Database

Anda harus melakukan inisialisasi Firebase sebelum ada referensi aplikasi Firebase yang dibuat atau digunakan. Jika hal ini telah dilakukan pada fitur Firebase lainnya, Anda dapat melewati langkah ini.

  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. Buat referensi ke database dan tentukan lokasi yang menjadi tujuan penulisan Anda.

    Swift

    Catatan: Produk Firebase ini tidak tersedia di target App Clip.
    var ref: DatabaseReference!
    
    ref = Database.database().reference()

    Objective-C

    Catatan: Produk Firebase ini tidak tersedia di target App Clip.
    @property (strong, nonatomic) FIRDatabaseReference *ref;
    
    self.ref = [[FIRDatabase database] reference];

Langkah Berikutnya