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 konfigurasi
widget Activity.
Mendeklarasikan aktivitas konfigurasi
Mendeklarasikan aktivitas konfigurasi dalam manifes dan menautkannya di dalam metadata XML penyedia Anda sama di widget aplikasi berbasis View dan berbasis Glance.
Untuk mempelajari cara mendeklarasikan aktivitas konfigurasi, lihat bagian Mendeklarasikan aktivitas konfigurasi yang mengutamakan Compose 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 menerapkan aktivitas konfigurasi, lihat bagian Menerapkan aktivitas konfigurasi yang mengutamakan Compose dalam dokumentasi Glance.
Mengupdate widget dari aktivitas konfigurasi
Dalam 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 modern yang mengutamakan Compose, 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 sama sekali) didaftarkan di dalam atribut metadata menggunakan flag Android 12 standar.
Untuk mempelajari cara memanfaatkan opsi widget dinamis, lihat bagian Opsi konfigurasi widget Compose-first dalam dokumentasi konfigurasi Glance.
Mengaktifkan pengguna untuk mengonfigurasi ulang widget yang ditempatkan
Untuk memahami cara menambahkan pemicu penyiapan kustom yang dapat dikonfigurasi ulang, lihat bagian Memungkinkan pengguna mengonfigurasi ulang widget yang ditempatkan yang mengutamakan Compose dalam dokumentasi Glance.
Menggunakan konfigurasi default widget
Untuk mempelajari cara melewati penyiapan konfigurasi secara default, lihat bagian Menggunakan konfigurasi default widget yang mengutamakan Compose dalam dokumentasi Glance.