Glance Wear

  
Glance Wear est une bibliothèque permettant de créer des widgets pour Wear OS.
Dernière mise à jour Version stable Version finale Version bêta Version alpha
23 septembre 2026 - - - 1.0.0-alpha19

Déclarer des dépendances

Pour ajouter une dépendance à glance-wear, vous devez ajouter le dépôt Maven de Google à votre projet. Pour en savoir plus, consultez la section Dépôt Maven de Google.

Ajoutez les dépendances correspondant aux artefacts dont vous avez besoin dans le fichier build.gradle de votre application ou de votre module :

Groovy

dependencies {
    implementation "androidx.glance.wear:wear:1.0.0-alpha19"

    implementation "androidx.glance.wear:wear-core:1.0.0-alpha19"
}

Kotlin

dependencies {
    implementation("androidx.glance.wear:wear:1.0.0-alpha19")

    implementation("androidx.glance.wear:wear-core:1.0.0-alpha19")
}

Pour en savoir plus sur les dépendances, consultez Ajouter des dépendances de compilation.

Commentaires

Vos commentaires nous aident à améliorer Jetpack. N'hésitez pas à nous contacter si vous découvrez de nouveaux problèmes ou si vous avez des idées pour améliorer cette bibliothèque. Veuillez consulter les problèmes existants de cette bibliothèque avant d'en signaler un nouveau. Vous pouvez ajouter votre vote à un problème existant en cliquant sur le bouton en forme d'étoile.

Signaler un nouveau problème

Pour en savoir plus, consultez la documentation sur l'outil Issue Tracker.

Glance Wear version 1.0

Version 1.0.0-alpha19

23 septembre 2026

Publication d'androidx.glance.wear:wear:1.0.0-alpha19, androidx.glance.wear:wear-core:1.0.0-alpha19 et androidx.glance.wear:wear-tooling-preview:1.0.0-alpha19. Liste des commits de la version 1.0.0-alpha19

Modifications de test interne uniquement.

Version 1.0.0-alpha18

9 septembre 2026

Publication d'androidx.glance.wear:wear:1.0.0-alpha18, androidx.glance.wear:wear-core:1.0.0-alpha18 et androidx.glance.wear:wear-tooling-preview:1.0.0-alpha18. Liste des commits de la version 1.0.0-alpha18

Modifications apportées à l'API

  • Ajout du paramètre useSafeFallbackRendererVersion à WearWidgetPreview pour permettre la prévisualisation des widgets avec un ensemble de secours sécurisé d'opérations compatibles pour les anciens hôtes. (I9c324)

Correction de bugs

  • compileSdk pour les bibliothèques Compose mises à jour vers la version 37.1. Cela nécessitera la mise à jour transitive de compileSdk pour toutes les applications et bibliothèques utilisant Compose. (I05b0f)
  • Ajout d'une vérification lint pour avertir des utilisations redondantes du paramètre fontFamily dans les widgets Wear. (I7730c)

Version 1.0.0-alpha17

26 août 2026

Publication d'androidx.glance.wear:wear:1.0.0-alpha17, androidx.glance.wear:wear-core:1.0.0-alpha17 et androidx.glance.wear:wear-tooling-preview:1.0.0-alpha17. Liste des commits de la version 1.0.0-alpha17

Nouvelles fonctionnalités

  • Ajout de vérifications Lint dans Glance Wear pour s'assurer que chaque <container> dans un fichier XML <wearwidget-provider> pour les métadonnées de widget spécifie explicitement un attribut de type compatible et ne définit pas de types en double. (I52c9a, b/464458215)

Version 1.0.0-alpha16

12 août 2026

Publication d'androidx.glance.wear:wear:1.0.0-alpha16, androidx.glance.wear:wear-core:1.0.0-alpha16 et androidx.glance.wear:wear-tooling-preview:1.0.0-alpha16. Liste des commits de la version 1.0.0-alpha16

Nouvelles fonctionnalités

  • Ajout de la validation Lint pour les métadonnées XML <wearwidget-provider> afin de s'assurer que les éléments de configuration requis (tels que container et previewImage) sont présents. (Ia9983, b/464458215)
  • Ajout d'un avertissement d'erreur Lint pour la définition d'un arrière-plan noir ou transparent pour un widget Wear (Idedb0, b/529269573)
  • Activation de l'opération CORE_TEXT Remote Compose pour le profil Wear Widgets. Cela permet à RemoteText d'utiliser des fonctionnalités de police variable, telles que les axes de police, les hauteurs de ligne, etc., sur les moteurs de rendu hôtes compatibles, avec un retour automatique en cas d'incompatibilité.

Corrections

  • Mise à jour de la documentation KDocs pour l'annotation AssociateWithGlanceWearWidget suite aux commentaires des développeurs

Version 1.0.0-alpha15

29 juillet 2026

Publication d'androidx.glance.wear:wear:1.0.0-alpha15, androidx.glance.wear:wear-core:1.0.0-alpha15 et androidx.glance.wear:wear-tooling-preview:1.0.0-alpha15. Liste des commits de la version 1.0.0-alpha15

Nouvelles fonctionnalités

  • Ajout d'un avertissement Lint lors de la définition d'un arrière-plan vide pour le document Wear Widget. (Ic6475, b/529269573)

Version 1.0.0-alpha14

15 juillet 2026

Publication d'androidx.glance.wear:wear:1.0.0-alpha14, androidx.glance.wear:wear-core:1.0.0-alpha14 et androidx.glance.wear:wear-tooling-preview:1.0.0-alpha14. Liste des commits de la version 1.0.0-alpha14

Modifications apportées à l'API

  • Nous avons ajouté des fournisseurs de paramètres d'aperçu RoundAllWidgetPreviewParams, RoundSmallWidgetPreviewParams et RoundLargeWidgetPreviewParams pour les widgets Glance Wear entièrement arrondis. (If5336, b/512405233)

Nouvelles fonctionnalités

  • Nous avons configuré et ajouté la bibliothèque Linter pour les widgets Glance Wear.(If4218, b/527402079)
    • Ajout d'une vérification lint pour s'assurer que les sous-classes de GlanceWearWidgetService déclarent explicitement leur classe de widget associée à l'aide de l'annotation @AssociateWithGlanceWearWidget. (Idc575, b/477024153)
  • Nous avons amélioré la rétrocompatibilité des widgets s'exécutant sur des hôtes plus anciens en propageant les opérations compatibles via WearWidgetParams et en ajoutant le filtrage du profil des opérations autorisées à celles-ci. (Ib0a1b, I83cb1, [b/526716195])

Version 1.0.0-alpha13

1er juillet 2026

Publication d'androidx.glance.wear:wear:1.0.0-alpha13, androidx.glance.wear:wear-core:1.0.0-alpha13 et androidx.glance.wear:wear-tooling-preview:1.0.0-alpha13. Liste des commits de la version 1.0.0-alpha13

Modifications apportées à l'API

  • Suppression de la vérification des autorisations de heartRateAccuracy (I14269, b/522444636)

Corrections de bugs

  • Nous avons modifié les paramètres du widget Wear de forme squircle pour l'aperçu, en fonction des commentaires sur l'expérience utilisateur.

Version 1.0.0-alpha12

17 juin 2026

Publication d'androidx.glance.wear:wear:1.0.0-alpha12, androidx.glance.wear:wear-core:1.0.0-alpha12 et androidx.glance.wear:wear-tooling-preview:1.0.0-alpha12. Liste des commits de la version 1.0.0-alpha12

Nouvelles fonctionnalités

  • Ajout de AssociateWithGlanceWearWidget qui doit être utilisé sur GlanceWearWidgetService pour indiquer à quelle implémentation de GlanceWearWidget il est associé. (Ifcabb, b/514679763)

    • Exemple :
     @AssociateWithGlanceWearWidget(MyGlanceWearWidget::class)
 class MyGlanceWearWidgetService : GlanceWearWidgetService() {
   override val widget = MyGlanceWearWidget()
 }
 ```

  • Nous avons ajouté le pinceau image à WearWidgetBrush pour prendre en charge les arrière-plans bitmap dans les widgets Wear. (I9a228, b/513481558)

  • Nous avons introduit une fonction d'assistance @Composable, WearWidgetPreview, pour simplifier le développement des widgets Glance Wear en supprimant le code récurrent requis pour les aperçus IDE.

Modifications apportées à l'API

  • Changement de nom : androidx.glance.wear.health.DataType devient androidx.glance.wear.health.HealthData. (I4cb0b, b/516746689)
  • isHeartRateBpmAvailable est exposé pour déterminer si heartRateBpm est disponible sur l'hôte. (I5999d, b/514641567)
  • Opérateurs de comparaison RemoteInt exposés. (I5fe3d, b/513228889)
  • Exposition de l'API Flow captureRemoteDocument et d'une nouvelle surcharge captureSingleRemoteDocument (qui prend RemoteCreationDisplayInfo) en tant qu'API publiques. (I87b0e, b/513228889)
  • Nous avons ajouté @CallSuper aux méthodes de cycle de vie GlanceWearWidgetService.

Version 1.0.0-alpha11

3 juin 2026

Publication d'androidx.glance.wear:wear:1.0.0-alpha11, androidx.glance.wear:wear-core:1.0.0-alpha11 et androidx.glance.wear:wear-tooling-preview:1.0.0-alpha11. Liste des commits de la version 1.0.0-alpha11

Modifications apportées à l'API

  • Nous avons ajouté WearWidgetPreview pour prévisualiser les Wear Widgets dans Android Studio. (I36504, b/485147770)
  • Exposez les variables is*Available (isDailyStepsAvailable, etc.) pour vérifier si le type de données de santé associé est disponible et valide. (Ib98a7, b/498179656)
  • Ajout de l'API triggerUpdateAll à GlanceWearWidget pour déclencher la mise à jour de tous les widgets de l'application concernée. (I6ab20, b/510896410)

Correction de bugs

  • Incluez les informations sur la version du moteur de rendu dans WearWidgetParams en tant que champ interne pour éviter toute rupture dans le document généré avec la version alpha10. (Idcf8e, b/511263591, b/512830184)
  • Déclenchez le flux de mise à jour forcée en mode débogage ou dans l'émulateur pour les widgets Wear.

Version 1.0.0-alpha10

19 mai 2026

Publication d'androidx.glance.wear:wear:1.0.0-alpha10, androidx.glance.wear:wear-core:1.0.0-alpha10 et androidx.glance.wear:wear-tooling-preview:1.0.0-alpha10. Liste des commits de la version 1.0.0-alpha10

Modifications apportées à l'API

  • Exposez les API glance.wear.health.DataType dans le widget Wear. Ces API peuvent être utilisées par les développeurs pour accéder aux données de santé du système.

Correction de bugs

  • Correction d'une boucle de plantage dans la version alpha09 sur l'émulateur Wear 7 ou les appareils exécutant le moteur de rendu 1.6 en empêchant l'envoi d'axes de police vides au lecteur pour le widget Glance Wear.

Version 1.0.0-alpha09

6 mai 2026

Publication d'androidx.glance.wear:wear:1.0.0-alpha09 et d'androidx.glance.wear:wear-core:1.0.0-alpha09. Liste des commits de la version 1.0.0-alpha09

Modifications apportées à l'API

  • Nous avons ajouté ExperimentalGlanceWearApi, qui sera utilisé pour les fonctionnalités Glance Wear expérimentales. (Id2f76, b/498179813)

Correction de bugs

  • Mise à jour du parseur pour que les métadonnées XML des widgets Wear soient conscientes des widgets au démarrage.

Version 1.0.0-alpha08

22 avril 2026

Publication d'androidx.glance.wear:wear:1.0.0-alpha08 et d'androidx.glance.wear:wear-core:1.0.0-alpha08. Liste des commits de la version 1.0.0-alpha08

Correction de bugs

  • Ajout de la balise <queries> au fichier manifeste de la bibliothèque glance:wear:wear pour s'assurer que PackageManager interroge les services appropriés pour les mises à jour push. (I192787)

Autre

  • Rétablissement de "Updates Compose compileSdk to 37" (I6007), qui s'applique également à glance-wear. L'exigence compileSdk n'est donc plus de 37 dans cette version.

Version 1.0.0-alpha07

8 avril 2026

Publication d'androidx.glance.wear:wear:1.0.0-alpha07 et d'androidx.glance.wear:wear-core:1.0.0-alpha07. Liste des commits de la version 1.0.0-alpha07

Nouvelles fonctionnalités

  • Ajoutez un arrière-plan de widget Wear par défaut lorsque WearWidgetBrush est vide ou non spécifié. (I8300b)
  • Mise à jour de l'API getActiveWidgets pour renvoyer le type de conteneur du widget. (2772eb1)

Modifications apportées à l'API

  • Modification de l'API de mise à jour des widgets pour accepter WidgetInstanceId et ajout d'un utilitaire pour récupérer les ID d'un widget donné. La nouvelle API génère IllegalArgumentException si l'ID fourni n'est pas valide ou n'appartient pas à l'appelant. (I6f3c5, b/446828899)
  • Ajoutez un dégradé vertical et horizontal dans WearWidgetBrush. (If70ae, b/470080675)

Version 1.0.0-alpha06

25 mars 2026

Publication d'androidx.glance.wear:wear:1.0.0-alpha06 et d'androidx.glance.wear:wear-core:1.0.0-alpha06. Liste des commits de la version 1.0.0-alpha06

Nouvelles fonctionnalités

  • Définissez les opérations pour le profil Wear Widgets intégré.

Modifications apportées à l'API

  • Nous avons renommé CONTAINER_TYPE_FULLSCREEN en CONTAINER_TYPE_TILE_COMPAT pour mieux différencier le widget de compatibilité plein écran. Cela inclut le rétablissement du mappage de type FULLSCREEN à LARGE dans les paramètres du widget.

Version 1.0.0-alpha05

11 mars 2026

Publication d'androidx.glance.wear:wear:1.0.0-alpha05 et d'androidx.glance.wear:wear-core:1.0.0-alpha05. Liste des commits de la version 1.0.0-alpha05

Modifications apportées à l'API

  • Nous avons ajouté l'API WearWidgetBrush avec la méthode color à utiliser pour l'arrière-plan du widget Wear. (I66f54, b/464273091)
  • La méthode fetchActiveWidgetsForProvider a été supprimée, car fetchActiveWidgets existe déjà. (I85e4e, b/486197890)

Version 1.0.0-alpha04

25 février 2026

Publication d'androidx.glance.wear:wear:1.0.0-alpha04 et d'androidx.glance.wear:wear-core:1.0.0-alpha04. Liste des commits de la version 1.0.0-alpha04

Modifications apportées à l'API

  • Ajout de l'API GlanceWearWidgetManager pour permettre aux applications d'interroger leurs widgets et vignettes actifs. (I5be95)
  • Nous avons déplacé les API de la bibliothèque glance:wear:wear-core vers le package androidx.glance.wear.core. (I429cf)

Correction de bugs

  • Exposer les types Remote Composable et Modifier courants (Id1d40)

Version 1.0.0-alpha03

11 février 2026

Publication d'androidx.glance.wear:wear:1.0.0-alpha03 et d'androidx.glance.wear:wear-core:1.0.0-alpha03. Liste des commits de la version 1.0.0-alpha03

Modifications apportées à l'API

  • Ajout de la prise en charge des événements d'interaction à GlanceWearWidget. (Ia4e28, b/469808447)

Version 1.0.0-alpha02

28 janvier 2026

Publication d'androidx.glance.wear:wear:1.0.0-alpha02 et d'androidx.glance.wear:wear-core:1.0.0-alpha02. Liste des commits de la version 1.0.0-alpha02

Nouvelles fonctionnalités

  • Remappez FULLSCREEN sur LARGE dans les paramètres du widget (ad78d95).

Correction de bugs

  • Correction de l'utilisation de DataStore qui empêchait l'affichage de plusieurs instances de widget (474f3e4)

Version 1.0.0-alpha01

14 janvier 2026

Publication d'androidx.glance.wear:wear:1.0.0-alpha01 et d'androidx.glance.wear:wear-core:1.0.0-alpha01. Liste des commits de la version 1.0.0-alpha01

  • Glance Wear est une bibliothèque permettant de créer des widgets pour Wear OS à l'aide de RemoteCompose.