Visão geral da CLI do Android

A CLI do Android é uma interface de linha de comando que permite criar para Android de forma mais eficiente usando qualquer ferramenta de sua escolha. Ele padroniza as competências principais de desenvolvimento para fluxos de trabalho com foco em agentes, oferecendo um ponto de entrada para as ferramentas, habilidades e conhecimentos oficiais necessários para desenvolver de forma mais eficaz. Ela também pode simplificar a CI, a manutenção e qualquer outra automação programada para a natureza cada vez mais distribuída do desenvolvimento do Android.

Por exemplo, um agente ou script pode usar a CLI para realizar tarefas como as seguintes:

  • Automatizar a configuração do ambiente e do SDK do Android
  • Estruturar novos projetos com base em modelos
  • Gerencie dispositivos virtuais, instale APKs e inspecione telas de dispositivos ativos e hierarquias de interface diretamente do terminal
  • Conecte-se a instâncias em execução do Android Studio para análise semântica de código, renderização de prévia do Compose e pesquisas de versão de dependência.
  • Testar o app com as Jornadas

A CLI do Android também dá aos seus agentes acesso a habilidades do Android e à base de conhecimento do Android especializada para ajudar a garantir que seus projetos apliquem padrões e práticas recomendadas do Android.

Para uma descrição completa dos comandos e opções da CLI do Android, consulte a referência de comandos da CLI do Android.

Instalar a CLI do Android

Para instalar a CLI do Android, siga estas etapas:

  1. Faça o download da CLI do Android.

  2. Para garantir que você está usando a versão mais recente, atualize a CLI do Android:

    android update

Para verificar se a CLI do Android já está instalada na sua máquina, execute which android ou command -v android: se ela retornar um caminho, significa que está instalada.

Configurar para agentes

Para ajudar os agentes a entender e usar a CLI do Android, execute android init para instalar a skill android-cli.

Dados coletados

A CLI do Android coleta dados sobre o uso básico da ferramenta. Estes são os dados que coletamos:

  • Invocações do comando android e subcomandos, por exemplo, android run e android create.
  • Nomes de argumentos ou opções não posicionais usados, por exemplo, --sdk ou --version.
  • Argumentos posicionais e valores de flag que mapeiam um conjunto fixo e predefinido de opções do sistema gerenciadas pela CLI do Android. Por exemplo, coletamos nomes de modelos de emulador, como medium_phone e large_desktop, e nomes de agentes, como GEMINI, CLAUDE ou CODEX.
  • Rastreamentos de pilha e mensagens de exceção, em que as informações de identificação são anonimizadas antes da coleta para ajudar a garantir a privacidade.

Confira alguns exemplos de dados que não coletamos:

  • Não coletamos respostas da CLI quando um comando é executado.
  • Não coletamos entradas criadas pelo usuário nem identificadores externos transmitidos para a CLI, como coordenadas específicas do Maven, caminhos de arquivos locais ou nomes de projetos personalizados. Por exemplo, se o comando android create --name=com.company.internal.app for executado, vamos registrar que android create foi executado usando o argumento --name, mas não armazenamos o valor com.company.internal.app.

Para desativar a coleta de dados, use a flag --no-metrics ao executar um comando com a CLI do Android.

Feedback e problemas

Se você encontrar algum problema ou quiser enviar feedback, relate um bug.

Problemas conhecidos

  • O comando android emulator para Windows está desativado no momento.
  • No momento, não é possível fazer o download da CLI do Android no Windows PowerShell.

Configurar a CLI do Android

Crie um arquivo .androidrc para aplicar automaticamente flags e opções sempre que você invocar a CLI do Android. Salve o arquivo no seguinte local, dependendo do seu sistema operacional:

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

Adicione as flags que você quer aplicar automaticamente ao arquivo, uma por linha.

Por exemplo, para fazer com que a CLI do Android use um SDK do Android específico por padrão sempre, adicione a flag --sdk ao seu arquivo:

--sdk=<path-to-sdk>

Opções globais

Essas são flags opcionais que podem ser usadas com outros comandos da CLI do Android.

-h, --help

Uso:android <command> -h

Descrição:mostra o manual de ajuda da ferramenta ou do comando específico em questão.

Exemplos:

  • android -h
  • android create -h

--sdk

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

Descrição:o caminho para o SDK do Android que você quer usar no comando a seguir. Você pode usar a configuração --sdk para substituir temporariamente o SDK do Android padrão em vez de mudar as variáveis de ambiente globais sempre que quiser alternar. Para verificar qual SDK do Android você está usando por padrão, execute android info.

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

-v, --verbose

Uso:android -v <command>

Descrição:ativa a saída detalhada. Especifique várias opções de -v para aumentar a verbosidade (por exemplo, -v, -vv ou -vvv).

-V, --version

Uso:android -V

Descrição:imprime informações da versão e sai.

Comandos

Para uma descrição completa dos comandos e opções da CLI do Android, consulte a referência de comandos da CLI do Android.