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 configuration de widget
Activity.
Déclarer l'activité de configuration
La déclaration de l'activité de configuration dans le fichier manifeste et sa liaison dans les métadonnées XML de votre fournisseur sont identiques pour les widgets d'application basés sur Views et sur Glance.
Pour savoir comment déclarer l'activité de configuration, consultez la section Déclarer l'activité de configuration (Compose en premier) de 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 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 (Compose en premier) de la documentation Glance.
Mettre à jour le widget à partir de l'activité de configuration
Dans les widgets traditionnels basés sur Views, 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 widget hérité basé sur Views et que vous devez mettre à jour la mise en page RemoteViews, consultez l'exemple de code de mise à jour Views traditionnel sur GitHub. Pour les widgets modernes Compose en premier, consultez la section Mettre à jour à partir de l' activité de configuration de la documentation Glance.
Options de configuration des widgets
Les comportements des widgets (par exemple, autoriser une reconfiguration ultérieure ou ignorer complètement les étapes de configuration initiale) sont enregistrés dans des attributs de métadonnées à l'aide des indicateurs Android 12 standards.
Pour savoir comment exploiter les options de widget dynamiques, consultez la section Options de configuration des widgets (Compose en premier) de la documentation sur la configuration de Glance.
Permettre aux utilisateurs de reconfigurer les widgets placés
Pour savoir comment ajouter des déclencheurs de configuration personnalisés reconfigurables, consultez la section Permettre aux utilisateurs de reconfigurer les widgets placés (Compose en premier) 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 (Compose en premier) de la documentation Glance.