Déboguer Wear OS via Wi-Fi

Wear OS est compatible avec le débogage sans fil, qui vous permet de déboguer votre application sur un réseau Wi-Fi.

Prérequis

Avant de commencer, vérifiez que vous disposez bien des éléments suivants :

  • Android Debug Bridge (ADB) : utilisez la version 30.0.0 ou ultérieure de adb.
  • Même réseau Wi-Fi : votre ordinateur de développement et la montre Wear OS doivent être connectés au même réseau Wi-Fi.

Activer le débogage sans fil

  1. Activez les options pour les développeurs sur votre montre.
  2. Sur la montre, ouvrez Paramètres, puis accédez à Options pour les développeurs.
  3. Activez le débogage ADB.
  4. Activez l'option Débogage sans fil.

    Dans la boîte de dialogue qui s'affiche, sélectionnez Autoriser ou Toujours autoriser sur ce réseau pour confirmer.

Associer votre ordinateur à la montre

Vous n'avez besoin d'associer votre ordinateur à la montre qu'une seule fois.

  1. Sur la montre, accédez à Paramètres > Options pour les développeurs > Débogage sans fil.
  2. Sélectionnez Associer un nouvel appareil.
  3. La montre affiche un code d'association Wi-Fi, une adresse IP et un port pour l'association. Notez ces valeurs.
  4. Sur votre ordinateur, ouvrez un terminal et exécutez la commande suivante, en remplaçant ip-address et pairing-port par les valeurs affichées sur la montre :

    adb pair ip-address:pairing-port
    
  5. Lorsque vous y êtes invité, saisissez le code d'association Wi-Fi affiché sur la montre. Si l'association réussit, un message semblable à celui-ci s'affiche :

    Successfully paired to ip-address:pairing-port
    

Se connecter à la montre

Une fois la montre et l'ordinateur associés, vous pouvez vous connecter à la montre. Vous devez vous reconnecter chaque fois que vous redémarrez le débogage sans fil ou que vous changez de réseau Wi-Fi.

  1. Sur la montre, accédez à Paramètres > Options pour les développeurs > Débogage sans fil.
  2. Recherchez l'adresse IP et le port de la connexion sous Débogage sans fil (et non sous "Associer un nouvel appareil").

  3. Sur votre ordinateur, exécutez la commande suivante :

    adb connect ip-address:connection-port
    
  4. Vérifiez la connexion en exécutant la commande suivante :

    adb devices
    

    Votre montre devrait s'afficher dans la liste des appareils connectés.

    Si cette commande renvoie plusieurs appareils, faites précéder vos commandes adb de l'adresse IP de l'appareil :

    adb -s ip-address:connection-port
    

Dépannage

Si vous ne parvenez pas à vous connecter, procédez comme suit :

  • Vérifiez la connexion réseau : assurez-vous que les deux appareils sont connectés au même réseau Wi-Fi et que le réseau autorise le trafic peer-to-peer.
  • Redémarrez ADB : sur votre ordinateur, exécutez adb kill-server, puis adb start-server. Réessayez ensuite de vous connecter.
  • Activer/Désactiver le débogage : désactivez, puis réactivez l'option Débogage sans fil sur la montre.