Tambahkan Firebase ke project Android jika Anda belum melakukannya.
Membuat Database
Buka bagian Realtime Database di Firebase console. Anda akan diminta untuk memilih project Firebase yang ada. Ikuti alur kerja pembuatan database.
Pilih mode awal untuk Aturan Keamanan Firebase Anda:
- Mode uji
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.
Pilih lokasi untuk database.
Bergantung pada lokasi database, URL untuk database baru akan memiliki salah satu format berikut:
(untuk database diDATABASE_NAME.firebaseio.com
us-central1
) (untuk database di semua lokasi lain)DATABASE_NAME.REGION.firebasedatabase.app
Klik Done.
Saat Anda mengaktifkan Realtime Database, API di Pengelola Cloud API juga akan aktif.
Menambahkan Realtime Database SDK ke aplikasi Anda
Dalam file Gradle modul (level aplikasi) (biasanya<project>/<app-module>/build.gradle.kts
atau <project>/<app-module>/build.gradle
), tambahkan dependensi untuk library Android Realtime Database. Sebaiknya gunakan Firebase Android BoM untuk mengontrol pembuatan versi library.
Kotlin+KTX
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:32.3.1")) // Add the dependency for the Realtime Database library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-database-ktx") }
Dengan menggunakan Firebase Android BoM, aplikasi Anda akan selalu menggunakan versi library Android Firebase yang kompatibel.
(Alternatif) Tambahkan dependensi library Firebase tanpa menggunakan BoM
Jika memilih untuk tidak menggunakan Firebase BoM, Anda harus menentukan setiap versi library Firebase di baris dependensinya.
Perlu diperhatikan bahwa jika Anda menggunakan beberapa library Firebase di aplikasi, sebaiknya gunakan BoM untuk mengelola versi library, yang memastikan bahwa semua versi kompatibel.
dependencies { // Add the dependency for the Realtime Database library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-database-ktx:20.2.2") }
Java
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:32.3.1")) // Add the dependency for the Realtime Database library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-database") }
Dengan menggunakan Firebase Android BoM, aplikasi Anda akan selalu menggunakan versi library Android Firebase yang kompatibel.
(Alternatif) Tambahkan dependensi library Firebase tanpa menggunakan BoM
Jika memilih untuk tidak menggunakan Firebase BoM, Anda harus menentukan setiap versi library Firebase di baris dependensinya.
Perlu diperhatikan bahwa jika Anda menggunakan beberapa library Firebase di aplikasi, sebaiknya gunakan BoM untuk mengelola versi library, yang memastikan bahwa semua versi kompatibel.
dependencies { // Add the dependency for the Realtime Database library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-database:20.2.2") }
Mengonfigurasi Aturan Keamanan Realtime Database
Realtime Database menyediakan bahasa aturan deklaratif sehingga Anda dapat menentukan cara data disusun dan diindeks, serta kapan data tersebut dapat dibaca dan ditulisi.
Menulis ke database Anda
Ambil instance database menggunakan getInstance()
dan sertakan referensi lokasi tujuan penulisan.
Kotlin+KTX
// Write a message to the database val database = Firebase.database val myRef = database.getReference("message") myRef.setValue("Hello, World!")
Java
// Write a message to the database FirebaseDatabase database = FirebaseDatabase.getInstance(); DatabaseReference myRef = database.getReference("message"); myRef.setValue("Hello, World!");
Anda bisa menyimpan berbagai jenis data ke database dengan cara ini, termasuk objek Java. Ketika Anda menyimpan sebuah objek, respons dari semua pengambil akan disimpan sebagai turunan lokasi ini.
Membaca dari database Anda
Agar data aplikasi diperbarui secara real-time, Anda harus menambahkan ValueEventListener
ke referensi yang baru saja dibuat.
Metode onDataChange()
di class ini dipicu satu kali saat pemroses ditambahkan dan dipicu lagi setiap kali terjadi perubahan data, termasuk turunannya.
Kotlin+KTX
// Read from the database myRef.addValueEventListener(object : ValueEventListener { override fun onDataChange(dataSnapshot: DataSnapshot) { // This method is called once with the initial value and again // whenever data at this location is updated. val value = dataSnapshot.getValue<String>() Log.d(TAG, "Value is: $value") } override fun onCancelled(error: DatabaseError) { // Failed to read value Log.w(TAG, "Failed to read value.", error.toException()) } })
Java
// Read from the database myRef.addValueEventListener(new ValueEventListener() { @Override public void onDataChange(@NonNull DataSnapshot dataSnapshot) { // This method is called once with the initial value and again // whenever data at this location is updated. String value = dataSnapshot.getValue(String.class); Log.d(TAG, "Value is: " + value); } @Override public void onCancelled(@NonNull DatabaseError error) { // Failed to read value Log.w(TAG, "Failed to read value.", error.toException()); } });
Opsional: Mengonfigurasi ProGuard
Ketika menggunakan Firebase Realtime Database di aplikasi Anda bersama dengan ProGuard, Anda perlu mempertimbangkan bagaimana objek model akan di-serialisasi dan di-deserialisasi setelah obfuscation dilakukan. Jika menggunakan DataSnapshot.getValue(Class)
atau DatabaseReference.setValue(Object)
untuk membaca dan menulis data, Anda perlu menambahkan aturan ke file proguard-rules.pro
:
# Add this global rule
-keepattributes Signature
# This rule will properly ProGuard all the model classes in
# the package com.yourcompany.models.
# Modify this rule to fit the structure of your app.
-keepclassmembers class com.yourcompany.models.** {
*;
}
Untuk mendapatkan bantuan atas pertanyaan atau masalah terkait dengan ProGuard, buka forum Komunitas Guardsquare untuk mendapatkan bantuan dari pakar.
Persiapan untuk Peluncuran
Sebelum meluncurkan aplikasi, sebaiknya Anda membaca checklist peluncuran untuk memastikan aplikasi siap diluncurkan.
Pastikan Anda mengaktifkan App Check untuk membantu memastikan bahwa hanya aplikasi Anda yang dapat mengakses database.
Langkah Berikutnya
- Mempelajari cara membuat struktur data untuk Realtime Database.
- Menskalakan data Anda ke beberapa instance database.
- Membaca dan menulisi data.
- Melihat database di Firebase console.