Premier lancement
1. Démarrer la passerelle
Section intitulée « 1. Démarrer la passerelle »android-emu-webLa passerelle écoute sur 127.0.0.1, port 7300 par défaut. Pour utiliser un autre port, voir Ligne de commande.
2. La laisser vérifier votre Android SDK
Section intitulée « 2. La laisser vérifier votre Android SDK »Au démarrage, la passerelle vérifie la présence de l’Android SDK, de cmdline-tools, emulator, platform-tools, de l’image système system-images;android-34;google_apis;arm64-v8a et d’au moins un appareil virtuel (AVD). Elle affiche chaque élément manquant avec une solution, dans cet ordre :
| Manquant | Ce que fait la passerelle |
|---|---|
Android SDK ou cmdline-tools |
Affiche la page de téléchargement des outils en ligne de commande de Google et le répertoire où les décompresser. Elle ne les télécharge pas elle-même. |
emulator, platform-tools, image système |
Affiche la commande sdkmanager et la taille approximative, puis demande [y/N]. |
| Aucun AVD | Propose de créer un appareil par défaut nommé emu_web_default (profil Pixel 5, 4096 MB de RAM), puis demande [y/N]. |
La réponse par défaut est N. Rien n’est téléchargé ni créé si vous ne tapez pas y. Si vous répondez N, la passerelle affiche les commandes pour que vous puissiez les exécuter vous-même, et poursuit son démarrage.
Les licences de l’Android SDK doivent être acceptées avant que sdkmanager installe des paquets. sdkmanager --licenses les affiche dans votre Terminal, et c’est vous qui les acceptez.
Par exemple, pour installer l’image système à la main :
sdkmanager "system-images;android-34;google_apis;arm64-v8a"3. Ouvrir la page
Section intitulée « 3. Ouvrir la page »La passerelle crée un nouveau jeton aléatoire à chaque démarrage, et ouvre votre navigateur par défaut à une adresse comme celle-ci :
https://droid.devpier.dev/app/#port=7300&token=<token>Le port et le jeton se trouvent après #, donc le navigateur ne les envoie pas au serveur web. La page les enregistre dans le navigateur et les retire de la barre d’adresse. Si votre navigateur par défaut n’est ni Chrome ni Edge, copiez l’adresse depuis Terminal dans Chrome ou Edge.
4. Autoriser l’accès au réseau local
Section intitulée « 4. Autoriser l’accès au réseau local »La première fois que la page se connecte à la passerelle sur votre Mac, Chrome affiche une demande d’autorisation pour savoir si droid.devpier.dev peut accéder à votre réseau local. Autorisez-la. Chrome mémorise ce choix pour le site.
Si vous avez refusé, voir Dépannage.
5. Utiliser l’émulateur
Section intitulée « 5. Utiliser l’émulateur »Si un émulateur avec gRPC est déjà en cours d’exécution, la page affiche son écran.
Sinon, choisissez un appareil dans la liste et démarrez-le. Voir Appareils.
Cliquez sur l’écran pour lui donner le focus clavier. Ensuite :
- Cliquez pour appuyer ; faites glisser pour balayer.
- Tapez sur le clavier de votre Mac. Voir Clavier et saisie.
- Utilisez les boutons Retour, Accueil et Récents au-dessus de l’écran.
Appuyez sur Ctrl+C dans le Terminal où tourne la passerelle. Les émulateurs en cours d’exécution continuent de tourner. Au prochain démarrage de la passerelle, elle s’y reconnecte.
La page de secours locale
Section intitulée « La page de secours locale »La passerelle sert aussi elle-même la même page à http://127.0.0.1:7300/app/ (ou sur le port que vous avez choisi). Utilisez-la si la page publique ne se charge pas ou n’arrive pas à se connecter.