Notas de la versión de la CLI de Android

Android CLI es la interfaz principal para el desarrollo de Android desde la terminal, diseñada para potenciar tus flujos de trabajo de desarrollo con el agente y las herramientas que elijas.

En esta página, se enumeran las funciones nuevas de cada versión de la CLI de Android. Para descargar la CLI de Android, ve a la página de descarga. Para obtener más información, consulta la descripción general de la CLI de Android.

Versión 1.1.16919734 (noviembre de 2026)

• Las instalaciones delta reutilizan los archivos reposicionados: android install y android run ya no vuelven a enviar archivos sin cambios cuya posición en el APK haya cambiado. Para inhabilitarla, pasa --use-delta-install-instructions=COPY,DATA.
• Seguimiento de Compose: android profiler systemtrace puede registrar lo que hace Jetpack Compose en una app. Pasa --enable=compose.composition para registrar un segmento de cada función de componibilidad que se ejecuta o --enable=compose.recomposition para registrar también las lecturas y escrituras de estado que causan recomposiciones. La app necesita androidx.compose.runtime:runtime-tracing 1.13 o una versión posterior. El registro se guarda como un archivo ZIP que abres en el generador de perfiles de Android Studio.
• Volcados de montón de Perfetto: Pasa --type=perfetto a android profiler heapdump capture para registrar el volcado de montón como un registro de Perfetto. Tiene los objetos y las referencias entre ellos, pero no sus valores, por lo que es más pequeño que un archivo .hprof. Requiere Android 12 (nivel de API 31) o una versión posterior, y una app que se pueda perfilar o depurar.
• Formato del tamaño del DEX de la biblioteca en el JSON de análisis: En el resultado de android analyze --format=json para los artefactos de la biblioteca (AAR y JAR), los campos dexSizeBytes en d8CompileResult y r8CompileResult ahora son números enteros de 64 bits serializados como cadenas en lugar de números.
• Resultados de entrada como JSON: Los subcomandos android input imprimen su resultado como un objeto JSON con una lista results en la salida estándar, en el mismo formato para cada subcomando. Las fallas, como la falta de elementos coincidentes o las coincidencias múltiples, se informan en el campo status de cada resultado, en lugar de como texto en el error estándar.
• Códigos de salida del emulador: android emulator create, start, stop y remove ahora se cierran con un código distinto de cero en caso de falla y muestran errores en el error estándar.

Versión 1.1.16717390 (octubre de 2026)

• Señales de fallas de campo: Usa el nuevo comando android signals para investigar cómo se comporta tu app en el campo con Firebase Crashlytics. Después de acceder con android auth login, busca tus proyectos y apps con android signals context y, luego, enumera, filtra y desglosa las fallas, los errores de ANR y los problemas no graves con android signals crashes list, facets, describe y samples.
• Volcados de montón de campo: Usa android signals heaps para enumerar, describir y descargar los volcados de montón que Crashlytics recopila sobre las fallas por falta de memoria y las finalizaciones del limitador de memoria, junto con los metadatos, las claves personalizadas y los registros de la sesión que los produjo.
• Generación de perfiles de apps: Usa el nuevo comando android profiler para registrar seguimientos del sistema con android profiler systemtrace y capturar volcados de montón de JVM con android profiler heapdump capture en un dispositivo conectado o emulador. Administra las sesiones de generación de perfiles con android profiler session list, status y terminate.
• Análisis de artefactos: Usa el nuevo comando android analyze para inspeccionar uno o más APK, AAB, AAR y JAR, y obtener informes de los detalles de sus paquetes, tamaños de DEX, métricas de reducción y optimización de R8, y advertencias sobre las reglas de conservación de bibliotecas y la optimización baja. Pasa --format=json o --format=textproto para obtener un resultado legible por máquinas.
• Vistas previas de Compose: Usa el nuevo comando android preview list para encontrar las funciones @Preview de Jetpack Compose en un destino y android preview render --fqn <name> para renderizarlas en imágenes PNG y archivos JSON de árbol de componentes en tu máquina, sin Android Studio. Pasa --output para elegir dónde se escriben los archivos.
• Referencias de compilación en run e install: android run y android install aceptan una referencia de compilación posicional para compilar e implementar un destino específico. Los destinos de Gradle sin una variante, como :app, ahora se establecen de forma predeterminada en la variante debug.
• Ventana de duplicación de dispositivos: Usa el nuevo comando android device hub para abrir una ventana de escritorio para la duplicación de pantalla en tiempo real y el control interactivo de los dispositivos Android físicos conectados (incluidos los dispositivos remotos conectados a través de android device remote connect) y los emuladores de Android.

Versión 1.0.16625370 (octubre de 2026)

• Interacción con la IU: Usa el nuevo comando android input para presionar, desplazarte, deslizar, escribir texto y presionar teclas en un dispositivo conectado o emulador. Orienta los elementos de la IU con selectores como text=Submit o id=email,class=EditText, y combínalos con android layout para encontrar los elementos con los que se interactuará.

Versión 1.0.16500706 (octubre de 2026)

• Conectar en la reserva: android device remote create ahora conecta la nueva reserva a adb automáticamente. Pasa --connect=false para crear solo la reserva y conectarte más tarde con android device remote connect.

Versión 1.0.16457483 (septiembre de 2026)

• Accede a los servicios de Google: Con la CLI de Android de android auth login, accede a tu Cuenta de Google para que pueda llamar a los servicios de Google que requieren autenticación.
• Catálogo de dispositivos remotos: Busca los proyectos de Google Cloud desde los que puedes transmitir dispositivos con android device remote projects y explora los dispositivos físicos disponibles con android device remote models.
• Reservas de dispositivos remotos: Reserva un dispositivo físico remoto con android device remote create y, luego, administra tus reservas con list, extend --duration <minutes> y remove.
• Conéctate a dispositivos remotos: Usa android device remote connect para conectar un dispositivo reservado a adb a través de una conexión en segundo plano, de modo que funcione con android run, android install y otros comandos de dispositivo como un dispositivo local. Usa android device remote disconnect para desconectarlo.

Versión 1.0.16406183 (septiembre de 2026)

• Inicio más rápido: La Android CLI se inicia aproximadamente el doble de rápido porque la biblioteca de descarga nativa se carga solo cuando se usa y ya no se desempaqueta en un directorio temporal en cada invocación.
• Códigos de salida fijos: Los comandos ahora devuelven un código de salida distinto de cero cuando fallan, incluidos create, run, install, describe, layout, docs, info, skills y update, lo que hace que las secuencias de comandos y la CI sean más confiables.
• Ajuste de anotaciones en pantalla: android screen --annotate expone parámetros de ajuste para su detección de atributos, incluidos los umbrales de detección de bordes, el filtrado de formas y la estrategia de agrupamiento en clústeres, que se documentan en --help.
• Opciones de creación de proyectos: android create admite las marcas --application-id y --namespace, y los nombres de opciones con guiones, como --min-sdk. La plantilla de Compose ahora usa un conjunto de orígenes src/main/kotlin y un tema de Material 3.
• Emulador sin interfaz gráfica: Inicia un emulador sin una ventana con android emulator start --headless.
• Confiabilidad del SDK: Los comandos android sdk toman un bloqueo entre procesos para que las invocaciones simultáneas no entren en conflicto, verifican la ruta de acceso y la versión de los paquetes instalados, actualizan los archivos en formato XML heredados solo cuando es necesario y, además, informan errores más claros.
• Resultado de la vista previa de Compose: android studio render-compose-preview imprime la ruta de acceso absoluta de la imagen renderizada y confirma la escritura, incluso cuando se usa --print-semantics.
• Compatibilidad con niveles de API más antiguos: Se corrigieron las fallas de interacción con el dispositivo, como android layout, en dispositivos que ejecutan el nivel de API 32 y versiones anteriores.

Versión 1.0.16261425 (septiembre de 2026)

• Correcciones de diseño: Se corrigió un problema por el que el comando de diseño no funcionaba en algunas situaciones. Para volver temporalmente al comportamiento de diseño anterior, export ANDROID_CLI_LAYOUT_V1=1.

Versión 1.0.16251017 (septiembre de 2026)

• Volcado de diseño: android layout ahora admite la marca --no-idle para recuperar el diseño sin esperar el estado inactivo. android layout también admite la marca --full para devolver todo el árbol de diseño sin filtrar; de forma predeterminada, layout solo devuelve elementos interactivos.
• Finalización de shell: Genera e instala secuencias de comandos de autocompletado de shell para Bash y Zsh con el nuevo comando android completion.
• Actualiza las habilidades: Mantén las habilidades actualizadas con el nuevo comando android skills update, y, además, instala o quita varias habilidades en una sola invocación (por ejemplo, android skills install <skill1> <skill2>).
• Enumera las habilidades por agente: android skills list ahora se establece de forma predeterminada en la visualización detallada, incluidas las descripciones de las habilidades y los agentes en los que se instala la habilidad. android skills list también admite la marca --agent <agent> para enumerar todas las habilidades instaladas para un agente.
• Rendimiento de la instalación delta: Se aceleró la aplicación de parches de APK incrementales en android install con llamadas al sistema del kernel sin copia.
• Detección de bordes de pantalla: Se mejoró la detección de funciones y bordes en android screen con algoritmos de detección de bordes de Canny.

Versión 1.0.15985488 (julio de 2026)

• Comando de instalación dedicado: Instala APKs con el comando independiente android install, que incluye el envío incremental de APKs, lo que hace que las instalaciones incrementales sean mucho más rápidas que con adb.
• Ejecuta instalaciones incrementales: De manera similar, usa la nueva marca --use-delta-install en android run para realizar implementaciones de APK incrementales más rápidas en los dispositivos.
• Administración de SDK multiplataforma: Orienta plataformas que no sean de host con la nueva marca --platform <os_arch> en los comandos android sdk (install, update y materialize) para inspeccionar, resolver e instalar componentes en arquitecturas de SO y CPU.
• Mejoras en la CLI de Skills: Se expandieron los subcomandos de android skills (add, remove, list y find) con documentación de --help, comentarios claros cuando faltan habilidades y una etapa de descarga atómica más segura con reversión automática.

Versión 1.0.15857036 (julio de 2026)

• Compatibilidad con más habilidades de agentes: Instala habilidades en decenas de entornos de agentes (incluidos Claude Code, Cursor, Cline, OpenHands, Windsurf, Zed y Devin) con android skills install.
• Descargador nativo con compatibilidad con proxy: Descarga recursos de red de forma confiable con un descargador HTTP nativo con compatibilidad lista para usar con proxies corporativos.
• Administración de paquetes de SDK: Administra paquetes de SDK con la eliminación de varios paquetes en android sdk remove y la resolución basada en SHA en android sdk resolve.
• Mejoras en las pantallas y las descripciones: Consulta los errores de compilación de Gradle directamente en la salida estándar en android describe y segmenta dispositivos específicos con la marca --device en android screen.
• Usabilidad de la CLI y generación de informes de errores: Mensajes de error más claros cuando se ingresan comandos desconocidos o destinos de creación de proyectos no válidos, comandos android emulator que no distinguen mayúsculas de minúsculas.

Versión 1.0.15498356 (mayo de 2026)

• Carga dinámica de plantillas de SDK: Las plantillas de proyectos para android create ahora se descargan de forma dinámica desde el paquete del SDK de Android en lugar de agruparse en el objeto binario de la CLI, lo que garantiza que los proyectos nuevos siempre usen las plantillas más recientes.
• Compatibilidad con licencias del SDK: Las licencias del SDK aceptadas que guarda android sdk ahora coinciden con el formato de archivo que esperan las herramientas del SDK de Android y los complementos de Gradle más antiguos.
• Compatibilidad con symlinks: Se agregó compatibilidad con vínculos simbólicos en los comandos de la CLI y las operaciones de archivos.
• Extracción binaria atómica: Evita las condiciones de carrera de extracción durante las invocaciones simultáneas de la CLI de varios procesos desempaquetando los objetos binarios en un directorio temporal antes de moverlos de forma atómica a su lugar.
• Estabilidad de Windows: Se mejoró la compatibilidad y el rendimiento de Windows en Windows 11, junto con correcciones para la resolución de la ruta de acceso del directorio principal.

Versión 1.0.15433482 (mayo de 2026)

• Integración en Antigravity: La Android CLI y las habilidades ahora están integradas oficialmente en Google Antigravity 2.0 como un paquete opcional de recursos para optimizar el desarrollo agéntico.
• Comandos de Android Studio: Usa el nuevo comando android studio para permitir que tus agentes aprovechen las capacidades contextuales y profundas de Android Studio, incluidos el análisis de código, las búsquedas semánticas y la renderización de Compose.
• Compatibilidad con recorridos: Valida las experiencias del usuario fundamentales con recorridos, que son descripciones en lenguaje natural de los flujos de usuarios que tus agentes pueden ejecutar desde la terminal o en CI/CD.
• Nuevas habilidades de Android: Accede a la nueva biblioteca de habilidades de Android, que incluye habilidades para la migración de CameraX, la IU adaptable, las AppFunctions y los estilos de Compose.
• Más opciones de instalación: Instala y actualiza la Android CLI con administradores de paquetes populares, como apt-get, winget y homebrew. Para obtener más detalles, consulta las opciones de descarga.

Versión 0.7 (abril de 2026)

¡Primera versión!