I widget delle app possono essere configurabili. Ad esempio, un widget orologio può consentire agli utenti di configurare il fuso orario da visualizzare.
Se vuoi consentire agli utenti di configurare le impostazioni del widget, crea una configurazione del widget Activity.
Dichiara l'attività di configurazione
La dichiarazione dell'attività di configurazione nel manifest e il collegamento all'interno dei metadati XML del provider sono identici sia per i widget delle app basati su Views che per quelli basati su Glance.
Per scoprire come dichiarare l'attività di configurazione, consulta la sezione Dichiara l'attività di configurazione della documentazione sulla configurazione di Glance, incentrata su Compose.
Implementa l'attività di configurazione
Poiché le attività di configurazione sono componenti standard chiamati dal programma di avvio della piattaforma, i relativi callback del ciclo di vita di base devono seguire le regole dei valori restituiti dal sistema.
Per scoprire come implementare un'attività di configurazione, consulta la sezione Implementa l'attività di configurazione incentrata su Compose nella documentazione di Glance.
Aggiorna il widget dall'attività di configurazione
Nei widget tradizionali basati su visualizzazioni, aggiorni il widget al termine della configurazione utilizzando AppWidgetManager e un'istanza di layout RemoteViews.
Se stai creando un widget legacy basato su Views e devi aggiornare il layout di RemoteViews, fai riferimento al codice campione tradizionale di aggiornamento di Views su GitHub. Per i widget moderni basati su Compose, consulta la sezione Aggiorna dall'attività di configurazione nella documentazione di Glance.
Opzioni di configurazione del widget
I comportamenti dei widget (ad esempio, consentire la riconfigurazione in un secondo momento o saltare completamente i passaggi di configurazione iniziale) vengono registrati all'interno degli attributi dei metadati utilizzando i flag standard di Android 12.
Per scoprire come sfruttare le opzioni dei widget dinamici, consulta la sezione Opzioni di configurazione dei widget di Compose-first nella documentazione di configurazione di Glance.
Consenti agli utenti di riconfigurare i widget posizionati
Per capire come aggiungere trigger di configurazione personalizzati riconfigurabili, consulta la sezione Consenti agli utenti di riconfigurare i widget posizionati di Glance, incentrata su Compose, nella documentazione di Glance.
Utilizza la configurazione predefinita del widget
Per scoprire come saltare le configurazioni per impostazione predefinita, consulta la sezione Utilizza la configurazione predefinita del widget di Compose-first nella documentazione di Glance.