Descripción general de la CLI de Android

La CLI de Android es una interfaz de línea de comandos que te permite compilar para Android de manera más eficiente con cualquier herramienta que elijas. Estandariza las competencias de desarrollo principales para los flujos de trabajo que priorizan los agentes y proporciona un punto de entrada a las herramientas, las habilidades y el conocimiento oficiales que necesitas para desarrollar de manera más eficaz. También puede optimizar la CI, el mantenimiento y cualquier otra automatización basada en secuencias de comandos para la naturaleza cada vez más distribuida del desarrollo de Android.

Por ejemplo, un agente o una secuencia de comandos pueden usar la CLI para realizar tareas como las siguientes:

  • Automatiza la configuración del entorno y del SDK de Android
  • Crear nuevos proyectos a partir de plantillas
  • Administra dispositivos virtuales, instala APKs y examina pantallas de dispositivos en vivo y jerarquías de IU directamente desde tu terminal
  • Conéctate a instancias de Android Studio en ejecución para realizar análisis semánticos de código, renderizar vistas previas de Compose y buscar versiones de dependencias.
  • Prueba tu app con la Exploración

La CLI de Android también les brinda a tus agentes acceso a las habilidades de Android y a la base de conocimiento de Android especializada para garantizar que tus proyectos apliquen los patrones y las prácticas recomendadas de Android.

Para obtener una descripción completa de los comandos y las opciones de la CLI de Android, consulta la referencia de los comandos de la CLI de Android.

Instala la CLI de Android

Para instalar la CLI de Android, sigue estos pasos:

  1. Descarga la CLI de Android.

  2. Para asegurarte de usar la versión más reciente, actualiza la CLI de Android:

    android update

Para verificar si la CLI de Android ya está instalada en tu máquina, ejecuta which android o command -v android. Si devuelve una ruta de acceso, significa que está instalada.

Configuración para agentes

Para ayudar a los agentes a comprender y usar la CLI de Android, ejecuta android init para instalar la habilidad de android-cli.

Datos recopilados

La CLI de Android recopila datos sobre el uso básico de la herramienta. Estos son los datos que recopilamos:

  • Invocaciones del comando android y los subcomandos, por ejemplo, android run y android create.
  • Nombres de los argumentos o las opciones no posicionales que se usaron, por ejemplo, --sdk o --version.
  • Argumentos posicionales y valores de marcas que se asignan a un conjunto fijo y predefinido de opciones del sistema administradas por la CLI de Android. Por ejemplo, recopilamos nombres de plantillas de emulador, como medium_phone y large_desktop, y nombres de agentes, como GEMINI, CLAUDE o CODEX.
  • Registros de seguimiento de pila y mensajes de excepción, en los que la información de identificación se anonimiza antes de la recopilación para garantizar la privacidad.

A continuación, se incluyen algunos ejemplos de datos que no recopilamos:

  • No recopilamos las respuestas de la CLI cuando se ejecuta un comando.
  • No recopilamos entradas creadas por el usuario ni identificadores externos que se pasan a la CLI, como coordenadas específicas de Maven, rutas de acceso a archivos locales o nombres de proyectos personalizados. Por ejemplo, si se ejecuta el comando android create --name=com.company.internal.app, registramos que android create se ejecutó con el argumento --name, pero no almacenamos el valor com.company.internal.app.

Para inhabilitar la recopilación de datos, usa la marca --no-metrics cuando ejecutes un comando con la CLI de Android.

Comentarios y problemas

Si tienes algún problema o quieres enviar comentarios, informa un error.

Problemas conocidos

  • Actualmente, el comando android emulator para Windows está inhabilitado.
  • Por el momento, no se admite la descarga de la CLI de Android desde Windows PowerShell.

Configura la CLI de Android

Crea un archivo .androidrc para aplicar automáticamente marcas y opciones cada vez que invoques la CLI de Android. Guarda el archivo en la siguiente ubicación, según tu sistema operativo:

  • macOS y Linux: ~/.androidrc
  • Windows: %USERPROFILE%\.androidrc

Agrega las marcas que deseas aplicar automáticamente al archivo, una por línea.

Por ejemplo, para que la CLI de Android use un SDK de Android específico de forma predeterminada cada vez, agrega la marca --sdk a tu archivo:

--sdk=<path-to-sdk>

Opciones globales

Estas son marcas opcionales que puedes usar con otros comandos de la CLI de Android.

-h, --help

Uso: android <command> -h

Descripción: Muestra el manual de ayuda de la herramienta o el comando específico en cuestión.

Ejemplos:

  • android -h
  • android create -h

--sdk

Uso: android --sdk=<path-to-sdk> <command>

Descripción: Es la ruta de acceso al SDK de Android que deseas usar para el comando que sigue. Puedes usar el parámetro de configuración --sdk para anular temporalmente el SDK de Android predeterminado en lugar de cambiar tus variables de entorno globales cada vez que quieras cambiar. Para verificar qué SDK de Android usas de forma predeterminada, ejecuta android info.

Ejemplo: android --sdk=<path/to/sdk> sdk list

-v, --verbose

Uso: android -v <command>

Descripción: Habilita la salida detallada. Especifica varias opciones de -v para aumentar la verbosidad (por ejemplo, -v, -vv o -vvv).

-V, --version

Uso: android -V

Descripción: Imprime la información de la versión y sale.

Comandos

Para obtener una descripción completa de los comandos y las opciones de la CLI de Android, consulta la referencia de los comandos de la CLI de Android.