Especialista em CLI do Android

Esta habilidade fornece instruções para usar a ferramenta CLI android. A ferramenta inclui vários comandos para criar projetos, executar aplicativos, interagir com dispositivos e gerenciar o ambiente da CLI.

Quando Usar

• Use quando precisar criar, configurar ou analisar projetos Android a partir da linha de comando.
• Use ao interagir, implantar ou tirar capturas de tela de dispositivos Android em execução.
• Use ao gerenciar componentes, versões ou dispositivos virtuais (emuladores) do Android SDK.
• Use ao inspecionar layouts de UI ou executar testes de jornada especificados em XML.

Instalação

Se a ferramenta android não estiver no PATH, baixe o instalador da plataforma para um diretório temporário privado, inspecione-o e execute-o somente após o usuário confirmar a origem e o conteúdo:

tmpdir="$(mktemp -d "${TMPDIR:-/tmp}/android-cli.XXXXXX")" || exit 1
curl -fsSL https://dl.google.com/android/cli/latest/linux_x86_64/install.sh -o "$tmpdir/install.sh"
sed -n '1,160p' "$tmpdir/install.sh"
# After review and explicit user confirmation:
bash "$tmpdir/install.sh"

Use o URL darwin_arm64/install.sh ou windows_x86_64/install.cmd correspondente para macOS ou Windows. Não envie scripts de instalador de rede mutáveis diretamente para um shell.

Gerenciamento de SDK

Para gerenciar a instalação de SDKs e ferramentas do Android, use o comando sdk. Por exemplo:

• android sdk install <package>[@<version>]...: Instala pacotes específicos. Vários pacotes podem ser especificados, separados por espaços. <version> é o padrão para a versão mais recente. Por exemplo: android sdk install platforms/android-30@2 platforms/android-34
• android sdk update [<pkg-name>]: Atualiza um pacote específico ou todos os pacotes para a versão mais recente.
• android sdk remove <pkg-name>: Remove um pacote do SDK local.
• android sdk list --all: Lista pacotes de 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

Para mais informações sobre como interagir com dispositivos em execução, veja aqui.

Executando Testes de Jornada

Para mais informações sobre como executar jornadas, veja aqui.

Pesquisa de Documentação

O comando docs pesquisa documentação autoritativa e de alta qualidade para desenvolvedores Android na Base de Conhecimento do 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 do 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 do 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 do Android.
• Encontrar as melhores práticas para conceitos do 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 capture -o <file path>.

Gerenciando Habilidades

Gerencie habilidades de agente antigravidade para Android usando o comando android skills.

Inspecionando Layouts de UI

Use o comando android layout para inspecionar o layout da UI de um aplicativo Android. Ele retorna a árvore de layout de um aplicativo Android em formato JSON. Ao depurar erros de UI, esta é frequentemente uma abordagem muito mais rápida do que tirar uma captura de tela.

Atualizando a CLI

Atualize a CLI do Android usando o comando android update.

Limitações

• A CLI android deve estar instalada e disponível em PATH; caso contrário, instale-a primeiro ou use as orientações de configuração específicas da plataforma acima.
• Comandos de dispositivo, emulador, SDK e documentação podem depender do estado local do Android SDK, acesso à rede e hardware conectado.
• Trate os comandos gerados como sensíveis ao ambiente: inspecione caminhos, nomes de pacotes, seriais de dispositivos e alvos de instalação/atualização antes de executá-los.

Saída de Ajuda do Android

Usage: android [-hV] [--sdk=PARAM] [COMMAND]
  -h, --help        Mostra esta mensagem de ajuda e sai.
      --sdk=PARAM   Caminho para o Android SDK
  -V, --version     Imprime informações de versão e sai.
Commands:

…