Primera ejecución
1. Inicia el gateway
Sección titulada «1. Inicia el gateway»android-emu-webEl gateway escucha en 127.0.0.1, en el puerto 7300 de forma predeterminada. Para usar otro puerto, consulta Línea de comandos.
2. Deja que revise tu Android SDK
Sección titulada «2. Deja que revise tu Android SDK»Al iniciar, el gateway comprueba el Android SDK, cmdline-tools, emulator, platform-tools, la imagen de sistema system-images;android-34;google_apis;arm64-v8a y al menos un dispositivo virtual (AVD). Muestra cada elemento que falta junto con una solución, en este orden:
| Falta | Qué hace el gateway |
|---|---|
Android SDK o cmdline-tools |
Muestra la página de descarga de las herramientas de línea de comandos de Google y el directorio donde descomprimirlas. No las descarga por sí mismo. |
emulator, platform-tools, imagen de sistema |
Muestra el comando sdkmanager y el tamaño aproximado, y luego pregunta [y/N]. |
| Ningún AVD | Ofrece crear un dispositivo predeterminado llamado emu_web_default (perfil Pixel 5, 4096 MB de RAM), y luego pregunta [y/N]. |
La respuesta predeterminada es N. No se descarga ni se crea nada a menos que escribas y. Si respondes N, el gateway muestra los comandos para que los ejecutes tú mismo, y continúa iniciándose.
Las licencias del Android SDK deben aceptarse antes de que sdkmanager instale paquetes. sdkmanager --licenses las muestra en tu Terminal, y las aceptas tú mismo.
Por ejemplo, para instalar la imagen de sistema manualmente:
sdkmanager "system-images;android-34;google_apis;arm64-v8a"3. Abre la página
Sección titulada «3. Abre la página»El gateway crea un nuevo token aleatorio cada vez que se inicia, y abre tu navegador predeterminado en una dirección como esta:
https://droid.devpier.dev/app/#port=7300&token=<token>El puerto y el token van después de #, así que el navegador no los envía al servidor web. La página los guarda en el navegador y los quita de la barra de direcciones. Si tu navegador predeterminado no es Chrome ni Edge, copia la dirección desde Terminal en Chrome o Edge.
4. Permite el acceso a la red local
Sección titulada «4. Permite el acceso a la red local»La primera vez que la página se conecta al gateway en tu Mac, Chrome muestra un aviso de permiso que pregunta si droid.devpier.dev puede acceder a tu red local. Permítelo. Chrome recuerda la elección para el sitio.
Si lo rechazaste, consulta Solución de problemas.
5. Usa el emulador
Sección titulada «5. Usa el emulador»Si ya hay un emulador en ejecución con gRPC, la página muestra su pantalla.
De lo contrario, elige un dispositivo de la lista e inícialo. Consulta Dispositivos.
Haz clic en la pantalla para darle el foco del teclado. Luego:
- Haz clic para tocar; arrastra para deslizar.
- Escribe con el teclado de tu Mac. Consulta Teclado y entrada.
- Usa los botones Atrás, Inicio y Recientes que están sobre la pantalla.
Detener
Sección titulada «Detener»Presiona Ctrl+C en la Terminal donde se ejecuta el gateway. Los emuladores en ejecución siguen funcionando. La próxima vez que inicies el gateway, se vuelve a conectar a ellos.
La página local de respaldo
Sección titulada «La página local de respaldo»El gateway también sirve la misma página en http://127.0.0.1:7300/app/ (o en el puerto que elegiste). Úsala si la página pública no carga o no puede conectarse.