A CLI do Android é uma interface de linha de comando que permite criar para Android de forma mais eficiente usando qualquer ferramenta de sua preferência. Ela padroniza as principais competências 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. Ele também pode simplificar a CI, a manutenção e qualquer outra automação com script para a natureza cada vez mais distribuída do desenvolvimento para Android.
A CLI do Android abrange todo o ciclo de vida de desenvolvimento, desde a criação de um projeto e o teste em um dispositivo até a criação de perfis de desempenho e a investigação de como ele se comporta em campo. Por exemplo, um agente ou script pode usar a CLI para realizar tarefas como as seguintes:
- Automatizar o ambiente e a configuração do SDK do Android
- Estruturar novos projetos com base em modelos
- Crie, instale e execute o app em um dispositivo conectado ou emulador.
- Gerencie dispositivos virtuais, espelhe e controle dispositivos conectados em um modo janela para computador, inspecione e interaja com telas de dispositivos em tempo real e hierarquias de interface diretamente do terminal.
- Renderize visualizações do Jetpack Compose em imagens na sua máquina, sem precisar de um dispositivo ou do Android Studio.
- Conectar-se a instâncias em execução do Android Studio para análise semântica de código, renderização de visualização do Compose e pesquisas de versão de dependência.
- Teste seu app com as Journeys
- Analise o perfil do app gravando rastreamentos do sistema e capturando heap dumps em um dispositivo conectado ou emulador.
- Analisar APKs, pacotes de apps e bibliotecas para informar os tamanhos, as métricas de redução e otimização do R8 e os avisos de regras de manutenção.
- Investigue falhas, ANRs e problemas não fatais que o Firebase Crashlytics informa para seu app em campo, incluindo os heap dumps que o Crashlytics coleta em falhas de falta de memória.
A CLI do Android também dá aos seus agentes acesso às habilidades do Android e à base de conhecimento especializada do Android para garantir que seus projetos apliquem os padrões e as 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:
Para garantir que você esteja 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 um caminho for retornado, ela está
instalada.
Configuração para agentes
Para ajudar os agentes a entender e usar a CLI do Android, execute android init para
instalar a habilidade android-cli.
Habilidades do Android
Ver no GitHubCLI do Android
android initDados 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
androide subcomandos, por exemplo,android runeandroid create. - Nomes de argumentos ou opções não posicionais usados, por exemplo,
--sdkou--version. - Argumentos posicionais e valores de flag que são mapeados para 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_phoneelarge_desktop, e nomes de agentes, comoGEMINI,CLAUDEouCODEX. - Stack traces e mensagens de exceção, em que as informações de identificação pessoal 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 ou 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.appfor executado, vamos registrar queandroid createfoi executado usando o argumento--name, mas não armazenamos o valorcom.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, informe um bug.
Configurar a CLI do Android
Crie um arquivo .androidrc para aplicar flags e opções automaticamente
sempre que você invocar a CLI do Android. Salve o arquivo no seguinte
local, dependendo do 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 que a CLI do Android use um SDK do Android específico por padrão
sempre, adicione a flag --sdk ao arquivo:
--sdk=<path-to-sdk>
Opções globais
Estas são flags opcionais que podem ser usadas com outros comandos da CLI do Android.
-h, --help
Uso: android <command> -h
Descrição: exibe o manual de ajuda da ferramenta ou do comando específico em questão.
Exemplos:
android -handroid create -h
--sdk
Uso: android --sdk=<path-to-sdk> <command>
Descrição: o caminho para o SDK do Android que você quer usar para o
comando a seguir. É possível 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
fazer a troca. 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 -v para
aumentar a verbosidade (por exemplo, -v, -vv ou -vvv).
-V, --version
Uso: android -V
Descrição: imprime as 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.