Memulai Firebase Realtime Database untuk C++

Firebase Realtime Database menyimpan dan menyinkronkan data menggunakan database cloud NoSQL. Data disinkronkan di semua klien secara real-time, dan tetap tersedia ketika aplikasi Anda offline.

Sebelum Memulai

Sebelum dapat menggunakan Firebase Realtime Database, Anda perlu:

• Mendaftarkan project C++ Anda dan mengonfigurasinya agar menggunakan Firebase.

  Jika project C++ Anda telah menggunakan Firebase, berarti project tersebut telah terdaftar dan dikonfigurasi untuk Firebase.

• Menambahkan Firebase C++ SDK ke project C++ Anda.

Temukan petunjuk detail seputar tugas penyiapan awal ini di artikel Menambahkan Firebase ke project C++ Anda.

Perlu diperhatikan bahwa penambahan Firebase ke project C++ Anda memerlukan tindakan baik di Firebase console maupun di project C++ yang terbuka (misalnya, Anda mendownload file konfigurasi Firebase dari konsol, lalu memindahkannya ke project C++).

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.

   Catatan: Jika Anda membuat database dalam mode Pengujian dan tidak mengubah Rules default (dapat dibaca dan ditulisi oleh semua pengguna) dalam periode uji coba, Anda akan diberi tahu melalui email, lalu aturan database Anda akan menolak semua permintaan. Perhatikan tanggal habis masa berlaku selama alur penyiapan Firebase console.

   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.

Membuat dan Menginisialisasi firebase::App

Sebelum dapat mengakses Realtime Database, Anda harus membuat dan menginisialisasi firebase::App.

Anda hanya perlu menginisialisasi firebase::App sekali, berapa pun jumlah fitur Firebase C++ yang digunakan.

Sertakan file header untuk firebase::App:

#include "firebase/app.h"

Android

Buat firebase::App, dengan meneruskan lingkungan JNI dan referensi jobject ke Java Activity sebagai argumen:

app = ::firebase::App::Create(::firebase::AppOptions("APPLICATION NAME"), jni_env, activity);

iOS+

Buat firebase::App:

app = ::firebase::App::Create(::firebase::AppOptions("APPLICATION NAME"));

Mengakses Class firebase::database::Database

firebase::database::Database adalah titik entri untuk Firebase Realtime Database C++ SDK.

::firebase::database::Database *database = ::firebase::database::Database::GetInstance(app);

Jika Anda memilih untuk menggunakan akses publik untuk aturan Anda, lanjutkan ke bagian menyimpan dan mengambil data.

Menyiapkan Akses Terbatas

Jika Anda tidak ingin menggunakan akses publik, tambahkan Firebase Authentication ke aplikasi Anda untuk mengontrol akses ke database.

Langkah Berikutnya

• Pelajari cara membuat struktur data untuk Realtime Database

• Menskalakan data Anda di beberapa instance database.

• Menyimpan data.

• Mengambil data.

• Melihat database di Firebase console.

• Bersiap meluncurkan aplikasi Anda:

  • Siapkan pemberitahuan anggaran untuk project Anda di konsol Google Cloud.
  • Pantau dasbor Usage and billing di Firebase console untuk mendapatkan gambaran keseluruhan penggunaan project Anda di berbagai layanan Firebase. Anda juga dapat membuka dasborRealtime Database Usage untuk mengetahui informasi penggunaan yang lebih mendetail.
  • Periksa checklist peluncuran Firebase.

Masalah Umum

• Pada platform desktop (Windows, Mac, Linux), Firebase C++ SDK menggunakan REST untuk mengakses database Anda. Oleh karena itu, Anda harus mendeklarasikan indeks yang Anda gunakan dengan Query::OrderByChild() di desktop; jika tidak, pemroses Anda akan gagal.
• Versi desktop workflow Realtime Database tidak mendukung offline atau persistensi.