Especialista em CLI Android
Esta habilidade fornece instruções para usar a ferramenta de CLI android. A ferramenta inclui vários comandos para criar projetos, executar aplicativos, interagir com dispositivos e gerenciar o ambiente da CLI.
Instalação
Se a ferramenta android não estiver no PATH, instale-a. Para instalar, execute o seguinte 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"
Gerenciamento do SDK
Para gerenciar a instalação de SDKs e ferramentas Android, use o comando sdk. Por exemplo:
android sdk install <package>[@<version>]...: Instalar pacotes específicos. Vários pacotes podem ser especificados, separados por espaços.<version>assume o padrão da versão mais recente. Por exemplo:android sdk install platforms/android-30@2 platforms/android-34android sdk update [<pkg-name>]: Atualizar um pacote específico ou todos os pacotes para a versão mais recente.android sdk remove <pkg-name>: Remover um pacote do SDK local.android sdk list --all: Listar pacotes do SDK instalados e disponíveis.
Criação de projetos
Crie projetos a partir de modelos usando o comando create.
Por exemplo: android create empty-activity --name="My App" --output=./my-app
Interagindo com dispositivos Android
Use o comando android layout para inspecionar o layout da IU de um aplicativo Android no formato JSON.
Use o comando android screen para inspecionar visualmente a IU e obter coordenadas delimitadoras para regiões visuais.
IMPORTANTE: Antes de usar android layout ou android screen, você DEVE ler esta referência: interact.md
O arquivo de referência interact.md contém instruções para interagir corretamente com dispositivos Android. Siga suas instruções exatamente.
Executando testes de jornada
Testes de jornada envolvem interação com o dispositivo; use os comandos android layout e android screen para avaliar Jornadas.
As instruções para interação com dispositivos também se aplicam aqui.
IMPORTANTE: Antes de avaliar uma jornada, você DEVE ler esta referência: journeys.md O arquivo de referência journeys.md contém instruções para avaliar corretamente uma jornada Android. Siga suas instruções exatamente.
Pesquisa de documentação
O comando docs pesquisa documentação oficial de desenvolvedor Android de alta qualidade na Base de Conhecimento Android.
Ao fornecer algumas palavras-chave, esta ferramenta retornará artigos de alta qualidade que contêm exemplos ou orientações sobre como usar APIs ou bibliotecas Android.
Use esta ferramenta para obter informações adicionais sobre como realizar tarefas específicas do Android ou para saber mais sobre APIs, superfícies, bibliotecas ou dispositivos Android.
Sempre use esta ferramenta para obter as informações mais atualizadas sobre conceitos Android. Casos de uso típicos e bons são:
- Encontrar guias de migração para APIs.
- Encontrar exemplos para APIs.
- Encontrar informações atualizadas sobre APIs Android.
- Encontrar melhores práticas para conceitos Android.
Executando APKs
Use o comando run para executar aplicativos Android.
Gerenciando emuladores
Gerencie Dispositivos Virtuais Android (AVDs) usando o comando android emulator.
Capturando capturas de tela
Capture uma imagem da tela atual de um dispositivo Android conectado e a envie para um arquivo usando o comando android screen.
Gerenciando habilidades
Gerencie habilidades do agente para Android usando o comando android skills.
Atualizando a CLI
Atualize a CLI Android usando o comando android update.
Saída de android help
Uso: android [-Vhv] [--sdk=PARAM] [COMANDO] -h, --help Mostra a mensagem de ajuda para este comando --sdk=PARAM Caminho para o SDK Android -v, --verbose Ativa saída detalhada para solução de problemas -V, --version Imprime informações da versão e sai Comandos: completion Instala a configuração de autocomplete do shell para a CLI Android no perfil de usuário atual create Crie um novo projeto Android a partir de modelos disponíveis. Permite especificar nome do projeto, diretório de saída, minSdk e execução de teste (dry-run) describe Analisa um projeto Android para gerar metadados descritivos. Este comando identifica e gera os caminhos para arquivos JSON que detalham a estrutura do projeto, incluindo alvos de compilação e suas localizações correspondentes de artefatos de saída (ex.: APKs). Essas informações permitem que outras ferramentas e comandos localizem artefatos de compilação de forma eficiente docs Comandos de documentação Android para pesquisar e buscar documentação do desenvolvedor na base de conhecimento oficial emulator Gerencia Dispositivos Virtuais Android (AVDs). Inclui comandos para iniciar, parar, listar e ver detalhes sobre emuladores help Mostra a ajuda de todos os comandos info Imprime informações do ambiente, incluindo localização do SDK, dispositivos conectados e variáveis de configuração. Use campos específicos para limitar a saída init Inicializa o ambiente para a CLI Android. Configura as configurações, diretórios e habilidades padrão necessários install Instala um Aplicativo Android (um ou mais APKs) em um dispositivo ou emulador conectado sem ativar nenhum componente, usando otimizações incrementais para implantação mais rápida que adb layout Retorna a árvore de layout de um aplicativo run Compila, implanta e inicia um aplicativo Android em um dispositivo ou emulador conectado screen Comandos para visualizar o dispositivo sdk Gerencia a instalação do SDK Android. Inclui comandos para instalar, atualizar, remover e listar pacotes do SDK disponíveis e instalados skills Gerencia habilidades da CLI Android. Inclui comandos para instalar, remover, listar e pesquisar habilidades por palavra-chave studio Comandos do Android Studio update Atualiza a CLI Android para a versão mais recente
completion Uso: android completion [-h] [] Instala a configuração de autocomplete do shell para a CLI Android no perfil de usuário atual
Opções:
-h, --help Mostra a mensagem de ajuda para este comando
opções android:
--sdk=PARAM Caminho para o SDK Android
-v, --verbose Ativa saída detalhada para solução de problemas
-V, --version Imprime informações da versão e sai
Parâmetros posicionais:
<shell> Se fornecido, imprime o complemento do shell fornecido sem
instalar. Suportado: bash, zsh
create Uso: android create [-h] [--application-id=PARAM] [--list] [--min-sdk=PARAM] [--name=PARAM] [--namespace=PARAM] [--output=PARAM] [] Crie um novo projeto Android a partir de modelos disponíveis. Permite especificar nome do projeto, diretório de saída, minSdk e execução de teste (dry-run)
Opções:
--application-id=PARAM O ID do aplicativo para o aplicativo
(ex.: 'com.example.myapp')
-h, --help Mostra a mensagem de ajuda para este comando
--list Lista todos os modelos disponíveis
--min-sdk=PARAM O 'minSdk' compatível com o
aplicativo (o padrão é definido no
modelo)
--name=PARAM O nome do aplicativo (ex.: 'My
Application')
--namespace=PARAM O namespace para recursos e nome do pacote
para arquivos de origem Kotlin
-o, --output=PARAM O caminho do diretório do projeto de destino
(o padrão é '.')
opções android:
--sdk=PARAM Caminho para o SDK Android
-v, --verbose Ativa saída detalhada para
solução de problemas
-V, --version Imprime informações da versão e sai
Parâmetros posicionais:
<nome-do-modelo> O nome do modelo
describe Uso: android describe [-h] [--project_dir=PARAM] Analisa um projeto Android para gerar metadados descritivos. Este comando identifica e gera os caminhos para arquivos JSON que detalham a estrutura do projeto, incluindo alvos de compilação e suas localizações correspondentes de artefatos de saída (ex.: APKs). Essas informações permitem que outras ferramentas e comandos localizem artefatos de compilação de forma eficiente
Opções:
-h, --help Mostra a mensagem de ajuda para este comando
--project_dir=PARAM O diretório do projeto a ser descrito
opções android:
--sdk=PARAM Caminho para o SDK Android
-v, --verbose Ativa saída detalhada para solução de
problemas
-V, --version Imprime informações da versão e sai
docs Uso: android docs [-h] [COMANDO] Comandos de documentação Android para pesquisar e buscar documentação do desenvolvedor na base de conhecimento oficial
Opções:
-h, --help Mostra a mensagem de ajuda para este comando
opções android:
--sdk=PARAM Caminho para o SDK Android
-v, --verbose Ativa saída detalhada para solução de problemas
-V, --version Imprime informações da versão e sai
Comandos:
fetch Busca um artigo de documentação Android de uma URL (kb://...)
search Pesquisa documentação Android. Coloque as palavras-chave entre
aspas
emulator Uso: android emulator [-h] [COMANDO] Gerencia Dispositivos Virtuais Android (AVDs). Inclui comandos para iniciar, parar, listar e ver detalhes sobre emuladores
Opções:
-h, --help Mostra a mensagem de ajuda para este comando
opções android:
--sdk=PARAM Caminho para o SDK Android
-v, --verbose Ativa saída detalhada para solução de problemas
-V, --version Imprime informações da versão e sai
Comandos:
create Cria um dispositivo virtual
list Lista dispositivos virtuais disponíveis
remove Exclui um dispositivo virtual
start Inicia o dispositivo virtual especificado. Este comando
retornará quando o emulador estiver totalmente iniciado e
pronto para uso
stop Para o dispositivo virtual especificado
help Uso: android help [-h] [COMANDO] Mostra a ajuda de todos os comandos
Opções:
-h, --help Mostra a mensagem de ajuda para este comando
opções android:
--sdk=PARAM Caminho para o SDK Android
-v, --verbose Ativa saída detalhada para solução de problemas
-V, --version Imprime informações da versão e sai
Parâmetros posicionais:
COMANDO O comando para o qual mostrar ajuda
info Uso: android info [-h] [] Imprime informações do ambiente, incluindo localização do SDK, dispositivos conectados e variáveis de configuração. Use campos específicos para limitar a saída
Opções:
-h, --help Mostra a mensagem de ajuda para este comando
opções android:
--sdk=PARAM Caminho para o SDK Android
-v, --verbose Ativa saída detalhada para solução de problemas
-V, --version Imprime informações da versão e sai
Parâmetros posicionais:
<campo> O campo específico para imprimir o valor. Se omitido,
imprime tudo
init Uso: android init [-h] Inicializa o ambiente para a CLI Android. Configura as configurações, diretórios e habilidades padrão necessários
Opções:
-h, --help Mostra a mensagem de ajuda para este comando
opções android:
--sdk=PARAM Caminho para o SDK Android
-v, --verbose Ativa saída detalhada para solução de problemas
-V, --version Imprime informações da versão e sai
install Uso: android install [-h] [--apks=PARAM] [--device=PARAM] [--install-options=PARAM] [--use-delta-install] Instala um Aplicativo Android (um ou mais APKs) em um dispositivo ou emulador conectado sem ativar nenhum componente, usando otimizações incrementais para implantação mais rápida que adb
Opções:
--apks=PARAM Os caminhos para os APKs, separados por vírgula
--device=PARAM O número de série do dispositivo
-h, --help Mostra a mensagem de ajuda para este comando
--install-options=PARAM Opções/indicadores adicionais para
passar para a instalação do gerenciador de
pacotes (ex.: -g,-d)
--use-delta-install Usa instalação delta rápida (acelera
atualizações incrementais transferindo apenas
código e recursos modificados; padrão: true)
opções android:
--sdk=PARAM Caminho para o SDK Android
-v, --verbose Ativa saída detalhada para
solução de problemas
-V, --version Imprime informações da versão e sai
Parâmetros posicionais:
<apk> Os caminhos para os APKs