Widget aplikasi dapat dikonfigurasi. Misalnya, widget jam dapat memungkinkan pengguna mengonfigurasi zona waktu yang akan ditampilkan.
Jika Anda ingin mengizinkan pengguna mengonfigurasi setelan widget, buat widget
konfigurasi Activity.
Mendeklarasikan aktivitas konfigurasi
Mendeklarasikan aktivitas konfigurasi dalam manifes dan menautkannya di dalam metadata XML penyedia Anda sama di seluruh widget aplikasi berbasis View dan berbasis Glance.
Untuk mempelajari cara mendeklarasikan aktivitas konfigurasi, lihat bagian Compose-first Mendeklarasikan aktivitas konfigurasi dalam dokumentasi konfigurasi Glance.
Mengimplementasikan aktivitas konfigurasi
Karena aktivitas konfigurasi adalah komponen standar yang dipanggil oleh peluncur platform, callback siklus proses dasarnya harus mengikuti aturan nilai yang ditampilkan sistem.
Untuk mempelajari cara mengimplementasikan aktivitas konfigurasi, lihat bagian Compose-first Mengimplementasikan aktivitas konfigurasi dalam dokumentasi Glance.
Mengupdate widget dari aktivitas konfigurasi
Di widget berbasis View tradisional, Anda mengupdate widget setelah konfigurasi selesai menggunakan AppWidgetManager dan instance tata letak RemoteViews.
Jika Anda membuat widget berbasis View lama dan perlu mengupdate tata letak RemoteViews, lihat kode contoh Update View tradisional di GitHub. Untuk widget Compose-first modern, lihat bagian Update dari aktivitas konfigurasi dalam dokumentasi Glance.
Opsi konfigurasi widget
Perilaku widget (seperti mengizinkan konfigurasi ulang nanti atau melewati langkah-langkah penyiapan konfigurasi awal sepenuhnya) didaftarkan di dalam atribut metadata menggunakan flag Android 12 standar.
Untuk mempelajari cara memanfaatkan opsi widget dinamis, lihat bagian Compose-first Widget opsi konfigurasi dalam dokumentasi konfigurasi Glance.
Mengaktifkan pengguna untuk mengonfigurasi ulang widget yang ditempatkan
Untuk memahami cara menambahkan pemicu penyiapan yang dapat dikonfigurasi ulang kustom, lihat bagian Compose-first Mengaktifkan pengguna untuk mengonfigurasi ulang widget yang ditempatkan dalam dokumentasi Glance.
Menggunakan konfigurasi default widget
Untuk mempelajari cara melewati penyiapan konfigurasi secara default, lihat bagian Compose-first Menggunakan konfigurasi default widget dalam dokumentasi Glance.