Especialista en CLI de Android

Esta habilidad proporciona instrucciones para usar la herramienta CLI android. La herramienta incluye varios comandos para crear proyectos, ejecutar aplicaciones, interactuar con dispositivos y gestionar el entorno de la CLI.

Instalación

Si la herramienta android no está en la ruta, instálela. Para instalar ejecute el siguiente comando: Linux: curl -fsSL https://dl.google.com/android/cli/latest/linux_x86_64/install.sh | bash Mac Arm: curl -fsSL https://dl.google.com/android/cli/latest/darwin_arm64/install.sh | bash Mac Intel: curl -fsSL https://dl.google.com/android/cli/latest/darwin_x86_64/install.sh | bash Windows: curl -fsSL https://dl.google.com/android/cli/latest/windows_x86_64/install.cmd -o "%TEMP%\i.cmd" && "%TEMP%\i.cmd"

Gestión del SDK

Para gestionar la instalación de los SDK y herramientas de Android, use el comando sdk. Por ejemplo:

android sdk install <paquete>[@<versión>]...: Instala paquetes específicos. Se pueden especificar varios paquetes, separados por espacios. <versión> predetermina a la última. Por ejemplo: android sdk install platforms/android-30@2 platforms/android-34
android sdk update [<nombre-paquete>]: Actualiza un paquete específico o todos los paquetes a la última versión.
android sdk remove <nombre-paquete>: Elimina un paquete del SDK local.
android sdk list --all: Lista los paquetes del SDK instalados y disponibles.

Creación de proyectos

Cree proyectos a partir de plantillas usando el comando create.

Por ejemplo: android create empty-activity --name="Mi App" --output=./mi-app

Interactuando con dispositivos Android

Use el comando android layout para inspeccionar el diseño de la interfaz de usuario de una aplicación Android en formato JSON. Use el comando android screen para inspeccionar visualmente la interfaz de usuario y obtener coordenadas de los límites para regiones visuales.

IMPORTANTE: Antes de usar android layout o android screen, DEBE leer esta referencia: interact.md El archivo de referencia interact.md contiene instrucciones para interactuar correctamente con dispositivos Android. Siga sus instrucciones exactamente.

Ejecución de pruebas de journey

Las pruebas de journey implican interacción con el dispositivo; use los comandos android layout y android screen para evaluar Journeys. Las instrucciones para la interacción con el dispositivo también se aplican aquí.

IMPORTANTE: Antes de evaluar un journey, DEBE leer esta referencia: journeys.md El archivo de referencia journeys.md contiene instrucciones para evaluar correctamente un journey de Android. Siga sus instrucciones exactamente.

Búsqueda de documentación

El comando docs busca documentación oficial de desarrollador de Android de alta calidad en la Base de Conocimientos de Android. Al proporcionar algunas palabras clave, esta herramienta devolverá artículos de alta calidad que contienen ejemplos o guías sobre cómo usar las API o bibliotecas de Android. Use esta herramienta para obtener información adicional sobre cómo lograr tareas específicas de Android o para conocer más sobre las API, superficies, bibliotecas o dispositivos de Android.

Use siempre esta herramienta para obtener la información más actualizada sobre conceptos de Android. Los casos de uso típicos y buenos son:

Encontrar guías de migración para API.
Encontrar ejemplos para API.
Encontrar información actualizada sobre API de Android.
Encontrar mejores prácticas para conceptos de Android.

Ejecución de APKs

Use el comando run para ejecutar aplicaciones de Android.

Gestión de emuladores

Gestione los Dispositivos Virtuales de Android (AVDs) usando el comando android emulator

Captura de pantallas

Capture una imagen de la pantalla actual de un dispositivo Android conectado y envíela a un archivo usando el comando android screen.

Gestión de habilidades

Gestione las habilidades del agente para Android usando el comando android skills.

Actualización de la CLI

Actualice la CLI de Android usando el comando android update.

Salida de `android help`

Uso: android [-Vhv] [--sdk=PARAM] [COMANDO] -h, --help Muestra el mensaje de ayuda para este comando --sdk=PARAM Ruta al SDK de Android -v, --verbose Habilita la salida detallada para la resolución de problemas -V, --version Imprime la información de la versión y sale Comandos: completion Instala la configuración de autocompletado de shell para la CLI de Android en el perfil de usuario actual create Crea un nuevo proyecto de Android a partir de plantillas disponibles. Permite especificar el nombre del proyecto, directorio de salida, minSdk y ejecución simulada describe Analiza un proyecto de Android para generar metadatos descriptivos. Este comando identifica y genera las rutas a archivos JSON que detallan la estructura del proyecto, incluidos los objetivos de compilación y sus ubicaciones de artefactos de salida correspondientes (por ejemplo, APKs). Esta información permite que otras herramientas y comandos localicen los artefactos de compilación de manera eficiente. docs Comandos de documentación de Android para buscar y recuperar documentación de desarrollador de la base de conocimientos oficial emulator Gestiona Dispositivos Virtuales de Android (AVDs). Incluye comandos para iniciar, detener, listar y ver detalles sobre emuladores help Muestra la ayuda de todos los comandos info Imprime información del entorno, incluida la ubicación del SDK, dispositivos conectados y variables de configuración. Use campos específicos para limitar la salida. init Inicializa el entorno para la CLI de Android. Configura las configuraciones, directorios y habilidades predeterminadas requeridas. install Instala una aplicación de Android (uno o más APKs) en un dispositivo conectado o emulador sin activar ningún componente, utilizando optimizaciones incrementales para una implementación más rápida que adb. layout Devuelve el árbol de diseño de una aplicación. run Compila, implementa y lanza una aplicación de Android en un dispositivo conectado o emulador. screen Comandos para ver el dispositivo. sdk Gestiona la instalación del SDK de Android. Incluye comandos para instalar, actualizar, eliminar y listar paquetes del SDK disponibles e instalados. skills Gestiona las habilidades de la CLI de Android. Incluye comandos para instalar, eliminar, listar y buscar habilidades por palabra clave. studio Comandos de Android Studio. update Actualiza la CLI de Android a la última versión.

completion Uso: android completion [-h] [] Instala la configuración de autocompletado de shell para la CLI de Android en el perfil de usuario actual.

      Opciones:
        -h, --help       Muestra el mensaje de ayuda para este comando
      
      opciones de android:
            --sdk=PARAM  Ruta al SDK de Android
        -v, --verbose    Habilita la salida detallada para la resolución de problemas
        -V, --version    Imprime la información de la versión y sale
      
      Parámetros posicionales:
        <shell>  Si se proporciona, imprime el autocompletado del shell dado sin
                 instalarlo. Compatible: bash, zsh

create Uso: android create [-h] [--application-id=PARAM] [--list] [--min-sdk=PARAM] [--name=PARAM] [--namespace=PARAM] [--output=PARAM] [] Crea un nuevo proyecto de Android a partir de plantillas disponibles. Permite especificar el nombre del proyecto, directorio de salida, minSdk y ejecución simulada.

      Opciones:
            --application-id=PARAM  El ID de la aplicación para la aplicación
                                    (por ejemplo, 'com.example.myapp')
        -h, --help                  Muestra el mensaje de ayuda para este comando
            --list                  Lista todas las plantillas disponibles
            --min-sdk=PARAM         El 'minSdk' compatible con la aplicación (el valor
                                    predeterminado se define en la plantilla)
            --name=PARAM            El nombre de la aplicación (por ejemplo, 'Mi
                                    Aplicación')
            --namespace=PARAM       El espacio de nombres para los recursos y el nombre
                                    del paquete para los archivos fuente de Kotlin
        -o, --output=PARAM          La ruta del directorio de destino del proyecto (el
                                    valor predeterminado es '.')
      
      opciones de android:
            --sdk=PARAM             Ruta al SDK de Android
        -v, --verbose               Habilita la salida detallada para la resolución de
                                    problemas
        -V, --version               Imprime la información de la versión y sale
      
      Parámetros posicionales:
        <nombre-plantilla>  El nombre de la plantilla

describe Uso: android describe [-h] [--project_dir=PARAM] Analiza un proyecto de Android para generar metadatos descriptivos. Este comando identifica y genera las rutas a archivos JSON que detallan la estructura del proyecto, incluidos los objetivos de compilación y sus ubicaciones de artefactos de salida correspondientes (por ejemplo, APKs). Esta información permite que otras herramientas y comandos localicen los artefactos de compilación de manera eficiente.

      Opciones:
        -h, --help               Muestra el mensaje de ayuda para este comando
            --project_dir=PARAM  El directorio del proyecto a describir
      
      opciones de android:
            --sdk=PARAM          Ruta al SDK de Android
        -v, --verbose            Habilita la salida detallada para la resolución de
                                 problemas
        -V, --version            Imprime la información de la versión y sale

docs Uso: android docs [-h] [COMANDO] Comandos de documentación de Android para buscar y recuperar documentación de desarrollador de la base de conocimientos oficial.

      Opciones:
        -h, --help       Muestra el mensaje de ayuda para este comando
      
      opciones de android:
            --sdk=PARAM  Ruta al SDK de Android
        -v, --verbose    Habilita la salida detallada para la resolución de problemas
        -V, --version    Imprime la información de la versión y sale
      Comandos:
        fetch   Recupera un artículo de documentación de Android desde una URL (kb://...)
        search  Busca documentación de Android. Encierre las palabras clave entre comillas

emulator Uso: android emulator [-h] [COMANDO] Gestiona Dispositivos Virtuales de Android (AVDs). Incluye comandos para iniciar, detener, listar y ver detalles sobre emuladores.

      Opciones:
        -h, --help       Muestra el mensaje de ayuda para este comando
      
      opciones de android:
            --sdk=PARAM  Ruta al SDK de Android
        -v, --verbose    Habilita la salida detallada para la resolución de problemas
        -V, --version    Imprime la información de la versión y sale
      Comandos:
        create  Crea un dispositivo virtual
        list    Lista los dispositivos virtuales disponibles
        remove  Elimina un dispositivo virtual
        start   Inicia el dispositivo virtual especificado. Este comando
                regresará cuando el emulador esté completamente iniciado y listo para usar.
        stop    Detiene el dispositivo virtual especificado

help Uso: android help [-h] [COMANDO] Muestra la ayuda de todos los comandos.

      Opciones:
        -h, --help       Muestra el mensaje de ayuda para este comando
      
      opciones de android:
            --sdk=PARAM  Ruta al SDK de Android
        -v, --verbose    Habilita la salida detallada para la resolución de problemas
        -V, --version    Imprime la información de la versión y sale
      
      Parámetros posicionales:
        COMANDO  El comando para el que mostrar ayuda

info Uso: android info [-h] [] Imprime información del entorno, incluida la ubicación del SDK, dispositivos conectados y variables de configuración. Use campos específicos para limitar la salida.

      Opciones:
        -h, --help       Muestra el mensaje de ayuda para este comando
      
      opciones de android:
            --sdk=PARAM  Ruta al SDK de Android
        -v, --verbose    Habilita la salida detallada para la resolución de problemas
        -V, --version    Imprime la información de la versión y sale
      
      Parámetros posicionales:
        <campo>  El campo específico del cual imprimir el valor. Si se omite, imprime
                 todo.

init Uso: android init [-h] Inicializa el entorno para la CLI de Android. Configura las configuraciones, directorios y habilidades predeterminadas requeridas.

      Opciones:
        -h, --help       Muestra el mensaje de ayuda para este comando
      
      opciones de android:
            --sdk=PARAM  Ruta al SDK de Android
        -v, --verbose    Habilita la salida detallada para la resolución de problemas
        -V, --version    Imprime la información de la versión y sale

install Uso: android install [-h] [--apks=PARAM] [--device=PARAM] [--install-options=PARAM] [--use-delta-install] Instala una aplicación de Android (uno o más APKs) en un dispositivo conectado o emulador sin activar ningún componente, utilizando optimizaciones incrementales para una implementación más rápida que adb.

      Opciones:
            --apks=PARAM             Las rutas a los APKs, separadas por comas
            --device=PARAM           El número de serie del dispositivo
        -h, --help                   Muestra el mensaje de ayuda para este comando
            --install-options=PARAM  Opciones/banderas adicionales para pasar a la
                                     instalación del administrador de paquetes (por
                                     ejemplo, -g, -d)
            --use-delta-install      Usar instalación delta rápida (acelera las
                                     actualizaciones incrementales transfiriendo solo
                                     el código y los recursos modificados;
                                     valor predeterminado: true)
      
      opciones de android:
            --sdk=PARAM              Ruta al SDK de Android
        -v, --verbose                Habilita la salida detallada para la resolución de
                                     problemas
        -V, --version                Imprime la información de la versión y sale

...

lerchenflo/claudeskills

¿Qué es claudeskills?

Preguntar en tu IA favorita

Documentación