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
26 août 2026 - - - 1.0.0-alpha17

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-alpha13"

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

Kotlin

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

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

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-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> d'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 these commits.

Nouvelles fonctionnalités

  • Ajout d'une 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 Remote Compose CORE_TEXT pour le profil des widgets Wear. Cela permet à RemoteText d'utiliser des fonctionnalités de police variables, telles que les axes de police, les hauteurs de ligne, etc., sur les moteurs de rendu hôtes compatibles, avec un repli automatique lorsqu'il n'est pas compatible.

Corrections

  • Mise à jour des KDocs pour l'annotation AssociateWithGlanceWearWidget en fonction des 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 these commits.

Nouvelles fonctionnalités

  • Ajout d'un avertissement lint lors de la définition d'un arrière-plan vide pour le document du widget Wear. (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 these commits.

Modifications apportées à l'API

  • Ajout de 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

  • Configuration et ajout de 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)
  • Amélioration de la rétrocompatibilité pour les widgets exécutés sur des hôtes plus anciens en propageant les opérations compatibles via WearWidgetParams et en ajoutant un 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 these commits.

Modifications apportées à l'API

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

Corrections de bugs

  • Ajustement des 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 le 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()
 }
 ```

  • Ajout du pinceau image à WearWidgetBrush pour prendre en charge les arrière-plans bitmap dans les widgets Wear. (I9a228, b/513481558)

  • Introduction d'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)
  • Exposition des opérateurs de comparaison RemoteInt. (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)
  • Ajout de @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

  • Ajout de WearWidgetPreview pour prévisualiser les widgets Wear dans Android Studio. (I36504, b/485147770)
  • Exposition des 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 donnée. (I6ab20, b/510896410)

Correction de bugs

  • Incluez les informations de version du moteur de rendu dans WearWidgetParams en tant que champ interne pour éviter les problèmes 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

  • Exposition des API glance.wear.health.DataType dans le widget Wear. Les développeurs peuvent utiliser ces API 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'un axe de police vide 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 androidx.glance.wear:wear-core:1.0.0-alpha09. Liste des commits de la version 1.0.0-alpha09

Modifications apportées à l'API

  • Ajout d'ExperimentalGlanceWearApi qui sera utilisé pour les fonctionnalités expérimentales de Glance Wear. (Id2f76, b/498179813)

Correction de bugs

  • Mise à jour de l'analyseur pour les métadonnées XML du widget Wear afin de tenir compte des widgets au démarrage.

Version 1.0.0-alpha08

22 avril 2026

Publication d'androidx.glance.wear:wear:1.0.0-alpha08 et 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 "Mise à jour de compileSdk Compose vers la version 37" (I6007), qui s'applique également à glance-wear. Par conséquent, l'exigence compileSdk n'est plus 37 dans cette version.

Version 1.0.0-alpha07

8 avril 2026

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

Nouvelles fonctionnalités

  • Ajout d'un arrière-plan par défaut pour le widget Wear 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 du widget pour prendre WidgetInstanceId et ajout d'une aide 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)
  • Ajout d'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 androidx.glance.wear:wear-core:1.0.0-alpha06. Liste des commits de la version 1.0.0-alpha06

Nouvelles fonctionnalités

  • Définition des opérations pour le profil des widgets Wear en ligne.

Modifications apportées à l'API

  • Changement de nom : CONTAINER_TYPE_FULLSCREEN devient CONTAINER_TYPE_TILE_COMPAT pour mieux différencier le widget de compatibilité plein écran. Cela inclut le rétablissement du mappage du type FULLSCREEN précédent vers 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 androidx.glance.wear:wear-core:1.0.0-alpha05. Liste des commits de la version 1.0.0-alpha05.

Modifications apportées à l'API

  • Ajout de l'API WearWidgetBrush avec la méthode color à utiliser pour l'arrière-plan du widget Wear. (I66f54, b/464273091)
  • Suppression de la méthode fetchActiveWidgetsForProvider, 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 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 cartes actifs. (I5be95)
  • Déplacement des API de la bibliothèque glance:wear:wear-core vers le package androidx.glance.wear.core. (I429cf)

Correction de bugs

  • Exposition des types courants Remote Composable et Modifier (Id1d40)

Version 1.0.0-alpha03

11 février 2026

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

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 androidx.glance.wear:wear-core:1.0.0-alpha02. Liste des commits de la version 1.0.0-alpha02 these commits.

Nouvelles fonctionnalités

  • Remappage de FULLSCREEN vers 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 androidx.glance.wear:wear-core:1.0.0-alpha01. Liste des commits de la version 1.0.0-alpha01 these commits.

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