Menerapkan versi aplikasi minimum dengan Remote Config

Seiring berkembangnya aplikasi Anda, rilis baru dapat memperkenalkan perubahan yang merusak pada API backend, menyelesaikan kerentanan keamanan penting, atau menggantikan layanan dan model AI yang tidak digunakan lagi. Dalam situasi ini, versi aplikasi sebelumnya dapat berhenti berfungsi dengan andal atau aman.

Dengan Remote Config, Anda dapat mengontrol persyaratan versi aplikasi secara dinamis dari cloud. Dengan menentukan parameter versi di Remote Config, Anda dapat mendorong atau mewajibkan pengguna mengupdate aplikasi mereka tanpa men-deploy infrastruktur server kustom atau merilis update darurat.

Memilih strategi update

Remote Config menyediakan parameter versi untuk dievaluasi di klien, memungkinkan Anda mengonfigurasi UI update aplikasi untuk salah satu dari dua strategi bergantung pada tingkat keparahan perubahan:

  • Update paksa (pemblokiran): Jika versi aplikasi sebelumnya tidak kompatibel dengan backend Anda atau menimbulkan risiko keamanan, Anda dapat memblokir akses ke aplikasi hingga pengguna melakukan update. Jika versi yang diinstal lebih lama dari minimum yang diperlukan, Anda dapat mengonfigurasi aplikasi untuk menampilkan dialog yang tidak dapat ditutup yang mengarahkan pengguna ke app store platform untuk menginstal versi terbaru.
  • Update fleksibel (opsional): Jika update memperkenalkan fitur baru, peningkatan performa, atau perbaikan bug kecil, Anda dapat mengonfigurasi aplikasi untuk menampilkan banner atau dialog yang dapat ditutup yang mendorong pengguna untuk mengupdate kapan saja mereka mau sambil memungkinkan mereka terus menggunakan aplikasi.

Langkah 1: Konfigurasi parameter di Firebase console

Untuk mengelola versi aplikasi, tentukan parameter dalam template Remote Config Anda:

  1. Di konsol Firebase, buka DevOps & Engagement > Remote Config > Parameters page.
  2. Klik Tambahkan parameter (atau Buat konfigurasi jika ini adalah parameter pertama Anda).
  3. Tentukan parameter berikut:
    • minimum_version: String yang merepresentasikan versi aplikasi paling awal yang didukung (misalnya, "2.4.0"). Aplikasi yang menjalankan versi lebih awal dari nilai ini akan diblokir hingga diupdate.
    • latest_version (opsional): String yang merepresentasikan versi terbaru aplikasi Anda yang tersedia (misalnya, "2.5.1"). Aplikasi yang menjalankan versi antara minimum_version dan latest_version dapat menampilkan rekomendasi update opsional.
    • update_url (opsional): URL toko tempat pengguna dapat mendownload update (seperti listingan Google Play Store atau Apple App Store Anda).
  4. Opsional: Tambahkan kondisi khusus platform:
    • Karena aplikasi Android dan Apple sering menggunakan versi rilis dan URL toko yang berbeda, Anda dapat menambahkan nilai kondisional untuk setiap platform di parameter yang sama.
    • Klik Tambahkan nilai untuk kondisi > Buat kondisi. Beri nama kondisi (seperti Android App atau iOS App), pilih Aplikasi sebagai aturan penargetan, lalu pilih aplikasi Anda.
    • Tetapkan string versi yang sesuai untuk setiap kondisi platform, dan pertahankan nilai default sebagai penggantian.
  5. Klik Simpan, lalu klik Publikasikan perubahan untuk menerapkan template.

Langkah 2: Menerapkan pemeriksaan versi sisi klien

Di klien, periksa versi aplikasi terinstal dengan parameter Remote Config selama startup:

  1. Tetapkan nilai default dalam aplikasi: Selalu berikan nilai default dalam aplikasi yang aman di app bundle Anda (misalnya, tetapkan minimum_version ke rilis aplikasi awal Anda, seperti "1.0.0"). Konfigurasi penggantian ini memastikan aplikasi Anda terus beroperasi secara normal jika perangkat offline atau permintaan pengambilan awal gagal. Untuk panduan khusus platform, lihat Mendownload default template Remote Config.
  2. Ambil dan aktifkan Remote Config: Ambil dan aktifkan nilai template terbaru saat aplikasi Anda dimulai.

  3. Membandingkan versi: Ambil string minimum_version dan latest_version yang aktif, lalu bandingkan dengan versi aplikasi terinstal saat ini.

  4. Ambil tindakan berdasarkan perbandingan versi:

    • Terapkan update wajib: Jika current_version lebih awal dari minimum_version, tampilkan pemberitahuan modal layar penuh yang tidak dapat ditutup. Menonaktifkan navigasi ke bagian aplikasi lainnya dan menyediakan tombol yang membuka update_url di app store platform.
    • Minta update opsional: Jika current_version lebih awal dari latest_version, tampilkan dialog atau notifikasi yang dapat ditutup untuk memberi tahu pengguna bahwa update tersedia, dengan opsi Update sekarang atau Nanti.
    • Izinkan akses: Jika tidak, izinkan pengguna untuk melanjutkan ke aplikasi.

Praktik terbaik

  • Menambahkan pemroses real-time: Jika update versi diperlukan karena masalah keamanan atau penurunan UX yang serius, menambahkan pemroses Remote Config real-time ke aplikasi Anda dapat membantu memastikan perubahan persyaratan versi diterapkan segera di perangkat aktif tanpa menunggu pengambilan terjadwal berikutnya atau mulai ulang aplikasi.
  • Uji dengan grup pengujian terbatas: Sebelum menaikkan minimum_version untuk semua pengguna produksi, uji kondisi dengan grup pengujian terbatas atau targetkan penguji internal menggunakan properti pengguna kustom. Pengujian ini memverifikasi bahwa modal pemblokiran ditampilkan dengan benar dan link toko diselesaikan dengan benar.
  • Gunakan API update dalam aplikasi platform: Di Android, pertimbangkan untuk mengintegrasikan Update Dalam Aplikasi Google Play bersama dengan pemeriksaan Remote Config Anda untuk memungkinkan pengguna mendownload dan menginstal update tanpa keluar dari aplikasi Anda.
  • Baca checklist produksi: Baca checklist peluncuran Firebase dan checklist produksi AI Logic untuk mendapatkan panduan lebih lanjut tentang cara menyiapkan aplikasi dan fitur AI untuk produksi.