Aller au contenu

Dépannage

La page sur droid.devpier.dev se connecte à la passerelle sur votre propre Mac. Chrome demande l’autorisation la première fois. Si vous l’avez refusée, la page ne peut pas se connecter et, après quelques tentatives échouées, elle vous indique que Chrome a bloqué l’accès à votre Mac.

Pour l’autoriser à nouveau :

  1. Ouvrez dans Chrome Paramètres → Confidentialité et sécurité → Paramètres des sites.
  2. Trouvez droid.devpier.dev et autorisez l’accès au réseau local.
  3. Rechargez la page.

Si vous ne parvenez toujours pas à vous connecter, utilisez la page de secours locale.

La passerelle écoute par défaut sur le port 7300. Si un autre programme utilise déjà ce port, la passerelle ne peut pas démarrer dessus. Trouvez ce programme :

Fenêtre de terminal
lsof -nP -iTCP:7300 -sTCP:LISTEN

Arrêtez ce programme, ou démarrez la passerelle sur un autre port :

Fenêtre de terminal
android-emu-web --port 7301

La passerelle met le nouveau port dans l’adresse qu’elle ouvre, donc la page se connecte au bon port.

Si la page indique qu’aucun émulateur en cours d’exécution n’a été trouvé :

  • Vérifiez qu’un émulateur tourne : adb devices devrait lister emulator-5554 ou un nom similaire.
  • Vérifiez qu’il a été démarré avec gRPC activé (-grpc <port>). La passerelle ne peut pas lire l’écran d’un émulateur sans gRPC.

Vous pouvez aussi démarrer un appareil depuis la liste dans la page. Voir Appareils.

La passerelle continue de tourner quand aucun émulateur n’est trouvé, et affiche la raison dans Terminal.

Si la passerelle signale que l’Android SDK, emulator, platform-tools ou l’image système sont manquants, suivez la solution qu’elle affiche. Voir Premier lancement.

Un SDK installé par Android Studio peut ne pas inclure cmdline-tools, qui fournit sdkmanager et avdmanager. La passerelle ne le télécharge pas. Téléchargez les outils en ligne de commande de Google sur developer.android.com et décompressez-les de sorte que ce chemin existe :

<your SDK>/cmdline-tools/latest/bin/sdkmanager

La passerelle crée un nouveau jeton à chaque démarrage. Si vous redémarrez la passerelle, une page qui a encore l’ancien jeton indique que le jeton n’est plus valide et arrête de réessayer. Ouvrez le nouveau lien affiché par la passerelle, ou relancez la passerelle.

La page indique que la passerelle ou la page n’est plus à jour

Section intitulée « La page indique que la passerelle ou la page n’est plus à jour »
  • Passerelle pas à jour : exécutez la commande de mise à niveau affichée par la page. C’est la même que la commande d’installation.
  • Page pas à jour : forcez le rechargement de la page avec Cmd+Shift+R.

La page ne fonctionne que dans Chrome et Edge. Dans les autres navigateurs, elle vous demande de changer de navigateur et ne tente pas de se connecter. Voir Navigateurs pris en charge.

La passerelle sert la même page à http://127.0.0.1:7300/app/ (ou sur le port que vous avez choisi). Utilisez-la lorsque la page publique ne se charge pas ou que l’accès au réseau local a été refusé.

Si l’émulateur se ferme ou redémarre, la page indique qu’elle est déconnectée. La passerelle continue de tourner. Quand l’émulateur revient, la page se reconnecte et l’écran réapparaît.