Notes de version de Wear OS

Cette page contient des informations sur les versions Wear OS telles que le SDK Wearable et la bibliothèque Wearable Support.

SDK Wearable 18.1.0 du 31 août 2023

La version 18.1.0 du SDK Wearable intègre des mises à jour mineures de l'API pour assurer la compatibilité avec la prochaine version de la bibliothèque Wearable Support. Les mises à jour suivantes ont été réalisées :

  • Prise en charge du changement de téléphone, consultez NodeClient.OnNodeMigratedListener pour plus d'informations.
  • Documentation supplémentaire pour l'envoi et la réception de messages MessageClient.
  • Mise à jour des liens dans les descriptions des API.

SDK Wearable 18.0.0 du 20 septembre 2022

La version 18.0.0 du SDK Wearable intègre des mises à jour mineures de l'API pour assurer la compatibilité avec la prochaine version de la bibliothèque Wearable Support. Les mises à jour suivantes ont été réalisées :

  • Prise en charge de WearableListenerService pour les applications ciblant Android 13 — problème 235538840.
  • Nouvelle méthode MessageClient.sendRequest().

Bibliothèque Wearable Support version 2.9.0 du 16 février 2022

Dans la version 2.9.0 de la bibliothèque Wearable Support, toutes les classes restantes deviennent obsolètes. Utilisez les bibliothèques Wear OS Jetpack à la place.

Bibliothèque Wear OS Jetpack du 29 octobre 2021

Les bibliothèques Wear OS Jetpack remplacent les bibliothèques Wearable Support et ne sont pas conçues pour être utilisées en même temps que ces dernières. La bibliothèque Wearable Support ne fonctionne pas sur Wear OS 3.

SDK Wearable 17.1.0 du 27 avril 2021

La version 17.1.0 du SDK Wearable intègre des mises à jour mineures de l'API pour assurer la compatibilité avec la prochaine version de la bibliothèque Wearable Support.

Bibliothèque Wearable Support version 2.8.1 du 28 septembre 2020

La version 2.8.1 de la bibliothèque Wearable Support intègre le changement suivant.

Permettre la désactivation de Jetifier lors de l'utilisation du modèle de cadran

Le modèle de cadran d'Android Studio utilise désormais les dépendances AndroidX pour permettre la désactivation de Jetifier. Ces correctifs s'appliquent lorsque vous utilisez le modèle de cadran avec Android Studio 4.2 ou version ultérieure.

Bibliothèque Wearable Support version 2.8.0 du 24 septembre 2020

La version 2.8.0 de la bibliothèque Wearable Support intègre les changements suivants.

Fonctionnalité de remplacement permettant de spécifier des fournisseurs de complications non-système par défaut

Les cadrans peuvent désormais utiliser setDefaultComplicationProviderWithFallbacks pour spécifier un ou plusieurs fournisseurs de complications non-système à utiliser par défaut. Si aucun des fournisseurs non-système spécifiés n'est installé, le système bascule sur le fournisseur système par défaut.

Obsolescence de WearableActivity

Abandon de WearableActivity. Utilisez AmbientModeSupport à la place.

Obsolescence de SKIP_CONFIRMATION_UI

Abandon d'ActionConfirmationActivity.SKIP_CONFIRMATION_UI. Cet extra n'est plus utilisé depuis la sortie de Wear 2.0.

Bibliothèque Wearable Support version 2.7.0 du 15 mai 2020

La version 2.7.0 de la bibliothèque Wearable Support intègre la fonctionnalité suivante.

Accélération matérielle pour les cadrans

Vous pouvez désormais demander un canevas avec accélération matérielle lorsque vous utilisez la classe CanvasWatchFaceService. Profitez de l'accélération matérielle pour améliorer les performances du cadran et accéder à davantage de données sur les performances de l'UI.

Pour en savoir plus, voir Améliorer les performances de votre cadran grâce à l'accélération matérielle.

Bibliothèque Wearable Support version 2.6.0 du 21 avril 2020

La version 2.6.0 de la bibliothèque Wearable Support intègre l'amélioration suivante.

Migration vers Android Jetpack

La bibliothèque Wearable Support a migré vers Android Jetpack. Les bibliothèques existantes sont désormais mappées et accessibles dans AndroidX via l'espace de noms androidx. Toutes les dépendances de l'ancienne bibliothèque Support ont été supprimées.

Ce changement vous permet également d'utiliser les bibliothèques Wearable Support dans Android Studio 4.0 et version ultérieure, qui résout les problèmes tels que le problème 147972079.

Bibliothèque Wearable Support version 2.5.0 du 28 août 2019

La version 2.5.0 de la bibliothèque Wearable Support intègre l'amélioration suivante.

Correctif pour ComplicationDrawable lorsque la méthode startActivity() est appelée avec le type de complication TYPE_NO_PERMISSION

ComplicationDrawable inclut désormais un indicateur NEW_TASK qui permet de s'assurer que les appels startActivity() provenant de WatchFaceService contiennent FLAG_ACTIVITY_NEW_TASK pour éviter une exception android.util.AndroidRuntimeException.

Ce changement permet au type de complication TYPE_NO_PERMISSION de lancer correctement l'activité de demande d'autorisation au lieu d'entraîner le plantage du cadran.

SDK Wearable 16.0.0 du 25 septembre 2018

Avec la version 16.0.0 du SDK Wearable, la version minimale requise des services Google Play est abaissée à la version 8.6 au lieu de la version 12.4. Ce changement permet aux applications existantes de passer à la dernière version du SDK Wearable sans exiger la mise à jour de l'APK des services Google Play.

Mise à jour de Wear OS Preview développeur 2 du 11 juin 2018

Une récente mise à jour Over The Air de Wear OS Preview développeur 2 a réactivé les alarmes et les tâches pour les applications d'arrière-plan.

Ce changement de stratégie offre plus de flexibilité pour le développement d'applications, mais les alarmes et les tâches d'arrière-plan restent soumises à d'autres restrictions liées à Android P, y compris celles concernant les buckets de mise en veille des applications. Suivez les bonnes pratiques pour vous assurer que vos applications se comportent correctement, quel que soit le bucket dans lequel elles se trouvent.

Cette mise à jour renforce également la confidentialité des données et des entrées utilisateur en limitant l'accès d'une application d'arrière-plan aux données utilisateur et aux données des capteurs. En fonction des exigences d'une application, vous devrez peut-être utiliser un service de premier plan pour autoriser un accès en continu aux données des capteurs.

Wear OS Preview développeur 2 du 8 mai 2018

Wear OS Preview développeur 2 intègre différentes fonctionnalités dont une expérience améliorée pour l'Assistant Google.

Signalez vos bugs ou envoyez vos commentaires via l'outil Issue Tracker de Wear OS by Google. Plus tôt vous les envoyez, plus les correctifs seront susceptibles d'être inclus dans la version finale.

Problèmes connus

Cette section liste les problèmes connus de la version Preview 2.

Problèmes liés à l'image de Wear OS

  • Lorsque vous utilisez une application et que vous appuyez sur le bouton Marche/Arrêt situé sur le côté de la montre, il peut arriver que vous soyez redirigé vers l'écran précédent plutôt que vers le cadran.

Problèmes liés à l'image de Wear OS pour la Chine

  • Lorsque vous utilisez une application et que vous appuyez sur le bouton Marche/Arrêt situé sur le côté de la montre, il peut arriver que vous soyez redirigé vers l'écran précédent plutôt que vers le cadran.
  • Les paramètres liés au volume du son ne sont pas conservés. Par exemple, un appel entrant déclenche une sonnerie sur la montre, même si le son de cette dernière est désactivé. De même, si vous réglez le volume de l'alarme, la modification n'a aucun effet.
  • En présence de plusieurs notifications en cours, celles-ci peuvent ne pas s'afficher correctement. Par exemple, si un minuteur et un chronomètre sont configurés, les notifications ne s'affichent pas. Nous vous recommandons de tester votre application avec une seule notification en cours.
  • La plate-forme de téléchargement d'applications Wear ne fonctionne pas dans la version chinoise. Les développeurs ne peuvent pas mettre à jour ni installer de nouvelles applications en utilisant ce canal. Nous vous recommandons d'utiliser adb comme solution de contournement pour paracharger votre application pour les tests.

Problèmes liés à l'émulateur Wear

  • Un appel téléphonique entrant vers un téléphone associé ne s'affiche pas, ou n'est pas _dupliqué_, comme appel entrant dans l'émulateur associé.
  • Lorsque vous utilisez SDK Manager pour installer la dernière version d'Android P ou la version destinée à la Chine, ou pour vérifier que vous disposez bien de l'une de ces versions, les cases à cocher situées à côté de ces options peuvent se décocher toutes seules. Dans ce cas, vous devez les cocher une seconde fois.
  • Lorsque l'émulateur effectue un démarrage à froid, le message d'erreur suivant peut s'afficher : "Un problème interne lié à votre appareil est survenu. Veuillez contacter le fabricant pour en savoir plus." Cela n'a pas d'incidence sur le fonctionnement de l'émulateur. Faites défiler l'écran vers le bas, puis cliquez sur OK pour commencer à tester votre application.
  • La réponse vocale peut ne pas fonctionner sur l'émulateur. Par exemple, si vous recevez une notification pour un message Google Hangouts sur l'émulateur Wear et que vous essayez de répondre au message par commande vocale, le message d'erreur "Google s'arrête systématiquement" s'affiche. Vous ne pouvez alors pas répondre par commande vocale.
  • L'exécution instantanée peut être incompatible avec l'émulateur Wear.
  • Il est possible que vous ne puissiez pas faire une capture d'écran par programmation, par exemple via adb ou en générant un rapport de bug. Pour contourner ce problème, vous pouvez faire une capture d'écran en cliquant sur le bouton représentant un appareil photo dans la barre d'outils de l'émulateur.

Problèmes liés à la version de l'émulateur Wear destinée à la Chine

  • Un appel téléphonique entrant vers un téléphone associé peut ne pas s'afficher, ou ne pas être _dupliqué_, comme appel entrant dans l'émulateur associé. Par conséquent, les notifications d'appel manqué peuvent ne pas s'afficher dans l'émulateur. De plus, vous ne serez peut-être pas en mesure de répondre à un appel de l'émulateur, auquel cas, l'appel continue de sonner.
  • Lorsque vous utilisez SDK Manager pour installer la dernière version d'Android P ou la version destinée à la Chine, ou pour vérifier que vous disposez bien de l'une de ces versions, les cases à cocher situées à côté de ces options peuvent se décocher toutes seules. Dans ce cas, vous devez les cocher une seconde fois.
  • Lorsque l'émulateur effectue un démarrage à froid, le message d'erreur suivant peut s'afficher : "Un problème interne lié à votre appareil est survenu. Veuillez contacter le fabricant pour en savoir plus." Cela n'a pas d'incidence sur le fonctionnement de l'émulateur. Faites défiler l'écran vers le bas, puis cliquez sur OK pour commencer à tester votre application.
  • L'exécution instantanée peut être incompatible avec l'émulateur Wear.
  • Il est possible que vous ne puissiez pas faire une capture d'écran par programmation, par exemple via adb ou en générant un rapport de bug. Pour contourner ce problème, vous pouvez faire une capture d'écran en cliquant sur le bouton représentant un appareil photo dans la barre d'outils de l'émulateur.

Assistant Google sur Wear

Grâce à la compatibilité améliorée de l'Assistant sur Wear OS, vous pouvez créer une expérience adaptée aux accessoires connectés sans devoir écrire du code Android. Plus précisément, vous pouvez créer une application pour la plate-forme Actions on Google afin d'aider vos utilisateurs à accomplir des tâches avec vos produits et services.

De plus, Wear OS permet désormais d'accélérer les interactions vocales et tactiles. Les chips de suggestions sont également pris en charge. Voici ce qu'ils permettent de faire :

  • Aider les utilisateurs à terminer rapidement des interactions
  • Donner aux utilisateurs des indices sur le fonctionnement de votre action

Par ailleurs, Wear OS accepte désormais des cartes plus visuelles, ainsi que les listes et les carrousels.

Vous pouvez donc créer des actions Actions on Google pour Wear OS à l'aide de DialogFlow, de modèles ou de SDK Actions. Vous pouvez également profiter des nouveaux modèles de réponse spécialement conçus pour un modèle de montre. Voici quelques-unes des bonnes pratiques concernant Actions on Google :

  • Les dialogues doivent être courts et concis
  • Les retours doivent être à la fois visuels et vocaux

Ces améliorations apportées à l'Assistant sur Wear OS ne dépendent pas d'Android P et sont en cours de déploiement auprès de tous les utilisateurs de Wear 2.0. Pour découvrir les bases de la création d'Actions on Google, consultez la page Intégrer avec l'Assistant Google.

Économies de batterie dans la version Preview développeur 2

Comme décrit dans la section suivante, les fonctionnalités liées à la batterie sont disponibles pour augmenter l'autonomie de la batterie. Les informations figurant dans cette section consacrée à la Preview développeur 2 remplacent celles de la Preview développeur 1 concernant l'alimentation.

Nouveau mode : économiseur de batterie amélioré

Lorsqu'une montre utilise le mode Économiseur de batterie amélioré, un cadran par défaut consommant moins de batterie s'affiche. Tous les éléments suivants sont désactivés :

  • Signaux radio
  • Écran tactile
  • Fonctionnalité Incliner pour activer

Les utilisateurs peuvent consulter l'heure en appuyant brièvement sur le bouton latéral. En appuyant de manière prolongée sur ce bouton, ils peuvent réactiver le mode normal et effectuer différentes tâches, par exemple effectuer un paiement NFC ou répondre à un message. Partez du principe que les applications, cadrans et fournisseurs de données de complication ne sont pas disponibles en mode Économiseur de batterie amélioré.

Activité en arrière-plan limitée

Pour améliorer la gestion de l'alimentation, les applications en arrière-plan ne peuvent plus lancer des alarmes et des tâches si la montre n'est pas sur le chargeur, à l'exception des cadrans et des complications actives.

Remarque : Si votre application doit s'exécuter en permanence, par exemple pour la surveillance en arrière-plan, nous vous recommandons d'utiliser un service de premier plan via la méthode startForegroundService(). Pour en savoir plus, consultez la section Limites applicables aux services d'arrière-plan. L'utilisation d'un service de premier plan reste appropriée dans certains cas exceptionnels (suivi médical, par exemple).

Meilleure compatibilité des applications

Afin d'améliorer la compatibilité des applications, Android P a commencé à implémenter certaines restrictions concernant l'utilisation d'interfaces autres que SDK. Préparez-vous à ne plus utiliser les méthodes et champs autres que SDK. Si aucun équivalent public n'est disponible pour votre cas d'utilisation, veuillez nous en informer.

Thème système d'UI sombre

Depuis début 2018, Wear OS est passé à un thème d'UI par défaut présentant un arrière-plan plus sombre pour le flux de notifications et le lanceur système. Ce changement vise à améliorer la visibilité de vos applications. Vous devez vérifier l'accessibilité de votre application avec ce nouveau thème d'UI.

Des ateliers de programmation mis à jour sont disponibles

Grâce aux ateliers de programmation mis à jour, vous pouvez découvrir des méthodes essentielles de développement avec Wear OS. Par exemple, essayez le nouvel atelier de programmation de cadran en Kotlin pour tester Kotlin DSL (Kotlin domain-specific language).

Wear OS Preview développeur 1 du 27 mars 2018

Cette section contient des informations sur la Preview développeur 1 de Wear OS by Google. Plusieurs mises à jour de cette preview sont prévues avant de publier la version de production finale. Si vous constatez des bugs, veuillez les signaler via l'outil Issue Tracker de Wear OS by Google. Plus tôt vous les envoyez, plus nous serons susceptibles d'inclure les correctifs dans la version finale.

Problèmes connus

  • Dans l'application associée Wear OS, la commande Signaler bug accessoire connecté semble fonctionner, mais elle ne génère en réalité aucun rapport de bug. Utilisez adb bugreport pour contourner ce problème.
  • Il est dans certains cas impossible d'accepter un appel téléphonique sur la montre. Si l'opération échoue, l'utilisateur doit accepter l'appel directement sur le téléphone.
  • Un message d'erreur signalant des problèmes de compatibilité avec l'API s'affiche parfois après qu'une application préchargée a été associée ou lancée. Ce message d'erreur disparaît rapidement et n'a pas d'incidence sur l'usabilité.
  • Dans le menu "Paramètres" de la montre ainsi que dans l'émulateur, l'option Créer un rapport de bug s'affiche deux fois. Pour créer un rapport de bug, essayez chacune des deux options, car une seule fonctionne. Lorsque vous appuyez sur l'option qui fonctionne, une notification toast s'affiche pour indiquer qu'un rapport de bug est en cours de création.
  • Dans la version destinée à la Chine, la saisie vocale provoque le plantage de l'application. C'est par exemple le cas quand l'utilisateur effectue une recherche ou ajoute un rappel par commande vocale, car cette fonctionnalité utilise les API de saisie vocale. Pour vos tests, utilisez le clavier ou l'écriture manuscrite au lieu de la saisie vocale.
  • La plate-forme de téléchargement d'applications Wear ne fonctionne pas dans la version destinée à la Chine. Les développeurs ne peuvent pas mettre à jour ni installer de nouvelles applications en utilisant ce canal. Nous vous recommandons d'utiliser adb comme solution de contournement pour paracharger votre application pour les tests.

Principales caractéristiques de cette Preview développeur

La Preview développeur 1 intègre les fonctionnalités de test d'application suivantes :

  • Activité en arrière-plan limitée. Afin de limiter la consommation de batterie, les applications d'arrière-plan ne sont plus autorisées à utiliser les alarmes et les tâches, à l'exception des cadrans et des complications sélectionnées par l'utilisateur. Cette fonctionnalité sera déployée progressivement dans les versions Preview développeur. Vous ne la verrez donc peut-être pas immédiatement sur votre montre.

    Remarque : Si votre application doit s'exécuter en permanence, transformez-la en service de premier plan via la méthode startForegroundService(). Pour en savoir plus, consultez la section Limites applicables aux services d'arrière-plan.

  • Restrictions concernant l'utilisation d'interfaces autres que SDK. Afin d'améliorer la compatibilité des applications, Android P a commencé à implémenter certaines restrictions sur l'utilisation d'interfaces non SDK. Préparez-vous à ne plus utiliser les méthodes et champs autres que SDK. Si aucun équivalent public n'est disponible pour votre cas d'utilisation, veuillez nous en informer.
  • Thème système d'UI sombre. Depuis début 2018, Wear OS est passé à un thème d'UI par défaut présentant un arrière-plan plus sombre pour le flux de notifications et le lanceur système. Ce changement vise à améliorer la visibilité de vos applications. Vous devez vérifier l'accessibilité de votre application avec ce nouveau thème d'UI.
  • Les signaux radio sont désactivés lorsque l'utilisateur ne porte plus la montre. Pour limiter la consommation de batterie, les signaux radio Bluetooth, Wi-Fi et GSM sont désactivés lorsque le système détecte que l'utilisateur ne porte plus la montre depuis un certain temps. Cette fonctionnalité sera déployée progressivement dans les versions Preview développeur. Vous ne la verrez donc peut-être pas immédiatement sur votre montre. Si jamais elle complique votre processus de développement, vous pouvez la désactiver via adb à l'aide de la commande suivante :
    adb shell settings put global off_body_radios_off_for_small_battery_enabled 0
  • Le Wi-Fi est désactivé lorsque le Bluetooth est déconnecté. Pour limiter la consommation de batterie, la montre ne se connecte plus automatiquement au Wi-Fi lorsqu'elle est déconnectée du Bluetooth. Cette règle ne s'applique pas si une application exige un réseau offrant beaucoup de bande passante ou encore si la montre est connectée à un chargeur. Cette fonctionnalité sera déployée progressivement dans les versions Preview développeur. Vous ne la verrez donc peut-être pas immédiatement sur votre montre.

Mises à jour apportées à la bibliothèque Wearable Support, version 2.3.0

La documentation de la version 2.3.0 de la bibliothèque Wearable Support intègre des changements liés au rebranding.

De plus, la version 2.3.0 de la bibliothèque inclut des modifications liées à ComplicationDrawable et TextRenderer, pour les textes contenant des objets de balisage associés à des plages de texte. Ces classes ont amélioré la gestion des textes Spanned. Seul un sous-ensemble spécifique d'éléments span peut être affiché (consultez la méthode setText pour savoir quels types d'éléments span peuvent être affichés), de sorte que ces éléments span restent correctement positionnés lorsqu'ils sont affichés dans un cadran.

Rebranding de Wear du 15 mars 2018

Cette section contient des informations sur les fonctionnalités de Wear OS.

Android Wear change de nom

Android Wear devient Wear OS by Google.

Mise à jour du mode Veille du 27 février 2018

Cette section contient des informations sur les nouvelles fonctionnalités d'Android Wear.

Nouvelle classe pour la gestion du mode Veille

La version 27.1.0 de la bibliothèque Android Support contient une nouvelle classe AmbientModeSupport qui remplace la classe AmbientMode, désormais obsolète. Les exemples seront mis à jour au cours des prochaines semaines.

Émulateur final et autres changements du 25 janvier 2018

Cette section contient des informations sur les nouvelles fonctionnalités d'Android Wear.

Android Emulator : mise à jour pour Wear

La mise à jour finale d'Android Emulator pour Wear est disponible. Elle permet de tester les applications basées sur la version 26 de l'API.

Améliorations apportées à la bibliothèque Wearable Support version 2.2.0

La version 2.2.0 de la bibliothèque Wearable Support intègre les changements décrits ci-dessous.

Nouvel indicateur pour les notifications non lues

Les utilisateurs souhaitant être informés des notifications non lues, un nouvel indicateur a été ajouté. Il prend la forme d'un point entouré d'un cercle s'affichant au bas du cadran. Si vous préférez gérer les notifications par vous-même, vous pouvez utiliser setHideNotificationIndicator pour masquer l'indicateur par défaut et afficher le vôtre, ou encore utiliser setShowUnreadCountIndicator pour afficher le nombre de notifications dans la barre d'état.

Pour personnaliser la couleur de l'anneau extérieur de l'indicateur des notifications non lues, utilisez la méthode setAccentColor.

Remarque : L'indicateur des notifications non lues n'est pas activé dans la version de production de Wear 2.8.0. Testez votre implémentation à l'aide du dernier émulateur Wear. À partir de la prochaine version grand public de Wear (version 2.9.0), l'indicateur des notifications non lues s'affichera par défaut.

Améliorations apportées à la classe ComplicationDrawable

La classe ComplicationDrawable lance une demande d'autorisation en cas d'appui sur un cadran quand le système indique la valeur TYPE_NO_PERMISSION, ce qui indique que le cadran n'est pas autorisé à obtenir les données de complication.

En outre, la classe ComplicationDrawable s'invalide lorsqu'elle termine le chargement d'images ou lorsque la mise en surbrillance d'un appui arrive à expiration. Pour répondre à cette invalidation (pour redessiner votre cadran, par exemple), ajoutez un Drawable.Callback.

Problèmes connus

  • Si vous activez le mode Cinéma dans l'émulateur, comme décrit à la section Modifier les paramètres concernant l'écran et la luminosité, l'émulateur peut rester bloqué en mode Cinéma. Pour résoudre le problème, vous devez effacer les données de l'émulateur (voir Exécuter et arrêter un émulateur, et effacer les données).
  • Dans la fenêtre d'un émulateur pour le niveau d'API 25 ou 26, le bouton Marche/Arrêt ne fonctionne pas. Utilisez donc d'autres boutons. Plus précisément, pour passer en mode Veille, par exemple, comme si un utilisateur cachait l'écran avec la paume de sa main, utilisez le bouton Marche/Arrêt figurant dans la barre d'outils de l'émulateur à droite de l'écran. Pour ouvrir le lanceur d'applications en mode interactif, utilisez le bouton Accueil dans la barre d'outils de l'émulateur.
  • Sur la version de l'émulateur destinée à la Chine, l'écran peut commencer à clignoter si vous utilisez le mode de saisie par écriture manuscrite. Ensuite, lorsque vous cliquez sur le bouton permettant d'afficher le clavier à l'écran, le clavier occupe la moitié de l'écran.

Nouvel accès aux services Google Play, 18 décembre 2017

Cette section contient des informations sur les nouvelles fonctionnalités d'Android Wear.

Abandon de la classe GoogleApiClient

À partir de la version 11.8.0 des services Google Play, les applications Wear ne doivent plus utiliser la classe GoogleApiClient et utiliser à la place des objets client API basés sur la classe GoogleApi ainsi que l'API Tasks.

Remarque : Cette mise à jour ne s'applique pas aux applications Android Wear destinées à la Chine, qui utilisent généralement la version 10.2.0 des services Google Play.

Pour en savoir plus, consultez les ressources suivantes :

New components for connecting with Google Play services

When you use classes that extend the GoogleApi class, such as DataClient and MessageClient, the Google Play services SDK manages connections to Google Play services for you. Apps that use these classes no longer need to create and manage GoogleApiClient objects. See the blog post Moving Past GoogleApiClient for more information.

For the replacements of Wear-related components for connecting to Google Play services, see Replacements for deprecated components. For releases and known issues related to Google Play services, see the Release Notes for Google Play services.

Note: If you compile your app with the latest version of Google Play services, users are prompted to update their devices to that latest version. However, a known issue for apps that target API version 26 might prevent users from being prompted to update their devices. This issue is described in the Release Notes for Google Play services.

2017-Oct-25 Ambient mode and more

This section contains information about new Android Wear features.

Android Support Library, v27.0.0: Features and bugfixes

The 27.0.0 version of the Android Support Library contains new features for Wear. Review the following section.

New, preferred way to support ambient mode

Ambient mode lets a Wear app remain visible to a user when the device goes idle. The Android Support Library has a new, preferred way for your apps to use ambient mode. The Wear team seeks developer feedback about this significant change.

Specifically, using the AmbientMode class offers the following benefits:

Manifest metadata constants in the Android Support Library

Constants for Android Wear apps, used in the meta-data tag in the Android Manifest file, are now available in the Android Support Library. To use the constants—for standalone apps, notification bridging mode, and watch face preview images—add a reference to the following in the dependencies section of the app module's build.gradle file, which requires the latest version of the Google Repository:

Groovy

implementation 'com.android.support:wear:27.0.0'

Kotlin

implementation("com.android.support:wear:27.0.0")

Action drawer updates

Updates are available to the WearableActionDrawerView class, which is used for creating a wearable action drawer. In the latest version:

  • When menu items are modified, the action drawer properly updates.
  • If set for an action drawer, the title displays correctly.

Inflation of the RoundedDrawable class

Assuming an API level of at least 24, the RoundedDrawable class can now be inflated from a drawable XML file; see Custom drawables.

Wearable Support Library, v2.1.0: Enhancements and more

The 2.1.0 version of the Wearable Support Library includes the updates described in the following section, and requires Android Support Library version 26.0.2 or higher.

Supply burn-in-safe images for ambient mode

The ComplicationDrawable class lets you supply burn-in-safe images for ambient mode. Specifically, a ComplicationData object's burn-in protection small image field lets a watch face display a small image in the SMALL_IMAGE complication type, in ambient mode, when burn-in protection is enabled.

Tap event updates for complications

The ComplicationDrawable class has a new onTap method that lets your watch face pass tap events to complications. The new method builds on the existing functionality in which a tap on the watch face triggers the WatchFaceService.Engine.onTapCommand method.

You can pass the coordinates to a ComplicationDrawable with an onTap call to launch the action associated with the ComplicationDrawable that contains the tap coordinates. When the new onTap method is called, you can use a return value of true to see whether a ComplicationDrawable launched the action associated with it.

Additionally, the setHighlightDuration method sets the duration for a complication to remain highlighted after the onTap method is called.

Progress bar for ranged value complications

If you prefer to draw your own progress bar for ranged value complications in your watch face, use the setRangedValueProgressHidden method of the ComplicationDrawable class to hide the ranged value progress that's drawn by the ComplicationDrawable.

2017-Oct-02 Android Wear beta

Date: 2017-Oct-02
Build: OWP4.170828.008
Supported device: LG Watch Sport

This section contains known issues for an Android Wear beta release. For information about the beta program or to enroll, see the Android beta page.

Known issues

  • Google Pay and its cards do not function with this Android Wear beta release.
  • Even if cellular connectivity is on, it is turned off after the beta is installed. As a workaround, turn on cellular connectivity after the beta is installed by navigating to Settings > Connectivity > Cellular.
  • If notifications are erratic or missing after a beta update, or contacts were not synced, factory-reset your watch.
  • In the Wear tutorial, which starts after a watch is set up, some cards behave erratically, but they can be dismissed normally with a swipe.
  • On Android 6.0 phones, phone call notifications are not received on the watch.
  • Heart rate monitoring sometimes fails after an update. As a workaround, reboot the watch.
  • The OTA card in the stream sometimes fails to enable an installation. As a workaround, navigate to Settings > System > About > System Updates.