Solución de problemas

Chrome bloqueó el acceso a la red local

La página en droid.devpier.dev se conecta al gateway en tu propia Mac. Chrome pide permiso la primera vez. Si lo rechazaste, la página no puede conectarse y, tras algunos intentos fallidos, te indica que Chrome bloqueó el acceso a tu Mac.

Para permitirlo de nuevo:

1. Abre en Chrome Configuración → Privacidad y seguridad → Configuración de sitios.
2. Busca droid.devpier.dev y permite el acceso a la red local.
3. Vuelve a cargar la página.

Si aún no puedes conectarte, usa la página local de respaldo.

El puerto ya está en uso

El gateway escucha en el puerto 7300 de forma predeterminada. Si otro programa ya usa ese puerto, el gateway no puede iniciarse en él. Encuentra el programa:

lsof -nP -iTCP:7300 -sTCP:LISTEN

Detén ese programa o inicia el gateway en otro puerto:

android-emu-web --port 7301

El gateway incluye el nuevo puerto en la dirección que abre, así que la página se conecta al puerto correcto.

No se encontró ningún emulador

Si la página indica que no se encontró ningún emulador en ejecución:

• Comprueba que haya un emulador en ejecución: adb devices debería listar emulator-5554 o algo similar.
• Comprueba que se haya iniciado con gRPC habilitado (-grpc <port>). El gateway no puede leer la pantalla de un emulador sin gRPC.

También puedes iniciar un dispositivo desde la lista de la página. Consulta Dispositivos.

El gateway sigue ejecutándose cuando no encuentra ningún emulador, y muestra el motivo en Terminal.

Si el gateway informa que falta el Android SDK, emulator, platform-tools o la imagen de sistema, sigue la solución que muestra. Consulta Primera ejecución.

Falta “sdkmanager”

Un SDK instalado por Android Studio puede no incluir cmdline-tools, que proporciona sdkmanager y avdmanager. El gateway no lo descarga. Descarga las herramientas de línea de comandos de Google desde developer.android.com y descomprímelas de modo que exista esta ruta:

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

El token caducó

El gateway genera un token nuevo cada vez que se inicia. Si reinicias el gateway, una página que todavía tiene el token anterior indica que el token ya no es válido y deja de reintentar. Abre el nuevo enlace que mostró el gateway, o vuelve a ejecutar el gateway.

La página indica que el gateway o la página están desactualizados

• Gateway desactualizado: ejecuta el comando de actualización que muestra la página. Es el mismo que el comando de instalación.
• Página desactualizada: fuerza la recarga de la página con Cmd+Shift+R.

Navegador incorrecto

La página funciona solo en Chrome y Edge. En otros navegadores te pide que cambies de navegador y no intenta conectarse. Consulta Compatibilidad con navegadores.

Usa la página local de respaldo

El gateway sirve la misma página en http://127.0.0.1:7300/app/ (o en el puerto que elegiste). Úsala cuando la página pública no carga o se rechazó el acceso a la red local.

La pantalla deja de actualizarse

Si el emulador se cierra o se reinicia, la página muestra que está desconectada. El gateway sigue ejecutándose. Cuando el emulador vuelve, la página se reconecta y la pantalla regresa.