Dispositivos

Aquí, un dispositivo es un Android Virtual Device (AVD) en tu Mac. La página muestra un dispositivo a la vez.

La lista de dispositivos

La lista de la izquierda muestra cada AVD que informa emulator -list-avds. Para cada uno muestra:

• el nombre;
• la resolución de pantalla;
• la versión de Android;
• el estado: detenido, arrancando (con los segundos transcurridos), en ejecución, o en ejecución pero sin posibilidad de tomar el control;
• un botón para iniciar o detener.

La resolución, la RAM y la versión de Android provienen del config.ini de cada AVD en ~/.android/avd/<name>.avd/. Si defines ANDROID_AVD_HOME, el gateway lee ese directorio en su lugar. Si falta un campo en config.ini, se deja en blanco.

Iniciar un dispositivo

Haz clic en iniciar junto a un dispositivo. El gateway ejecuta:

emulator -avd <name> -no-window -grpc <port> -no-boot-anim -gpu host

• -no-window significa que no se abre una ventana separada del emulador. La pantalla aparece solo en la página.
• El puerto gRPC es el primer puerto par libre desde 8554 hacia arriba.
• El dispositivo se considera arrancado cuando adb -s emulator-<serial> shell getprop sys.boot_completed devuelve 1. Hasta entonces, la página muestra el progreso.
• Si el dispositivo no ha arrancado después de 180 segundos, el inicio falla y el gateway termina el proceso del emulador.

Hacer clic de nuevo en iniciar mientras un dispositivo está arrancando no inicia una segunda copia. Si cierras la página durante el arranque y la vuelves a abrir, el progreso continúa.

Detener un dispositivo

Haz clic en detener. El gateway ejecuta adb -s emulator-<serial> emu kill.

Emuladores que ya están en ejecución

El gateway encuentra los emuladores en ejecución a través de los archivos que el emulador escribe en ~/Library/Caches/TemporaryItems/avd/running/. Si un emulador se está ejecutando con gRPC habilitado, por ejemplo uno que iniciaste con -grpc <port>, el gateway se conecta a él en lugar de iniciar otra copia.

Un emulador que se ejecuta sin gRPC se marca como “en ejecución pero sin posibilidad de tomar el control”. El gateway necesita gRPC para leer la pantalla y enviar entradas. Detén ese emulador e inícialo desde la página.

Cuando el gateway se detiene

Detener el gateway no detiene los emuladores. Cuando vuelves a iniciar el gateway, se conecta a ellos de nuevo.

Crear un dispositivo

Si no tienes ningún AVD, en la primera ejecución el gateway ofrece crear emu_web_default: perfil Pixel 5, imagen de sistema arm64 para Android 14 (API 34), 4096 MB de RAM, 1080×2340. Consulta Primera ejecución. También puedes crear dispositivos con avdmanager o con Android Studio; la lista los detecta.