Menghubungkan Aplikasi ke Firebase

Tambahkan Firebase ke project Android jika Anda belum melakukannya.

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.

Menambahkan Realtime Database SDK ke aplikasi

Dalam file Gradle modul (level aplikasi) (biasanya <project>/<app-module>/build.gradle.kts atau <project>/<app-module>/build.gradle), tambahkan dependensi untuk library Realtime Database untuk Android. Sebaiknya gunakan Firebase Android BoM untuk mengontrol pembuatan versi library.

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.4.0"))

    // 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:21.0.0")
}

Mencari modul library khusus Kotlin? Mulai Oktober 2023 (Firebase BoM 32.5.0), developer Kotlin dan Java dapat bergantung pada modul library utama (untuk mengetahui detailnya, lihat FAQ tentang inisiatif ini).

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.

Catatan: Secara default, akses baca dan tulis pada database Anda dibatasi sehingga hanya pengguna terautentikasi yang dapat membaca atau menulis data. Untuk memulai tanpa menyiapkan Authentication, Anda dapat mengonfigurasi aturan untuk akses publik. Tindakan ini membuat database terbuka bagi siapa saja, termasuk orang yang tidak menggunakan aplikasi Anda. Oleh sebab itu, pastikan kembali untuk membatasi database Anda saat menyiapkan autentikasi.

Menulis ke database Anda

Ambil instance database menggunakan getInstance() dan sertakan referensi lokasi tujuan penulisan.

Penting: Untuk mendapatkan referensi ke database selain database default us-central1, Anda harus meneruskan URL database tersebut ke getInstance() (atau database() untuk Kotlin+KTX). Untuk database default us-central1, Anda dapat memanggil getInstance() (atau database) tanpa argumen.

Anda dapat menemukan URL Realtime Database di bagian Realtime Database pada Firebase console. Bergantung pada lokasi database, URL database akan memiliki salah satu format berikut:

• https://DATABASE_NAME.firebaseio.com (untuk database di us-central1)
• https://DATABASE_NAME.REGION.firebasedatabase.app (untuk database di semua lokasi lain)

Kotlin+KTX

// Write a message to the database
val database = Firebase.database
val myRef = database.getReference("message")

myRef.setValue("Hello, World!")
MainActivity.kt

Java

// Write a message to the database
FirebaseDatabase database = FirebaseDatabase.getInstance();
DatabaseReference myRef = database.getReference("message");

myRef.setValue("Hello, World!");
MainActivity.java

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())
    }
})
MainActivity.kt

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());
    }
});
MainActivity.java

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 menulisi 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

• Pelajari cara membuat struktur data untuk Realtime Database
• Menskalakan data Anda ke beberapa instance database.
• Membaca dan menulisi data.
• Melihat database di Firebase console.