Ringkasan Firebase Remote Config API

Firebase Remote Config memiliki API yang memudahkan Anda dalam mengubah perilaku dan tampilan aplikasi tanpa mengharuskan pengguna mendownload update aplikasi tersebut. Ringkasan ini berisi penjelasan berikut:

  • Fitur kunci dari API Remote Config.
  • Library Remote Config dan arsitektur API.

Untuk mempelajari lebih lanjut mengenai Remote Config, lihat Pengantar Remote Config.

Berbagai fitur utama dari API Remote Config

API Remote Config menerapkan fitur-fitur berikut:

  • Kontrol aplikasi Anda ketika parameter value baru diterapkan. Karena perubahan parameter value memengaruhi perilaku dan tampilan aplikasi Anda, desain API mengimplementasikan objek tunggal yang mengambil berbagai nilai di latar belakang, menempatkannya dalam cache, lalu membiarkan aplikasi Anda mengaktifkannya pada waktu yang tepat.
  • Parameter value default dalam aplikasi. Anda menetapkan nilai default dalam aplikasi untuk semua parameter Remote Config pada aplikasi. Nilai ini langsung tersedia untuk aplikasi Anda, sekalipun perangkat tidak tersambung ke internet. Anda mendapatkan nilai yang diambil dan diaktifkan menggunakan metode yang sama seperti yang Anda gunakan untuk mendapatkan nilai default dalam aplikasi.
  • Mengambil dan menerapkan nilai adalah tindakan yang efisien. Mengambil dan mengaktifkan nilai dari layanan Remote Config adalah tindakan yang efisien dan dapat dilakukan secara aman dan berulang. Dengan begitu, Anda tidak perlu menambahkan logika ke aplikasi untuk mendeteksi callback atau menentukan aman tidaknya mengaktifkan nilai yang diambil. Bahkan, Anda dapat menulis aplikasi agar dapat mengirimkan permintaan untuk mengambil parameter value, dan mengaktifkan setiap parameter value yang diambil sebelumnya setiap kali pengguna memulai aplikasi Anda, atau bahkan lebih sering lagi. Jika nilai yang diambil dan diaktifkan tidak tersedia, aplikasi akan menggunakan nilai default dalam aplikasi yang akan memberikan dampak minimal terhadap performa permintaan pengambilan atau panggilan ke activate().

Library Remote Config

Dasar dari arsitektur API Remote Config adalah Library Remote Config. Library Remote Config mengimplementasikan kelas tunggal, FIRRemoteConfig untuk iOS dan FirebaseRemoteConfig untuk Android. Gunakan objek Remote Config untuk melakukan hal-hal berikut:

  • Menetapkan nilai default. Anda tidak perlu mengelola (atau bahkan membuat) parameter pada layanan Remote Config agar aplikasi dapat berfungsi seperti yang diharapkan. Anda dapat melengkapi aplikasi dengan parameter Remote Config sebanyak yang dibutuhkan dan membuat nilai default dalam aplikasi. Nanti, Anda dapat mengganti subset parameter aplikasi dengan membuat parameter di layanan Remote Config.
  • Mengambil, menyimpan, dan mengelola parameter value. Objek Remote Config berisi tiga tingkatan parameter value: Default Config (menyimpan nilai default dalam aplikasi), Active Config (menyimpan nilai yang tersedia untuk aplikasi menggunakan metode get), dan Fetched Config (menyimpan nilai yang terakhir diambil dari Server Remote Config).
  • Mengaktifkan Fetched Config, yang akan mengupdate Active Config. Ketika Fetched Config diaktifkan, parameter value pada Fetched Config akan disalin ke Active Config. Dengan demikian, nilai yang baru diambil akan tersedia untuk aplikasi Anda.

Arsitektur API

Diagram berikut menunjukkan cara aplikasi Anda berinteraksi dengan Remote Config.

Tabel berikut berisi detail tambahan mengenai interaksi antara aplikasi Anda dan Library Remote Config.

Metode dan properti Catatan
Metode dapatkan objek Remote Config:

   iOS: remoteConfig
   Android: getInstance()

Langkah No. 1: Aplikasi Anda memanggil metode ini untuk membuat objek Remote Config (atau memulihkannya dari penyimpanan persisten). Jika objeknya baru dibuat, Fetched Config, Active Config, dan Default Config awalnya "empty" (kosong), tidak berisi parameter value.

Catatan: Jika Anda menguji aplikasi Android menggunakan StrictMode, perlu diperhatikan bahwa panggilan getInstance() awal pada pembuatan aplikasi akan dibaca dari file lokal. Untuk menghindari error pada pembacaan disk StrictMode, panggilan awal ini tidak boleh dilakukan pada thread UI. Semua panggilan getInstance() berikutnya dapat dilakukan dengan aman pada thread UI karena hanya dibaca dari memori. Anda sama sekali tidak boleh membiarkan StrictMode diaktifkan dalam aplikasi yang didistribusikan di Google Play.

Metode setel Default Config:

   iOS: setDefaults():
   Android: setDefaultsAsync()
Langkah No. 2: Aplikasi Anda memanggil metode ini untuk menyetel nilai dalam Default Config. Jika aplikasi Anda mencoba untuk mendapatkan nilai dari objek Remote Config yang baru sebelum nilai tersebut ada dalam Active Config, nilai dari Default Config akan disediakan sebagai gantinya.
Metode ambil:

   iOS:
   fetchWithCompletionHandler:,
   fetchWithExpirationDuration:completionHandler:
   Android: fetch()
Aplikasi Anda menggunakan metode ini untuk melakukan panggilan ke Server Remote Config dan memperoleh parameter value baru, yang disimpan dalam Fetched Config.

Catatan: Metode ambil tidak berpengaruh langsung pada perilaku dan tampilan aplikasi Anda.
Metode aktifkan:

   iOS: activateFetched()
   Android: activate()
Aplikasi Anda mengaktifkan Fetched Config, yang menyalin nilai yang disimpan di sana ke Active Config.
Metode get<type>:

   iOS: configValueForKey:
   Android: getLong(), getString(), dll.
Aplikasi Anda memanggil metode ini untuk mendapatkan parameter value dari Active Config.
Metode setelan Config:

   iOS: initWithDeveloperModeEnabled:
   Android: setConfigSettings()
Digunakan untuk setelan khusus. Saat ini hanya digunakan untuk setelan yang memungkinkan developer aplikasi memuat ulang data aplikasi lebih cepat dari yang diperbolehkan untuk aplikasi produksi. Untuk mempelajari lebih lanjut, baca bagian Memasukkan data ke cache iOS dan Memasukkan data ke cache Android.
Metode dan properti informasi:

   iOS: lastFetchStatus, allKeysWithPrefix:
   Android: getConfigSettings(), getLastFetchStatus(), getKeysByPrefix()
Aplikasi Anda menggunakan metode ini untuk mendapatkan informasi mengenai objek Remote Config. Anda dapat menggunakan metode ini untuk melakukan proses debug selama pengembangan aplikasi.

Untuk mempelajari lebih lanjut mengenai API Remote Config, lihat:

Untuk mulai mengintegrasikan Remote Config dengan aplikasi Anda, baca bagian Menggunakan Remote Config di iOS dan Menggunakan Remote Config di Android.

Kirim masukan tentang...

Butuh bantuan? Kunjungi halaman dukungan kami.