Descripción general de la CLI de Android

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

La Android CLI abarca todo el ciclo de vida del desarrollo, desde la creación de un proyecto y su prueba en un dispositivo hasta la generación de perfiles de su rendimiento y la investigación de su comportamiento en el campo. Por ejemplo, un agente o una secuencia de comandos pueden usar la CLI para realizar tareas como las siguientes:

Android CLI 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 comandos de la CLI de Android.

Instala la CLI de Android

Para instalar la CLI de Android, sigue estos pasos:

  1. Descarga la Android CLI.

  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 Android CLI, ejecuta android init para instalar la habilidad de android-cli.

Datos recopilados

La Android CLI 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 argumentos o de opciones no posicionales que se usaron, por ejemplo, --sdk o --version.
  • Son 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 emuladores, como medium_phone y large_desktop, y nombres de agentes, como GEMINI, CLAUDE o CODEX.
  • Seguimientos de pila y mensajes de excepción, en los que la información de identificación se anonimiza antes de la recopilación para ayudar a garantizar la privacidad

Estos son 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 de Maven específicas, rutas de acceso de archivos locales o nombres de proyectos personalizados. Por ejemplo, si se ejecuta el comando android create --name=com.company.internal.app, registramos que se ejecutó android create 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.

Configura la CLI de Android

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

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

Agrega las marcas que quieras 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 en todo momento, 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 el resultado detallado. Especifica varias opciones de -v para aumentar el nivel de detalle (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 comandos de la CLI de Android.