Créer et exécuter votre première application Wear OS

Cette page vous explique comment créer votre première application pour Wear OS à l'aide d'un modèle Android Studio. L'application présente les différentes manières d'afficher un aperçu des informations sur les appareils Wear OS, ainsi que quelques bonnes pratiques pour développer des applications sur la plate-forme.

Ce guide s'appuie sur certaines connaissances préalables de la plate-forme Android et de l'IDE Android Studio. Si vous débutez sur Android, créez une application à l'aide de cet atelier de programmation. Pour en savoir plus sur les fonctionnalités d'Android Studio, consultez la page Découvrir Android Studio.

Créer une application Wear OS

Après avoir téléchargé et installé la dernière version d'Android Studio, suivez les instructions de l'assistant New Project (Nouveau projet) :

  1. Ouvrez Android Studio, puis accédez à File > New > New Project (Fichier > Nouveau > Nouveau projet). La fenêtre New Project (Nouveau projet) s'affiche.
  2. Dans le volet Templates (Modèles), sélectionnez Wear OS. Ensuite, dans le volet principal, sélectionnez Empty Wear App (Application Wear vide).
  3. Attribuez un nom à votre projet, puis cliquez sur Finish (Terminer). Android Studio télécharge les dépendances nécessaires et crée votre projet.

Vous pouvez désormais exécuter votre première application sur Wear OS.

Exécuter une application sur l'émulateur

Un moyen simple d'exécuter votre application Wear OS consiste à utiliser un émulateur.

Configurer un émulateur

Pour configurer un émulateur dans Android Studio, procédez comme suit :

  1. Dans SDK Manager, ouvrez l'onglet SDK Tools (Outils SDK). Vérifiez que vous disposez de la dernière version d'Android SDK Platform-Tools. Fermez SDK Manager.
  2. Accédez à Tools > Device Manager (Outils > Gestionnaire d'appareils).
  3. Sélectionnez Create (+) (Créer (+)). L'assistant Virtual Device Configuration (Configuration de l'appareil virtuel) s'affiche.
  4. Dans le volet Category (Catégorie), sélectionnez Wear OS et choisissez un profil matériel, tel que Wear OS Small Round. Cliquez sur Next (Suivant).
  5. Sauf si vous avez besoin de personnalisations spécifiques, conservez les paramètres par défaut sur cet écran. Android Studio sélectionne la dernière API et la dernière image système par défaut. Cliquez sur Terminer.

Pour plus d'informations sur l'utilisation des émulateurs, consultez le guide Exécuter des applications sur Android Emulator.

Ouvrir l'application dans l'émulateur

  1. Dans la barre d'outils principale, recherchez le widget d'exécution. Dans le menu déroulant de sélection de l'appareil, sélectionnez l'émulateur que vous avez créé, puis cliquez sur le bouton Exécuter "Bouton "Exécuter"" pour lancer l'application.
  2. Après quelques instants, le message "Hello…" (Bonjour…) s'affiche dans l'émulateur.

Exécuter une application sur une montre physique (facultatif)

Exécuter et déboguer votre application sur une montre physique vous permet de mieux évaluer l'expérience utilisateur globale. Cela est particulièrement important si votre application repose sur du matériel spécifique, tel que des capteurs ou un GPU.

Pour exécuter une application sur une montre physique, préparez l'appareil à des fins de test, puis connectez-le à votre ordinateur de développement.

Préparer la montre pour les tests

Afin de préparer votre montre pour les tests, activez le débogage ADB en suivant les étapes ci-dessous :

  1. Sur la montre, ouvrez le menu Paramètres.
  2. Accédez au bas du menu. Si aucun élément Options pour les développeurs ne s'affiche, suivez les étapes ci-dessous. Sinon, passez directement à l'étape suivante.
    1. Appuyez sur Système > À propos ou sur Système > À propos > Versions.
    2. Recherchez l'élément Numéro de version, puis appuyez dessus sept fois. Si votre montre est protégée par un code ou un schéma, saisissez-le lorsque vous y êtes invité.
  3. Dans le menu Paramètres, appuyez sur Options pour les développeurs.
  4. Activez l'option Débogage ADB.

Pour en savoir plus, consultez Configurer les options pour les développeurs sur l'appareil.

Connecter la montre à l'ordinateur de développement

Certaines montres vous permettent de vous connecter à l'aide d'un câble USB, tandis que d'autres nécessitent une connexion sans fil.

Configurer une connexion filaire via USB

Pour connecter la montre, procédez comme suit :

  1. Connectez la montre à votre ordinateur de développement à l'aide d'un câble USB.
  2. Sur la montre, activez Toujours autoriser sur cet ordinateur, puis appuyez sur OK.

Configurer une connexion sans fil

Si vous ne pouvez pas déboguer votre montre via un port USB, consultez Se connecter à votre appareil à l'aide du Wi-Fi.

Ouvrir l'application sur la montre

  1. Dans Run Widget (Exécuter le widget), qui fait partie de la barre d'outils principale, utilisez le menu déroulant de l'appareil pour sélectionner votre appareil physique.
  2. Cliquez sur le bouton Exécuter "Bouton "Exécuter"" dans le widget d'exécution.
  3. Après quelques instants, le message "Hello…" (Bonjour…) s'affiche sur votre appareil.

Planifier l'architecture de votre application

Maintenant que vous avez une application de base en cours d'exécution, vous êtes prêt à aller au-delà du modèle. Avant de commencer à ajouter de nouvelles fonctionnalités, il est utile de réfléchir aux principales décisions architecturales qui façonneront votre application. Les sections suivantes explorent quelques questions importantes à prendre en compte.

Modèle d'application : autonome, non autonome ou hybride

Réfléchissez à la mesure dans laquelle votre application repose sur un téléphone associé :

  • Hybride (recommandé pour la plupart des applications) : il s'agit de l'approche la plus courante et la plus flexible. Les fonctionnalités de base de l'application fonctionnent sans téléphone (comme le suivi d'un entraînement), mais elle offre des fonctionnalités améliorées lorsqu'un téléphone est connecté, comme la synchronisation des données ou une configuration plus facile.
  • Autonome : votre application fonctionne de manière totalement indépendante, sans nécessiter de téléphone pour les fonctionnalités de base. Cette option est idéale pour les applications qui peuvent fonctionner hors connexion ou qui utilisent leur propre connexion Internet. Le modèle "Empty Wear App" (Application Wear vide) crée une application autonome par défaut.
  • Non autonome : votre application nécessite un téléphone pour sa fonctionnalité principale.

Pour en savoir plus et obtenir des conseils sur ce choix, consultez Applications Wear OS autonomes ou non autonomes.

Créer votre interface utilisateur

Compose pour Wear OS est un framework déclaratif moderne qui est la méthode recommandée pour créer des UI pour les applications Wear OS. Le modèle que vous avez utilisé est conçu avec Compose, ce qui vous offre un excellent point de départ.

Lorsque vous créez une application avec Compose, utilisez les bibliothèques conçues spécifiquement pour Wear OS. Ils fournissent des composants optimisés pour les montres, qui sont essentiels pour une expérience utilisateur de qualité.

Par exemple, au lieu d'un LazyColumn standard, utilisez TransformingLazyColumn, qui applique automatiquement des effets de mise à l'échelle et de transparence aux éléments situés au bord d'un écran rond.

De même, pour la navigation, utilisez SwipeDismissableNavHost de la bibliothèque de navigation Wear OS pour l'intégrer au geste de balayage pour fermer du système.

Stockage et synchronisation des données

La façon dont vous gérez les données est un choix architectural fondamental. Pour la persistance sur l'appareil, vos options sont les mêmes que sur mobile, avec DataStore pour les données clé-valeur ou les objets typés, et Room pour les données structurées plus complexes, qui sont les choix modernes recommandés.

  • Stockez d'abord les données sur l'appareil : concevez votre application pour qu'elle soit orientée hors connexion, en stockant les données nécessaires directement sur la montre afin qu'elle reste fonctionnelle sans connexion téléphonique.
  • Synchroniser des données avec le téléphone : lorsque vous devez synchroniser ou diffuser des données (comme les paramètres utilisateur ou les données d'entraînement) avec une application mobile associée, utilisez l'API Data Layer. Il fournit un canal de communication qui fonctionne via Bluetooth et Wi-Fi.

Gérer les tâches de longue durée

De nombreuses expériences Wear OS de base, comme les entraînements ou la lecture de contenus multimédias, sont de longue durée. Il est essentiel de gérer correctement ce travail pour maintenir la fiabilité et préserver la batterie.

  • Pour les tâches de longue durée initiées par l'utilisateur : lorsqu'un utilisateur lance une tâche qui doit se poursuivre même s'il quitte l'application (comme le suivi d'une course), vous devez utiliser un service de premier plan. Sur Wear OS, associez ce service à l'API Activité en cours. Cela crée une notification persistante et une icône cliquable sur le cadran, qui permet à l'utilisateur de revenir à votre application.
  • Pour les tâches d'arrière-plan différables : pour les tâches qui n'ont pas besoin d'être effectuées immédiatement (comme la synchronisation périodique des données), utilisez WorkManager. Il est sensible à la batterie et respecte les optimisations du système comme le mode Sommeil, ce qui en fait un bon choix pour le traitement en arrière-plan non urgent.

Penser au-delà de l'application : surfaces et puissance

Enfin, n'oubliez pas qu'une expérience Wear OS ne se limite pas à l'application principale.

  • Prenez en charge d'autres surfaces : pour créer une application attrayante et de haute qualité, prévoyez de prendre en charge d'autres surfaces optimisées pour les montres. Envisagez de créer une vignette pour les actions et informations rapides, et une complication pour afficher les données importantes directement sur le cadran de l'utilisateur.
  • Planifiez l'efficacité énergétique : l'autonomie de la batterie est essentielle sur un appareil wearable. Dès le début, concevez votre application pour qu'elle soit économe en énergie. Cela signifie que vous devez réfléchir attentivement à la façon dont vous récupérez les données, utilisez les capteurs et exécutez les tâches en arrière-plan. Il est souvent judicieux de différer le travail jusqu'à ce que la montre soit en charge. Pour en savoir plus, consultez le guide sur l'économie d'énergie.