Update Wajib (Hard Update)
Panduan mewajibkan pengguna untuk memperbarui aplikasi ke versi terbaru sebelum dapat melanjutkan penggunaan.
Fitur Update Wajib memungkinkan Anda memaksa seluruh pengguna aplikasi untuk memperbarui ke versi terbaru sebelum dapat melanjutkan penggunaan aplikasi — berguna saat Anda merilis perbaikan penting (misalnya perubahan format API, perbaikan keamanan, atau versi yang sudah tidak didukung sama sekali).
Kapan Sebaiknya Digunakan
Gunakan fitur ini secara hati-hati. Setelah aktif, pengguna dengan versi aplikasi di bawah versi minimum tidak dapat mengakses aplikasi sama sekali sampai mereka memperbarui — layar pembaruan akan memblokir seluruh layar aplikasi lainnya, termasuk saat pengguna menekan tombol kembali.
Cara Kerja
Setiap kali aplikasi dibuka, layar splash akan memeriksa versi aplikasi yang terpasang di perangkat pengguna dan membandingkannya dengan versi minimum yang Anda tentukan. Jika versi aplikasi pengguna lebih rendah dari versi minimum, layar "Update Diperlukan" akan langsung ditampilkan dan memblokir akses ke seluruh fitur aplikasi lainnya.
Pengecekan ini tidak hanya berjalan saat aplikasi pertama dibuka (cold start), tapi juga saat pengaturan halaman utama diperbarui selagi pengguna masih menggunakan aplikasi (misalnya saat menarik untuk refresh). Menekan notifikasi push juga akan melewati layar splash terlebih dahulu, sehingga status Update Wajib tetap diperiksa lebih dulu sebelum pengguna diarahkan ke tujuan notifikasi tersebut — pengguna tidak bisa "melewati" pembaruan wajib lewat notifikasi.
Mengaktifkan Update Wajib (Admin)
Pengaturan Update Wajib dikendalikan melalui tiga nilai pada pengaturan tema/API engine Anda:
| Pengaturan | Keterangan |
|---|---|
| Jenis Update | Menentukan jenis pembaruan yang dipaksa: custom_paksa (paksa update melalui tautan APK/link kustom Anda sendiri) atau playstore_paksa (paksa update melalui Google Play Store). |
| Versi Update | Versi minimum aplikasi yang wajib dimiliki pengguna agar bisa melanjutkan. |
| Link Update | Tautan unduhan yang dibuka saat pengguna menekan tombol update (dipakai untuk custom_paksa, dan sebagai fallback bila Play Core In-App Update tidak tersedia untuk playstore_paksa). |
Menghubungi Dukungan Teknis
Pengaturan ini saat ini tidak tersedia sebagai checkbox pada aplikasi Konfigurasi Engine (Tkinter) — nilai-nilai ini diatur melalui API pengaturan engine. Hubungi dukungan teknis 23 Loop untuk bantuan mengatur nilai-nilai ini pada instalasi Anda.
Pengalaman Pengguna
Pengguna melihat layar "Update Diperlukan" dengan pesan "Versi aplikasi Anda sudah tidak didukung. Silahkan update untuk melanjutkan." dan tombol "Update Sekarang".
Menekan tombol ini akan memulai proses Update Langsung (In-App Update) dari Google Play Store. Jika mekanisme Play Store tidak tersedia (misalnya aplikasi tidak diinstal dari Play Store), aplikasi akan membuka Link Update di browser sebagai cadangan.
Pengguna melihat layar "Update Diperlukan" yang sama, namun menekan "Update Sekarang" akan langsung membuka Link Update yang Anda tentukan (misalnya tautan unduhan APK di server/website Anda sendiri) melalui browser perangkat.
Selama layar ini tampil:
- Tombol kembali (back) tidak akan menutup layar pembaruan — aplikasi hanya dikirim ke background.
- Layar-layar lain di aplikasi (termasuk detail transaksi) akan ikut mengarahkan pengguna kembali ke layar Update Wajib apabila status update wajib masih aktif.
Jika Tidak Ada Browser
Jika perangkat pengguna tidak memiliki aplikasi browser, akan muncul pesan "Tidak menemukan browser untuk membuka link update".