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.
Dichiarare l'attività di configurazione
La dichiarazione dell'attività di configurazione nel manifest e il collegamento all'interno dei metadati XML del provider sono identici nei widget delle app basati su Views e su Glance.
Per scoprire come dichiarare l'attività di configurazione, consulta la sezione Dichiarare l'attività di configurazione nella documentazione sulla configurazione di Glance.
Implementa l'attività di configurazione
Poiché le attività di configurazione sono componenti standard chiamati dal launcher della piattaforma, i loro callback del ciclo di vita di base devono seguire le regole del valore restituito del sistema.
Per scoprire come implementare un'attività di configurazione, consulta la sezione Implementare l'attività di configurazione nella documentazione di Glance.
Aggiorna il widget dall'attività di configurazione
Nei widget tradizionali basati sulle 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 RemoteViews, fai riferimento al codice campione tradizionale per l'aggiornamento di Views su GitHub. Per i widget moderni basati su Compose, consulta la sezione Aggiornamento dalla sezione dell'attività di configurazione nella documentazione di Glance.
Opzioni di configurazione del widget
I comportamenti dei widget (ad esempio la possibilità di riconfigurare in un secondo momento o di saltare del tutto 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 in Compose nella documentazione di configurazione di Glance.
Consenti agli utenti di riconfigurare i widget posizionati
Per capire come aggiungere trigger di configurazione personalizzati e riconfigurabili, consulta la sezione Consenti agli utenti di riconfigurare i widget posizionati nella documentazione di Glance.
Utilizza la configurazione predefinita del widget
Per scoprire come ignorare le configurazioni per impostazione predefinita, consulta la sezione Utilizzare la configurazione predefinita del widget nella documentazione di Glance.