Les widgets d'application peuvent être configurables. Par exemple, un widget d'horloge peut permettre aux utilisateurs de configurer le fuseau horaire à afficher.
Si vous souhaitez permettre aux utilisateurs de configurer les paramètres de votre widget, créez une Activity de configuration du widget.
Déclarer l'activité de configuration
La déclaration de l'activité de configuration dans le fichier manifeste et l'association de celle-ci dans les métadonnées XML de votre fournisseur sont identiques pour les widgets d'application basés sur les vues et ceux basés sur Glance.
Pour savoir comment déclarer l'activité de configuration, consultez la section Déclarer l'activité de configuration dans la documentation sur la configuration de Glance.
Implémenter l'activité de configuration
Étant donné que les activités de configuration sont des composants standards appelés par le lanceur de la plate-forme, leurs rappels de cycle de vie de base doivent suivre les règles de valeur de retour du système.
Pour savoir comment implémenter une activité de configuration, consultez la section Implémenter l'activité de configuration de la documentation Glance.
Mettre à jour le widget à partir de l'activité de configuration
Dans les widgets traditionnels basés sur les vues, vous mettez à jour le widget une fois la configuration terminée à l'aide de AppWidgetManager et d'une instance de mise en page RemoteViews.
Si vous créez un ancien widget basé sur les vues et que vous devez mettre à jour la mise en page RemoteViews, consultez l'exemple de code de mise à jour des vues traditionnel sur GitHub. Pour les widgets modernes axés sur Compose, consultez la section Mettre à jour à partir de l'activité de configuration de la documentation Glance.
Options de configuration du widget
Les comportements des widgets (par exemple, autoriser une reconfiguration ultérieure ou ignorer complètement les étapes de configuration initiale) sont enregistrés dans les attributs de métadonnées à l'aide des indicateurs standards d'Android 12.
Pour savoir comment exploiter les options de widget dynamiques, consultez la section Options de configuration des widgets dans la documentation de configuration de Glance.
Permettre aux utilisateurs de reconfigurer les widgets placés
Pour savoir comment ajouter des déclencheurs de configuration reconfigurables personnalisés, consultez la section Permettre aux utilisateurs de reconfigurer les widgets placés de la documentation Glance.
Utiliser la configuration par défaut du widget
Pour savoir comment ignorer les configurations par défaut, consultez la section Utiliser la configuration par défaut du widget dans la documentation de Glance.