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 aux autres applications qui utilisent le kit de développement logiciel (SDK) Android, mais présentent une conception et des fonctionnalités différentes.

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 en Chine, consultez la section Créer des applications Wear OS pour la Chine.

Créer une application Wear OS

Vous pouvez créer un projet d'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 :

Cliquez sur File > New > New Project (Fichier > Nouveau > Nouveau projet).
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).
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.
Dans le fichier build.gradle du module de l'application, procédez comme suit :
- 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.
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>
```
Synchronisez votre projet Android Studio. Pour exécuter le code dans le nouveau module, suivez la procédure décrite dans la section ci-dessous.

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 :

Dans Android Studio, sélectionnez Outils > AVD Manager pour ouvrir le gestionnaire d'appareils virtuels Android.
Cliquez sur Créer un appareil virtuel.
Dans le volet Catégorie, sélectionnez Wear OS et choisissez un profil matériel. Cliquez sur Next (Suivant).
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 (Suivant), puis sur Finish (Terminer).
Fermez le gestionnaire d'appareils virtuels Android.
Dans la barre d'outils Android Studio, sélectionnez l'AVD que vous venez de créer dans le menu des appareils cibles, puis cliquez sur Run (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.

Incluez les éléments suivants dans le fichier settings.gradle de votre projet Android Studio :

  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 d'adb sur la montre comme suit :

Ouvrez le menu Settings (Paramètres) sur la montre.
Faites défiler le menu vers le bas. Si aucun élément Options pour les développeurs n'est fourni, appuyez sur System (Système), puis sur About (À propos).
Appuyez sept fois sur le numéro de version.
Dans le menu Settings (Paramètres), appuyez sur Developer options (Options pour les développeurs).
Activez le débogage ADB.

Pour connecter la montre, procédez comme suit :

Connectez la montre à votre ordinateur à l'aide d'un câble USB afin de pouvoir y installer des applications directement.
Sur la montre, appuyez sur Always allow from this computer (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 avec une application associée Wear OS.

Remarque : Nous vous recommandons d'utiliser des applications Wear OS autonomes qui fonctionnent indépendamment d'un téléphone. Toutefois, si votre application Wear OS dépend d'une application mobile, consultez les informations suivantes 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 fiche de l'application Wear OS by Google Smartwatch. Appuyez sur Update (Mettre à jour) pour télécharger et installer l'application. Après l'installation, vérifiez que l'option Auto-update (Mise à jour automatique) est sélectionnée pour l'application. Consultez la section "Mettre à jour automatiquement des applications Android individuelles" de l'article Mettre à jour les applications téléchargées. Appuyez sur Open (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. Voici l'approche à suivre :

Sur le téléphone, sélectionnez le nom de votre montre dans la liste. Un code d'association s'affiche sur le téléphone et sur la montre. Vérifiez que les deux codes sont identiques.
Appuyez sur Pair (Associer) pour poursuivre le processus d'association. Lorsque la montre se connecte au téléphone, un message de confirmation s'affiche. Sur le téléphone, un écran qui indique les comptes du téléphone s'affiche.
Sélectionnez le compte Google à ajouter et à synchroniser avec votre montre.
Confirmez le verrouillage de l'écran et saisissez le mot de passe pour commencer à copier le compte du téléphone vers la montre.
Suivez les instructions de l'assistant pour terminer le processus d'association.

Application associée pour iPhone

Une application associée iOS est disponible pour les téléphones équipés d'iOS 8.2 ou version ultérieure. Pour l'installer, procédez comme suit :

Sur votre iPhone, accédez à l'App Store, puis téléchargez et installez l'application associée Wear OS by Google.
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 concernant la résolution des problèmes de configuration avec votre montre.

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 :

Si vous ne l'avez pas déjà fait, créez un émulateur Wear.
Dans le Gestionnaire d'appareils, cliquez sur l'icône du menu à développer à côté de l'appareil que vous souhaitez associer, puis sélectionnez Pair Wearable (Associer l'accessoire connecté).

Figure 1 : Menu déroulant d'un appareil pouvant être associé à un émulateur Wear
L'assistant d'association de l'émulateur Wear OS est alors lancé. Si vous avez sélectionné Pair Wearable (Associer l'accessoire connecté) dans l'entrée correspondant à 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).
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 installée sur votre téléphone, suivez les instructions pour vous connecter au Play Store, l'installer, puis la configurer.
Pour associer vos appareils dans l'application Wear OS sur votre téléphone, cliquez sur le menu à développer, puis sélectionnez Pair with emulator (Associer à un émulateur).

Une fois vos appareils associés, le Gestionnaire d'appareils 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 de la manière suivante :

Suivez la procédure de configuration d'un téléphone.
Sur le téléphone, activez Options pour les développeurs et Débogage USB.
Connectez le téléphone à votre ordinateur à l'aide d'un câble USB.
Transférez le port de communication de l'AVD vers le téléphone connecté (chaque fois que le téléphone est connecté) à l'aide de la commande suivante :
adb -d forward tcp:5601 tcp:5601
Dans l'application associée Wear OS du téléphone, lancez la procédure d'association standard. Par exemple, sur l'écran d'accueil, appuyez sur le bouton Set It Up (Configurer). Si une montre existante est déjà associée, appuyez sur Add a New Watch (Ajouter une montre) dans le menu en haut à gauche.
Dans l'application associée Wear OS du téléphone, appuyez sur le menu à développer, puis sur Pair with Emulator (Associer à un émulateur).
Appuyez sur l'icône Settings (Paramètres).
Sous Device Settings (Paramètres de l'appareil), appuyez sur Emulator (Émulateur).
Appuyez sur Accounts (Comptes) et sélectionnez un compte Google. Suivez les étapes de l'assistant pour synchroniser le compte 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 l'icône du menu à 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 afin de pouvoir réutiliser le code depuis votre application mobile.

Créer un module Wear OS dans le projet

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

Cliquez sur File > New > New Module (Fichier > Nouveau > Nouveau module).
Dans la fenêtre New Module, sélectionnez Wear OS Module (Module Wear OS), puis cliquez sur Next.
Sous Configure the new module (Configurer le nouveau module), saisissez les informations suivantes :
- Application/Library Name (Nom de l'application/de la bibliothèque) : titre de l'icône de lanceur d'applications pour le nouveau module.
- Module Name (Nom du module) : nom du dossier contenant le code source et les fichiers de ressources.
- Package Name (Nom du package) : espace de noms Java du code de votre module. Cette chaîne est ajoutée en tant qu'attribut package dans le fichier manifeste Android du module.
- SDK minimal : 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.
Cliquez sur Next (Suivant). Plusieurs options de modèle de code s'affichent. Sélectionnez Blank Wear OS Activity (Activité Wear OS vide), puis cliquez sur Next (Suivant).
Dans la fenêtre Configure Activity (Configurer l'activité), saisissez ou acceptez les valeurs par défaut pour Activity Name (Nom de l'activité), Layout Name (Nom de la mise en page) et Source Language (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 Project (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 :

Dans la section android, définissez les valeurs compileSdkVersion sur 33 et targetSdkVersion sur 30.
Ajoutez les dépendances dont vous avez besoin. Pour en savoir plus, consultez la section Déclarer des dépendances.
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.

Inclure les bibliothèques

Remarque : Utilisez Android Studio pour le développement de Wear OS, car il fournit des options de configuration de projet, d'inclusion dans la bibliothèque et de packaging.

Lorsque vous utilisez l'assistant de projet d'Android Studio, il importe les dépendances dans le fichier build.gradle du module approprié. Toutefois, 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 mises en page basées 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 lorsque l'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 vous familiariser avec les bonnes pratiques, consultez la section Conserver la visibilité de votre application sur Wear OS.