Buka konsol

Menggunakan Firebase Remote Config di Android

Anda bisa menggunakan Firebase Remote Config untuk menetapkan parameter di dalam aplikasi dan mengupdate value-nya di cloud, sehingga Anda bisa memodifikasi tampilan dan perilaku aplikasi tanpa mendistribusikan update aplikasi. Panduan ini menunjukkan cara menggunakan Remote Config di aplikasi Anda, dengan mengikuti langkah-langkah berikut:

  1. Menambahkan Firebase ke aplikasi.
  2. Mendapatkan objek tunggal Remote Config.
  3. Menetapkan parameter value default dalam aplikasi.
  4. Mendapatkan parameter value yang akan digunakan dalam aplikasi Anda.
  5. Menetapkan parameter value dalam layanan Remote Config (jika perlu).
  6. Mengambil dan mengaktifkan value dari layanan Remote Config (jika perlu).

Menambahkan Firebase ke aplikasi

  1. Tambahkan Firebase ke project Android jika Anda belum melakukannya.

  2. Tambahkan dependensi untuk library Android Remote Config ke file Gradle modul (level aplikasi) Anda (biasanya app/build.gradle):

    implementation 'com.google.firebase:firebase-config:16.5.0'
    

Mendapatkan objek tunggal Remote Config

Dapatkan objek tunggal Remote Config menggunakan metode FirebaseRemoteConfig.getInstance(), seperti yang ditunjukkan pada aplikasi contoh quickstart Remote Config.

Objek tunggal ini digunakan untuk menyimpan parameter value default dalam aplikasi, mengambil parameter value terbaru dari layanan, dan mengontrol kapan nilai yang diambil akan tersedia untuk aplikasi Anda. Untuk mempelajari lebih lanjut, lihat Ringkasan API Firebase Remote Config.

Menetapkan parameter value default dalam aplikasi

Anda harus menyetel parameter value default dalam aplikasi pada objek Remote Config, sehingga perilaku aplikasi Anda dapat diperkirakan sebelum mengambil value dari layanan Remote Config.

  1. Tetapkan satu set nama parameter dan parameter value default menggunakan objek Map atau file resource XML yang tersimpan dalam folder res/xml aplikasi Anda. Aplikasi contoh quickstart Remote Config menggunakan file XML untuk menetapkan nama dan parameter value default.
  2. Tambahkan nilai ke objek Remote Config menggunakan setDefaultsAsync(int), seperti yang ditunjukkan pada aplikasi contoh quickstart Remote Config.

Mendapatkan parameter value yang akan digunakan dalam aplikasi Anda

Sekarang, Anda bisa mendapatkan parameter value dari objek Remote Config. Jika Anda menetapkan nilai pada layanan Remote Config, mengambilnya, kemudian mengaktifkannya, nilai tersebut akan tersedia untuk aplikasi Anda. Jika tidak, Anda mendapatkan parameter value dalam aplikasi yang dikonfigurasi menggunakan setDefaultsAsync(int). Untuk mendapatkan nilai ini, panggil metode yang terdaftar di bawah ini, yang memetakan ke jenis data yang diharapkan oleh aplikasi Anda, dengan kunci parameter sebagai argumen:

Menetapkan parameter value dalam layanan (jika perlu)

  1. Buka project Anda di Firebase console.
  2. Pilih Remote Config dari menu untuk melihat dasbor Remote Config.
  3. Tetapkan parameter dengan nama yang sama dengan parameter yang Anda tetapkan dalam aplikasi. Untuk setiap parameter, Anda bisa menyetel value default (yang akan mengganti value default dalam aplikasi yang sesuai) dan Anda juga bisa menyetel value kondisional. Untuk mempelajari lebih lanjut, lihat Parameter dan Ketentuan Remote Config.

Mengambil dan mengaktifkan value dari layanan (jika perlu)

  1. Untuk mengambil parameter value dari layanan Remote Config, panggil metode fetch(). Setiap nilai yang Anda tetapkan dalam layanan Remote Config akan diambil dan disimpan di objek Remote Config.
  2. Untuk membuat parameter value yang diambil tersedia untuk aplikasi Anda, panggil metode activate().

Karena parameter value terbaru ini memengaruhi perilaku dan tampilan aplikasi, Anda harus mengaktifkan nilai yang diperoleh pada saat yang tepat guna memberikan pengalaman yang baik bagi pengguna, misalnya ketika pengguna membuka aplikasi Anda.

Langkah berikutnya

Untuk melihat aplikasi contoh panduan mulai cepat Remote Config secara lebih dalam, lihat Panduan Aplikasi Contoh Android Firebase Remote Config.

Untuk mempelajari cara menggunakan Remote Config di aplikasi Anda lebih lanjut, baca Pertanyaan Umum (FAQ) tentang Remote Config mengenai cara mengambil dan mengaktifkan parameter value, mode developer dan throttling, dan waktu pengambilan.