Créer et exécuter une application sur 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 la version initiale de votre projet.

  4. Accédez à Tools > SDK Manager (Outils > SDK Manager) et installez les deux packages suivants:

    • Android 14.0 ("UpsideDownCake") (niveau d'API 34), qui inclut l'image système Wear OS 5 – ARM 64 v8a et l'image système Wear OS 5 – Intel x86 Atom_64.
    • Android 13.0 ("Tiramisu") (niveau d'API 33), qui inclut l'image système Wear OS 4 ARM 64 v8a et l'image système Wear OS 4 Intel x86 Atom_64.

    Pour fermer SDK Manager, cliquez sur OK.

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

Exécuter une application sur l'émulateur

Le moyen le plus simple d'exécuter votre première application Wear OS consiste à configurer 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.
  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. Pour les images système utilisées en dehors de la Chine, sélectionnez le nom de version UpsideDownCake. Cette version cible Android 14.0 (Wear OS 5). Pour les images système utilisées en Chine, sélectionnez le nom de version R. Cette version cible Android 11.0 (Wear OS 3). Si vous n'avez pas encore installé d'image système Wear OS 5 correspondant à la définition de votre appareil, cliquez sur Download (Télécharger) à côté de Release Name (Nom de la version). Cliquez sur Next (Suivant).

    Remarque : Les images système de l'émulateur Wear OS incluent des avis de fichiers et de code source tiers. Vous pouvez afficher les avis de tiers pour une image système particulière en ouvrant le fichier NOTICE.txt, qui se trouve dans l'un des répertoires suivants :

    • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear/ABI pour les émulateurs utilisés en dehors de la Chine.
    • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear-cn/ABI pour les émulateurs utilisés en Chine.

  6. Vous pouvez conserver la valeur par défaut pour tous les paramètres de cet écran, sauf si vous souhaitez personnaliser votre émulateur. Cliquez sur Finish (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. Accédez à Run > Select Device (Exécuter > Sélectionner un appareil). Choisissez l'émulateur que vous venez de créer.
  2. Dans la barre d'outils d'Android Studio, cliquez sur Run (Exécuter) . L'émulateur démarre et ouvre votre application.
  3. Après quelques instants, le message "Hello…" (Bonjour…) s'affiche dans l'émulateur.

Tester l'audio Bluetooth à l'aide de l'émulateur

Sur les images système exécutant Wear OS 4 ou une version ultérieure, l'émulateur prend en charge le Bluetooth émulé, ce qui vous permet de tester l'audio Bluetooth dans plusieurs cas d'utilisation.

Les images système récentes ne sont compatibles qu'avec les architectures 64 bits

Les images système de l'émulateur pour Wear OS 4 et versions ultérieures ne sont compatibles qu'avec les architectures 64 bits suivantes: x86-64 et arm64-v8a. Si vous savez ou pensez que votre application utilise du code natif (qui n'est pas écrit dans les langages de programmation Kotlin ou Java), vérifiez qu'elle inclut des bibliothèques natives 32 bits et 64 bits.

Pour en savoir plus sur la compatibilité avec les architectures 64 bits, consultez cette page.

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

Exécuter et déboguer votre application sur une montre 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. Faites défiler le menu vers le bas. 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.

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 votre montre ne possède pas de port USB, découvrez comment connecter une montre via le Wi-Fi ou le Bluetooth.

Installer une version spécifique de Wear OS (facultatif)

Si le scénario de test de votre application dépend d'une version spécifique de Wear OS, vous pouvez flasher une image logicielle sur les montres compatibles avec une connexion de données USB (filaire). Par exemple, vous pouvez flasher une image d'usine ou une image OTA complète sur une Google Pixel Watch 3 ou une Google Pixel Watch 2.

Ouvrir l'application sur la montre

  1. Accédez à Run > Select Device (Exécuter > Sélectionner un appareil). Choisissez la montre connectée à votre ordinateur.
  2. Dans la barre d'outils d'Android Studio, cliquez sur Run (Exécuter) . L'émulateur démarre et ouvre votre application.
  3. Après quelques instants, le message "Hello…" (Bonjour…) s'affiche sur la montre.