Hubungkan Aplikasi Anda ke Firebase, Hubungkan Aplikasi Anda ke Firebase

Jika Anda belum melakukannya, tambahkan Firebase ke proyek Android Anda .

Buat Basis Data

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

2. Pilih mode awal untuk Aturan Keamanan Firebase Anda:

   Modus uji

   Baik untuk memulai dengan pustaka klien seluler dan web, tetapi mengizinkan siapa saja untuk membaca dan menimpa data Anda. Setelah pengujian, pastikan untuk meninjau bagian Memahami Aturan Firebase Realtime Database .

   Catatan: Jika Anda membuat database dalam mode Tes dan tidak membuat perubahan pada Aturan default yang dapat dibaca dunia dan dapat ditulis dunia dalam periode uji coba, Anda akan diberi tahu melalui email, lalu aturan database Anda akan menolak semua permintaan. Catat tanggal kedaluwarsa selama alur penyiapan konsol Firebase.

   Untuk memulai web, Apple, atau Android SDK, pilih testmode.

   Modus terkunci

   Menolak semua operasi baca dan tulis dari klien seluler dan web. Server aplikasi terotentikasi Anda masih dapat mengakses database Anda.

3. Pilih lokasi untuk database.

   Bergantung pada lokasi basis data , URL untuk basis data baru akan berupa salah satu bentuk berikut:

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

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

4. Klik Selesai .

Saat Anda mengaktifkan Realtime Database, ini juga mengaktifkan API di Cloud API Manager .

Tambahkan Realtime Database SDK ke aplikasi Anda

Dalam file Gradle modul (level aplikasi) Anda (biasanya <project>/<app-module>/build.gradle ), tambahkan dependensi untuk library Android Realtime Database. Kami merekomendasikan penggunaan 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:31.2.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-ktx'
}

Dengan menggunakan Firebase Android BoM , aplikasi Anda akan selalu menggunakan versi pustaka Android Firebase yang kompatibel.

(Alternatif) Tambahkan dependensi library Firebase tanpa menggunakan BoM

Jika Anda memilih untuk tidak menggunakan Firebase BoM, Anda harus menentukan setiap versi pustaka Firebase di baris dependensinya.

Perhatikan bahwa jika Anda menggunakan beberapa pustaka Firebase di aplikasi Anda, kami sangat menyarankan penggunaan BoM untuk mengelola versi pustaka, 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.1.0'
}

Java

dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:31.2.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 pustaka Android Firebase yang kompatibel.

(Alternatif) Tambahkan dependensi library Firebase tanpa menggunakan BoM

Jika Anda memilih untuk tidak menggunakan Firebase BoM, Anda harus menentukan setiap versi pustaka Firebase di baris dependensinya.

Perhatikan bahwa jika Anda menggunakan beberapa pustaka Firebase di aplikasi Anda, kami sangat menyarankan penggunaan BoM untuk mengelola versi pustaka, 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.1.0'
}

Konfigurasikan Aturan Database Realtime

Realtime Database menyediakan bahasa aturan deklaratif yang memungkinkan Anda menentukan struktur data, cara pengindeksan, dan kapan data dapat dibaca dan ditulis.

Catatan: Secara default, akses baca dan tulis ke database Anda dibatasi sehingga hanya pengguna yang diautentikasi yang dapat membaca atau menulis data. Untuk memulai tanpa menyetel Otentikasi , Anda dapat mengonfigurasi aturan untuk akses publik . Hal ini membuat database Anda terbuka untuk siapa saja, bahkan orang yang tidak menggunakan aplikasi Anda, jadi pastikan untuk membatasi database Anda lagi saat menyiapkan autentikasi.

Menulis ke database Anda

Ambil instance database Anda menggunakan getInstance() dan referensikan lokasi yang ingin Anda tulis.

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

Anda dapat menemukan URL Realtime Database di bagian Realtime Database di konsol Firebase . Bergantung pada lokasi basis data , URL basis data akan berada dalam salah satu bentuk 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 tipe data ke database dengan cara ini, termasuk objek Java. Saat Anda menyimpan objek, respons dari pengambil apa pun akan disimpan sebagai anak dari lokasi ini.

Baca dari database Anda

Untuk memperbarui data aplikasi Anda secara realtime, Anda harus menambahkan ValueEventListener ke referensi yang baru saja Anda buat.

Metode onDataChange() di kelas ini dipicu sekali saat pemroses terpasang dan dipicu lagi setiap kali data berubah, 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(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(DatabaseError error) {
        // Failed to read value
        Log.w(TAG, "Failed to read value.", error.toException());
    }
});
MainActivity.java

Opsional: Konfigurasikan ProGuard

Saat menggunakan Firebase Realtime Database di aplikasi Anda bersama dengan ProGuard, Anda perlu mempertimbangkan bagaimana objek model Anda akan diserialkan dan dideserialisasi setelah obfuscation. Jika Anda 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 ProGuard, kunjungi forum Komunitas Guardsquare untuk mendapatkan bantuan dari pakar.

Bersiap untuk Peluncuran

Sebelum meluncurkan aplikasi Anda, sebaiknya lihat daftar periksa peluncuran kami untuk memastikan aplikasi Anda siap digunakan!

Pastikan untuk mengaktifkan App Check untuk membantu memastikan bahwa hanya aplikasi Anda yang dapat mengakses database Anda.

Langkah selanjutnya

• Pelajari cara menyusun data untuk Realtime Database
• Menskalakan data Anda di berbagai instans basis data .
• Membaca dan menulis data .
• Lihat database Anda di konsol Firebase .