Améliorations des widgets Android 12

Android 12 (niveau d'API 31) remanie l'API Widgets existante pour améliorer l'expérience utilisateur et développeur dans la plate-forme et les lanceurs d'applications. Utilisez ce guide pour découvrir comment vous assurer que votre widget est compatible avec Android 12. Il vous servira également de référence pour les API permettant d'actualiser votre widget existant.

Assurez-vous que votre widget est compatible avec Android 12

Les widgets d'Android 12 ont des coins arrondis. Lorsqu'un widget d'application est utilisé sur un appareil équipé d'Android 12 ou version ultérieure, le lanceur d'applications identifie automatiquement l'arrière-plan du widget et le recadre pour qu'il ait des angles arrondis.

Dans ce scénario, il est possible que votre widget ne s'affiche pas correctement dans l'une des conditions suivantes :

• Le widget contient du contenu dans les coins : cela peut entraîner le recadrage de certains contenus dans la zone des coins.

• Le widget utilise un arrière-plan qui ne peut pas être recadré. Cela inclut un arrière-plan transparent, des vues ou des mises en page vides, ou tout autre type d'arrière-plan spécial qui ne peut pas être recadré. Il est possible que le système ne puisse pas identifier correctement l'arrière-plan à utiliser.

Si votre widget est concerné par ce changement, nous vous recommandons de le mettre à jour avec des angles arrondis (comme décrit dans la section suivante) pour qu'il s'affiche correctement.

Attention : Les dimensions des angles arrondis peuvent varier d'un appareil à l'autre, car la taille du rayon d'angle peut être contrôlée à la fois par les fabricants d'appareils (jusqu'à 16 dp) et par les lanceurs d'applications tiers. Nous vous recommandons d'actualiser le widget pour éviter d'obtenir des résultats insatisfaisants.

Utiliser l'échantillon

Pour voir toutes ces API en action, consultez notre widget de liste d'exemples.

Implémenter des coins arrondis

Remarque : Ces conseils peuvent être obsolètes. Pour obtenir les dernières consignes, consultez Implémenter des angles arrondis.

Android 12 introduit les paramètres système system_app_widget_background_radius et system_app_widget_inner_radius pour définir les rayons des angles arrondis de votre widget.

Figure 1  : Coins arrondis sur un widget et une vue à l'intérieur du widget

1 Angle du widget.

2 : angle d'une vue à l'intérieur du widget.

Pour en savoir plus, consultez Implémenter des angles arrondis.

Ajouter un thème d'appareil

À partir d'Android 12, un widget peut utiliser les couleurs du thème de l'appareil pour les boutons, les arrière-plans et d'autres composants, y compris les thèmes clairs et sombres. Cela permet des transitions plus fluides et une cohérence entre les différents widgets.

Pour en savoir plus, consultez Ajouter un thème à l'appareil.

Figure 2 : widget avec le thème clair

Figure 3 : widget avec le thème sombre

Faciliter la personnalisation des widgets

Si vous spécifiez une activité de configuration avec l'attribut configure de appwidget-provider, l'hôte du widget d'application lance cette activité immédiatement après qu'un utilisateur a ajouté le widget à son écran d'accueil.

Android 12 ajoute de nouvelles options pour vous permettre d'offrir une meilleure expérience de configuration aux utilisateurs. Pour en savoir plus, consultez Autoriser les utilisateurs à configurer des widgets.

Ajouter des boutons composés

Android 12 ajoute une nouvelle compatibilité avec le comportement avec état à l'aide des composants existants suivants :

• CheckBox

• Switch

• RadioButton

Le widget est toujours sans état. Votre application doit stocker l'état et s'inscrire aux événements de changement d'état.

Figure 4  : Exemple de widget avec des cases à cocher

Pour en savoir plus, consultez Prise en charge du comportement avec état.

Utiliser des API améliorées pour les tailles et les mises en page des widgets

À partir d'Android 12, vous pouvez profiter d'attributs de taille plus précis et de mises en page plus flexibles en spécifiant des contraintes de dimensionnement de widget supplémentaires et en fournissant des mises en page responsives et exactes.

Pour en savoir plus, consultez Fournir des mises en page de widget flexibles.

Améliorer l'expérience du sélecteur de widgets de votre application

Android 12 vous permet d'améliorer l'expérience du sélecteur de widgets pour votre application en ajoutant des aperçus et des descriptions de widgets dynamiques. Pour en savoir plus, consultez Ajouter des aperçus de widgets évolutifs au sélecteur de widgets et Ajouter une description à votre widget.

Activer des transitions plus fluides

À partir d'Android 12, les lanceurs d'applications offrent une transition plus fluide lorsqu'un utilisateur lance votre application depuis un widget. Pour en savoir plus, consultez Activer des transitions plus fluides.

Utiliser des collections RemoteViews simplifiées

Android 12 ajoute la méthode setRemoteAdapter(int viewId, RemoteViews.RemoteCollectionItems items), qui permet à votre application de transmettre directement une collection lors du remplissage d'un ListView. Auparavant, lorsque vous utilisiez un ListView, il était nécessaire d'implémenter et de déclarer un RemoteViewsService pour renvoyer RemoteViewsFactory.

Pour en savoir plus, consultez Utiliser les collections RemoteViews.

Utiliser la modification du temps d'exécution de RemoteViews

Android 12 ajoute plusieurs méthodes RemoteViews qui permettent la modification au moment de l'exécution des attributs RemoteViews. Consultez la documentation de référence de l'API RemoteViews pour obtenir la liste complète des méthodes ajoutées.

Pour en savoir plus, consultez Utiliser la modification au moment de l'exécution de RemoteViews.