Créer et exécuter une appli connectée

Les applications Wear OS s'exécutent directement sur une montre, ce qui vous donne accès à du matériel tel que des capteurs et le GPU. Les applications connectées sont semblables à d'autres applications qui utilisent le SDK Android, mais elles diffèrent par leur conception et leurs fonctionnalités.

Une application Wear OS doit fonctionner indépendamment d'une application de téléphone, ce qui offre aux utilisateurs une flexibilité optimale quant à leur choix de téléphone. Pour en savoir plus, consultez la section Applications Wear OS autonomes ou non autonomes.

Remarque : Vous pouvez tester votre application sur une montre à l'aide d'un câble USB, du Wi-Fi ou du Bluetooth, comme décrit dans la section Déboguer une application Wear OS. Le débogage de votre application sur une montre vous permet de mieux évaluer l'expérience utilisateur totale. Vous pouvez également utiliser l'émulateur de montre sur Android Studio pour tester votre application avec différentes formes et tailles d'écran.

Configurer votre environnement

Installez la dernière version d'Android Studio. Pour en savoir plus sur la création d'applications dans Android Studio, consultez Aperçu des projets.

Utilisez le SDK Manager pour vérifier que vous disposez de la dernière version de la plate-forme Android compatible avec Wear OS, Android 11 (niveau d'API 30).

Si vous prévoyez de rendre vos applications Wear OS disponibles pour la Chine, consultez Créer des applications Wear OS pour la Chine.

Créer une application Wear OS

Vous pouvez créer une application Wear OS à l'aide de l'assistant Nouveau projet d'Android Studio.

Démarrer un projet Wear OS

Pour créer un projet dans Android Studio, procédez comme suit :

  1. Cliquez sur File > New > New Project (Fichier > Nouveau > Nouveau projet).
  2. Dans la fenêtre Project Template (Modèle du projet), cliquez sur l'onglet Wear OS, sélectionnez Empty Compose Activity (Activité Compose vide), puis cliquez sur Next (Suivant).
  3. Dans la fenêtre New Project (Nouveau projet), attribuez un nom à votre projet, renseignez les informations standards sur le projet, puis cliquez sur Finish (Terminer).

    Android Studio crée un projet avec un module d'application pour votre fournisseur de données.

  4. Dans le fichier build.gradle du module de l'application :
    • Dans la section android, vérifiez que compileSdkVersion est défini sur 33.
    • Dans la section android, vérifiez que targetSdkVersion est défini sur 30.
    • Remplacez la section dependencies par des dépendances spécifiques à Wear OS.
  5. Dans le fichier manifeste Android, assurez-vous que la balise <uses-feature> est définie. Définissez android:name="android.hardware.type.watch" comme indiqué dans l'exemple suivant :
    <manifest>
    ...
      <uses-feature android:name="android.hardware.type.watch" />
    ...
    </manifest>
    
  6. Synchronisez votre projet Android Studio. Pour exécuter le code dans le nouveau module, consultez la section Lancer l'émulateur et exécuter votre application Wear OS.

Lancer l'émulateur et exécuter votre application Wear OS

Pour utiliser l'émulateur, configurez un appareil virtuel Android (AVD). Vérifiez que vous disposez de la dernière version d'Android SDK Platform-tools dans le SDK Manager.

Configurez un AVD et exécutez votre application comme suit :

  1. Dans Android Studio, sélectionnez Outils > AVD Manager pour ouvrir le gestionnaire d'appareils virtuels Android.
  2. Cliquez sur Créer un appareil virtuel.
  3. Dans le volet Catégorie, sélectionnez Wear OS et choisissez un profil matériel. Cliquez sur Next (Suivant).
  4. Sélectionnez une image système à télécharger. Par exemple, sélectionnez l'image avec le niveau d'API 30 et la cible "Android 11.0 (Wear OS)". Cliquez sur Next, puis sur Finish.
  5. Fermez le gestionnaire d'appareils virtuels Android.
  6. Dans la barre d'outils Android Studio, sélectionnez l'AVD que vous venez de créer dans le menu déroulant des appareils cibles, puis cliquez sur Exécuter .

    L'AVD démarre, puis exécute votre application après quelques instants. Un message "Hello..." s'affiche.

Pour en savoir plus sur l'utilisation des AVD, consultez Exécuter des applications sur l'émulateur Android.

Mettre à jour un projet Wear OS

Si vous avez déjà créé un projet, vous devrez peut-être mettre à jour le fichier settings.gradle. Assurez-vous d'utiliser google() pour indiquer le dépôt Google Maven. Pour en savoir plus, consultez le dépôt Maven de Google.

Le fichier settings.gradle de votre projet Android Studio doit inclure les éléments suivants :

  dependencyResolutionManagement {
      ...
      repositories {
          google()
          jcenter()
      }
  }

Avertissement : Le dépôt JCenter est en lecture seule depuis le 31 mars 2021. Pour en savoir plus, consultez la mise à jour du service JCenter.

Configurer une montre

Le déploiement d'une application sur une montre est semblable au déploiement sur un téléphone.

Cette section suppose que votre montre dispose d'un port USB. Dans le cas contraire, consultez les instructions de connexion à l'aide du Wi-Fi ou de Bluetooth.

Activez le débogage adb sur la montre :

  1. Ouvrez le menu Paramètres sur la montre.
  2. Faites défiler le menu vers le bas. Si aucun élément Options pour les développeurs n'est fourni, appuyez sur Système, puis sur À propos.
  3. Appuyez sept fois sur le numéro de version.
  4. Dans le menu Paramètres, appuyez sur Options pour les développeurs.
  5. Activez le débogage ADB.

Connectez la montre :

  1. Connectez la montre à votre ordinateur à l'aide d'un câble USB afin de pouvoir y installer directement des applications.
  2. Sur la montre, appuyez sur Toujours autoriser sur cet ordinateur, puis sur OK.

Une fois la montre connectée, exécutez votre application en sélectionnant une cible de déploiement, comme décrit dans la section Compiler et exécuter votre application.

Configurer un téléphone

Cette section contient des informations sur la configuration d'un téléphone associé avec une application associée Wear OS.

Remarque : Les applications Wear OS doivent être autonomes et fonctionner indépendamment du téléphone. Toutefois, si votre application dépend d'une application de téléphone, consultez les informations ci-dessous pour découvrir comment mettre à jour un téléphone avec la dernière application associée Wear OS.

Utiliser la version Android de l'application associée

Sur un téléphone Android, accédez à la liste des applications Wear OS. Appuyez sur Mettre à jour pour télécharger et installer l'application. Après l'installation, vérifiez que l'option Mise à jour automatique est sélectionnée pour l'application (consultez la section sur la configuration des mises à jour automatiques pour des applications spécifiques dans Mettre à jour les applications téléchargées). Appuyez sur Ouvrir pour lancer l'application.

Associer un téléphone Android à une montre

Après avoir installé l'application associée sur un téléphone, dissociez les montres obsolètes si nécessaire. Ensuite, associez le téléphone à une nouvelle montre :

  1. Sur le téléphone, sélectionnez le nom de votre appareil dans la liste. Un code d'association s'affiche sur le téléphone et sur la montre. Assurez-vous que les codes correspondent.
  2. Appuyez sur Associer pour poursuivre le processus d'association. Un message de confirmation s'affiche lorsque la montre est connectée au téléphone. Un écran s'affiche sur le téléphone. Il indique les comptes du téléphone.
  3. Sélectionnez le compte Google à ajouter et à synchroniser avec votre montre.
  4. Confirmez le verrouillage de l'écran et saisissez le mot de passe pour commencer à copier le compte du téléphone vers la montre.
  5. Suivez les instructions de l'assistant pour terminer le processus d'association.

Application associée pour iPhone

Une application associée iOS est disponible, mais le téléphone sur lequel elle est installée doit exécuter iOS 8.2 ou une version ultérieure :

  1. Sur votre iPhone, accédez à l'App Store, puis téléchargez et installez l'application associée Wear OS sur votre appareil.
  2. Suivez les instructions sur la montre et sur le téléphone pour lancer le processus d'association. Pour en savoir plus, consultez la page d'aide correspondante.

Associer des appareils à un émulateur de montre

Vous pouvez associer des appareils à un AVD (appareil virtuel Android) de montre, ou à un émulateur, soit manuellement, soit à l'aide de l'assistant d'association de l'émulateur Wear OS.

Utiliser l'assistant d'association de l'émulateur Wear OS

Remarque : Votre téléphone doit exécuter Android 11 (niveau d'API 30) ou version ultérieure, et le Google Play Store doit être installé pour que vous puissiez utiliser l'assistant d'association de l'émulateur Wear OS. Assurez-vous également que vos émulateurs Wear exécutent le niveau d'API 28 ou supérieur pour utiliser les dernières fonctionnalités de l'assistant. Pour mettre à niveau les images système de vos appareils émulés, utilisez SDK Manager.

L'assistant d'association de l'émulateur Wear OS facilite la gestion et la connexion des émulateurs Wear. Vous pouvez associer plusieurs appareils Wear à un seul téléphone virtuel ou physique. De plus, Android Studio mémorise et réassocie les appareils déjà associés lors de leur lancement.

Pour associer deux appareils, procédez comme suit :

  1. Si vous ne l'avez pas déjà fait, créez un émulateur Wear.
  2. Dans Device Manager (Gestionnaire d'appareils), appuyez sur l'icône du menu à développer de l'un des appareils à associer, puis sélectionnez Pair Wearable (Associer l'accessoire connecté).

    Figure 1. Menu déroulant d'un appareil pouvant être associé à un émulateur Wear.

  3. L'assistant d'association de l'émulateur Wear OS est alors lancé. Si vous avez cliqué sur Pair Wearable (Associer l'accessoire connecté) sur un téléphone, la liste des appareils Wear disponibles s'affiche. Si vous avez commencé par un appareil Wear, c'est la liste des téléphones disponibles qui s'affiche. Sélectionnez l'appareil que vous souhaitez associer, puis cliquez sur Next (Suivant).
  4. Le lancement et la préparation des appareils peuvent prendre quelques minutes dans Android Studio. Si l'application associée Wear OS n'est pas encore installée sur votre téléphone, suivez les invites pour vous connecter au Play Store, l'installer, puis la configurer.
  5. Pour associer vos appareils dans l'application Wear OS sur votre téléphone, cliquez sur le menu à trois points, puis sélectionnez Pair with emulator (Associer à l'émulateur).

Une fois vos appareils associés, Device Manager affiche de petites icônes à côté de ces appareils. Vous pouvez également cliquer sur le menu déroulant à développer et sélectionner View Details (Afficher les détails) pour afficher la liste des appareils associés.

Figure 2. La fenêtre de l'outil Paired Devices (Appareils associés) affiche les appareils associés à celui qui est sélectionné.

Associer un téléphone à l'AVD d'une montre

Si vous souhaitez avoir un compte Google sur l'AVD d'une montre pour développer votre application, vous pouvez associer un téléphone à l'AVD et synchroniser un compte Google :

  1. Suivez la procédure de configuration d'un téléphone.
  2. Sur le téléphone, activez Options pour les développeurs et Débogage USB.
  3. Connectez le téléphone à votre ordinateur à l'aide d'un câble USB.
  4. Transférez le port de communication de l'AVD vers le téléphone connecté (chaque fois que le téléphone est connecté) :
    adb -d forward tcp:5601 tcp:5601
  5. Dans l'application Wear OS, sur votre téléphone, lancez la procédure d'association standard. Par exemple, sur l'écran d'accueil, appuyez sur le bouton Configurer. Si une montre est déjà associée, appuyez sur la liste déroulante dans l'angle supérieur gauche, puis sur Ajouter une montre.
  6. Sur le téléphone, dans l'application Wear OS, appuyez sur le bouton à développer, puis sur Associer à un émulateur.
  7. Appuyez sur l'icône Paramètres.
  8. Sous Paramètres de l'appareil, appuyez sur Émulateur.
  9. Appuyez sur Comptes et sélectionnez un compte Google, puis suivez les étapes de l'assistant pour le synchroniser avec l'émulateur. Si nécessaire, saisissez le mot de passe de verrouillage de l'écran et le mot de passe du compte Google afin de lancer la synchronisation du compte.

Connecter un téléphone à plusieurs appareils Wear

Pour connecter un deuxième appareil Wear à un téléphone virtuel ou physique, suivez la même procédure que pour une association initiale : localisez le téléphone ou l'appareil Wear que vous souhaitez associer dans Device Manager, cliquez sur le menu déroulant à développer, puis sur Pair Wearable (Associer l'accessoire connecté).

Ajouter un module Wear OS à votre projet

Vous pouvez ajouter un module pour un appareil Wear OS à votre projet dans Android Studio, ce qui vous permet de réutiliser le code de votre application mobile (téléphone).

Fournir un module Wear OS dans le projet existant

Pour créer un module Wear OS, ouvrez votre projet Android Studio et procédez comme suit :

  1. Cliquez sur File > New > New Module (Fichier > Nouveau > Nouveau module).
  2. Dans la fenêtre New Module, sélectionnez Wear OS Module (Module Wear OS), puis cliquez sur Next.
  3. Sous Configurer le nouveau module, saisissez les informations suivantes :
    • Nom de l'application/de la bibliothèque : il s'agit du titre de l'icône de lanceur d'applications du nouveau module.
    • Nom du module : cette chaîne correspond au nom du dossier contenant le code source et les fichiers de ressources.
    • Nom du package : cette chaîne est l'espace de noms Java pour le code de votre module. Cette chaîne est ajoutée en tant qu'attribut package dans le fichier manifeste Android du module.
    • SDK minimal : sélectionnez la version de plate-forme minimale requise pour le module de l'application. Par exemple, sélectionnez API 26 : Android 8.0. Cette valeur définit l'attribut minSdkVersion dans le fichier build.gradle, que vous pouvez modifier ultérieurement.
  4. Cliquez sur Next. Plusieurs options de modèle de code s'affichent. Cliquez sur Activité Wear OS vide, puis sur Suivant.
  5. Dans la fenêtre Configurer l'activité, saisissez ou acceptez les valeurs par défaut pour Nom de l'activité, Nom de la mise en page et Langue source. Cliquez sur Terminer.

Android Studio crée et synchronise les fichiers du nouveau module. Android Studio ajoute également les dépendances requises pour Wear OS au fichier de compilation du nouveau module. Le nouveau module apparaît dans la fenêtre Projet à gauche de l'écran. Si vous ne voyez pas le dossier du nouveau module, assurez-vous que la fenêtre affiche la vue Android.

Incluez les éléments suivants dans le fichier build.gradle du nouveau module Wear OS :

Inclure les bibliothèques

Remarque : Nous vous recommandons d'utiliser le développement sur Android Studio pour Wear OS, car il permet de configurer le projet, d'inclure des bibliothèques et d'empaqueter le tout.

Lorsque vous utilisez l'assistant de projet d'Android Studio, il importe les dépendances dans le fichier build.gradle du module approprié. Cependant, les dépendances ne sont pas obligatoires pour toutes les applications. Veuillez consulter les informations ci-dessous concernant les dépendances.

Pour qu'un projet Wear OS utilise la dernière version du SDK, reportez-vous aux paramètres indiqués dans la section Démarrer un projet Wear OS.

Notifications

Pour en savoir plus sur les dépendances des notifications, consultez Créer une notification sur Wear.

Créer des UI pour Wear OS

Nous vous recommandons d'utiliser Compose pour créer des UI pour les applications Wear OS. Compose pour Wear OS propose plus de 20 composants conçus pour le facteur de forme Wear OS, ce qui est bien plus que le nombre de composants disponibles pour les modèles basés sur les vues. Ces composants sont conçus pour vous aider à créer des expériences utilisateur conformes aux dernières consignes relatives à Material Design pour Wear OS. Cependant, si vous préférez créer avec des vues, ajoutez une dépendance à la bibliothèque de l'UI Wear OS. Pour en savoir plus, consultez Créer des interfaces utilisateur basées sur les vues sur Wear OS.

Services Play et API Wearable Data Layer

Si votre application dépend des services Google Play, que ce soit pour synchroniser et envoyer des données (à l'aide des API Data Layer) ou pour d'autres raisons, vous devez disposer de la dernière version des services Google Play. Si vous n'utilisez pas ces API, supprimez la dépendance.

Économiser la batterie de la montre

Une montre passe du mode interactif au mode Veille lorsqu'elle est inactive ou lorsqu'un utilisateur recouvre l'écran avec la paume de la main.

Pour économiser la batterie de votre montre, évitez d'utiliser le mode Veille. Si la montre déclenche le mode Veille du système lorsque votre application est active et que l'utilisateur interagit de nouveau avec elle dans un certain délai, votre application s'affichera en premier.

Vous pouvez remplacer le mode Veille dans votre application pour des cas d'utilisation spécifiques (par exemple, si l'utilisateur effectue le suivi d'une course à pied et doit voir l'heure en permanence).

Les applications qui peuvent passer en mode Veille sont des applications toujours activées. Vous trouverez ci-dessous la description des deux modes de fonctionnement des applications toujours activées :

Mode interactif
Ce mode permet d'utiliser toutes les couleurs avec une animation fluide. L'application réagit également aux entrées.
Mode Veille
Ce mode affiche l'écran avec des graphismes en noir et blanc et ne répond pas aux entrées. Il n'est compatible qu'avec les appareils équipés d'Android 5.1 ou version ultérieure.

Pour en savoir plus et pour découvrir les bonnes pratiques, consultez la page Laisser votre application visible sur Wear OS.