Déboguer une application Wear OS

Pour déboguer votre application Wear OS sur une montre physique, connectez votre ordinateur de développement à la montre via le Wi-Fi ou le Bluetooth. Si votre montre dispose d'un port USB, connectez-la via un câble USB.

Vous pouvez également tester les workflows qui couvrent plusieurs appareils, tels qu'une montre et un téléphone, si votre application nécessite cette compatibilité. Pour découvrir comment configurer une connexion pour les tests, consultez la section Connecter une montre à un téléphone.

Remarque : Si vous ne possédez pas de montre physique, vous pouvez également tester et exécuter votre application sur un émulateur dans Android Studio.

Installer la dernière version de Wear OS

Pour vous assurer que votre application se comporte comme prévu avec la dernière version du logiciel, vérifiez que votre appareil de test exécute la version la plus récente de Wear OS compatible avec votre appareil.

Pour rechercher une mise à jour du système sur votre appareil de test, procédez comme suit :

  1. Connectez l'appareil à un réseau Wi-Fi.
  2. Commencez à charger l'appareil.
  3. Attendez que la batterie de l'appareil soit chargée à 50 % ou plus.
  4. Sur votre appareil de test, accédez à Paramètres > Système > Mises à jour du système.

    Si une mise à jour du système est disponible, elle sera téléchargée et installée sur votre appareil de test.

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. Par exemple, vous pouvez flasher une image d'usine ou une image OTA complète sur la Google Pixel Watch 2.

Activer les options pour les développeurs sur votre montre

Avant de pouvoir effectuer un débogage sur votre montre, activez les options pour les développeurs. Cette action ne doit être effectuée qu'une seule fois. Les options pour les développeurs restent activées jusqu'à ce que vous les désactiviez. Pour activer les options pour les développeurs, procédez comme suit :

  1. Ouvrez les paramètres de la montre.
  2. Appuyez sur System > About > Versions (Système > À propos > Versions).
  3. Appuyez sept fois sur le numéro de version.
  4. Un message s'affiche pour confirmer que vous êtes désormais un développeur.

Déboguer via Wi-Fi

Avant de commencer, activez les options pour les développeurs sur la montre comme décrit plus haut.

Connecter la montre à un réseau Wi-Fi

  1. Ouvrez les paramètres de la montre.
  2. Appuyez sur Connectivité > Wi-Fi.
  3. Sélectionnez un réseau et saisissez son mot de passe si nécessaire.

    Remarque : La montre et votre ordinateur de développement doivent être connectés au même réseau. Tous les points d'accès ne sont pas adaptés. Vous devrez peut-être utiliser un point d'accès dont le pare-feu est correctement configuré pour prendre en charge adb.

Activer le débogage Wi-Fi

  1. Ouvrez les paramètres de la montre.
  2. Appuyez sur Developer options > Debug over Wi-Fi (Options pour les développeurs > Déboguer via Wi-Fi).
  3. Après quelques instants, l'adresse IP de la montre s'affiche, par exemple 192.168.1.100. Vous aurez besoin de ces informations à la prochaine étape. Prenez-en bonne note.

Associer le débogueur à la montre

  1. Sur votre appareil Wear OS, recherchez les options de débogage sans fil dans les paramètres système. Sélectionnez Associer un nouvel appareil.
  2. Notez le code d'association Wi-Fi, ainsi que l'adresse IP et le port.
  3. Dans une fenêtre de terminal de votre ordinateur de développement, saisissez la commande suivante :
    adb pair IP_ADDRESS:PORT
    
  4. Lorsque qu'il vous est demandé, saisissez le code d'association Wi-Fi de l'étape 2. Le terminal indique si l'association a été réalisée avec succès. À titre d'exemple :
    Enter pairing code: 123456
    Successfully paired to 192.168.1.100:5555
    
Une fois l'association effectuée, l'ordinateur hôte apparaît dans la liste des Appareils associés sur l'écran Débogage sans fil de votre appareil Wear OS.

Connecter le débogueur à la montre

  1. Connectez votre montre et votre ordinateur de développement au même réseau.
  2. Connectez le débogueur à la montre en utilisant l'adresse IP de celle-ci et un numéro de port. Par exemple, si l'adresse IP est 192.168.1.100 et le numéro de port est 5555, la commande adb connect et sa réponse se présentent comme suit :

    adb connect 192.168.1.100:5555
    connected to 192.168.1.100:5555
    

La montre est maintenant connectée au débogueur et vous pouvez commencer le débogage. Envoyez des commandes adb à la montre à l'aide de l'indicateur -s, en spécifiant son adresse IP et son numéro de port :

adb -s 192.168.1.100:5555 <command>

Si vous n'utilisez pas l'émulateur et qu'un seul appareil est connecté pour le débogage, il n'est pas nécessaire de préciser l'adresse :

adb <command>

Déboguer via le Bluetooth

Remarque : Le débogage Bluetooth ne fonctionne que pour les montres associées à Android qui exécutent Wear OS 2.

Avant de commencer, associez la montre et le téléphone, puis activez les options pour les développeurs sur la montre comme décrit plus haut. Vérifiez que les options pour les développeurs sont activées sur le téléphone en ouvrant le menu Paramètres du téléphone et en recherchant Options pour les développeurs. Si nécessaire, activez les options pour les développeurs sur le téléphone.

Activer le débogage USB sur le téléphone

  1. Ouvrez le menu Paramètres du téléphone.
  2. Sélectionnez Options pour les développeurs et activez Débogage USB.

Activer le débogage ADB ou Bluetooth sur la montre

  1. Ouvrez le menu Paramètres de la montre.
  2. Faites défiler la page jusqu'à Options pour les développeurs.
  3. Vérifiez que le débogage ADB est activé.
  4. Activez l'option Déboguer via le Bluetooth.

Activer le débogage Bluetooth sur le téléphone

  1. Sur le téléphone, ouvrez l'application associée Wear OS.
  2. Faites défiler l'écran jusqu'à Paramètres avancés, puis appuyez dessus pour afficher les options correspondantes.
  3. Activez l'option Débogage via le Bluetooth. Le message d'état suivant s'affiche sous l'option :
    Host: disconnected
    Target: connected
    

À ce stade, l'ordinateur de développement (l'hôte) ne communique pas avec la montre (la cible). Vous devez terminer l'association.

Remarque : Vous ne pouvez effectuer le débogage qu'avec un seul appareil à la fois. Si vous avez associé plusieurs montres, le débogage via le Bluetooth ne sera activé qu'avec l'appareil sélectionné sur l'écran principal.

Connecter le débogueur à la montre

Lors de la dernière étape, vous utiliserez tout : le débogueur, le téléphone et la montre.

  1. Connectez le téléphone à votre ordinateur de développement à l'aide d'un câble USB.
  2. Exécutez les deux commandes suivantes dans le débogueur :
    adb forward tcp:4444 localabstract:/adb-hub
    adb connect 127.0.0.1:4444
    

    Remarque : Vous devez utiliser l'adresse IP 127.0.0.1. Servez-vous de n'importe quel port disponible sur votre ordinateur de développement et utilisez le même port dans les deux commandes. Dans cet exemple, le port est 4444.

  3. Une fois la commande de connexion saisie, la montre vous demande de confirmer que vous autorisez le débogage ADB.
  4. Sur le téléphone, consultez l'affichage de l'état dans l'application associée Wear OS pour vérifier qu'il contient les informations suivantes :
    Host: connected
    Target: connected
    
  5. La montre est à présent connectée au débogueur. Vous pouvez donc commencer le débogage.

Lorsque vous déboguez une montre via le Bluetooth, adb utilise toujours l'adresse IP 127.0.0.1 et le port que vous avez attribué. Dans cet exemple, le port est 4444. Toutes les commandes adb utilisent le format suivant :

adb -s 127.0.0.1:4444 <command> 

Si vous n'utilisez pas l'émulateur et qu'un seul appareil est connecté pour le débogage, il n'est pas nécessaire de préciser l'adresse :

adb <command>

Utiliser l'enregistrement d'écran pour Wear OS

Si vous développez sur macOS, vous pouvez utiliser un projet GitHub, Android Tool for Mac, pour enregistrer une vidéo à partir de votre appareil Wear OS.

Vous pouvez également enregistrer une vidéo à partir de votre appareil Wear OS en procédant comme suit :

  1. Enregistrez des images brutes sur la montre :
    adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw
  2. Copiez le fichier brut sur votre ordinateur de développement :
    adb pull /sdcard/video.raw video.raw
  3. Utilisez ffmpeg pour convertir le fichier brut au format MP4 :
    ffmpeg -f rawvideo -vcodec rawvideo -s 400x400 -pix_fmt rgb24 -r 10 -i video.raw -an -c:v libx264 -pix_fmt yuv420p video.mp4

    Remarque : Consultez le site Web FFmpeg pour obtenir les instructions de téléchargement et d'installation.