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 seluruh 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.
Menerapkan 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 bagian aktivitas konfigurasi di dokumentasi Glance.
Memperbarui widget dari aktivitas konfigurasi
Pada widget berbasis View tradisional, Anda memperbarui widget setelah konfigurasi
selesai menggunakan AppWidgetManager dan instance tata letak RemoteViews.
Jika Anda membuat widget berbasis View lama dan perlu memperbarui tata letak RemoteViews, lihat kode contoh Pembaruan 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 tanda Android 12 standar.
Untuk mempelajari cara memanfaatkan opsi widget dinamis, lihat bagian Opsi konfigurasi widget yang mengutamakan Compose 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 Mengizinkan pengguna mengonfigurasi ulang widget yang ditempatkan di dokumentasi Glance.
Menggunakan konfigurasi default widget
Untuk mempelajari cara melewati penyiapan konfigurasi secara default, lihat Gunakan bagian konfigurasi default widget di dokumentasi Glance.