A CLI do Android é a interface primária para desenvolvimento do Android no terminal, criada para capacitar seus fluxos de trabalho de desenvolvimento usando o agente e as ferramentas da sua escolha.
Esta página lista os novos recursos em cada versão da CLI do Android. Para fazer o download da CLI do Android, acesse a página de download. Para saber mais, consulte a visão geral da CLI do Android.
Versão 1.1.16919734 (novembro de 2026)
- As instalações delta reutilizam arquivos reposicionados:
android installeandroid runnão reenviam mais arquivos inalterados que tiveram a posição no APK modificada. Para desativar, transmita--use-delta-install-instructions=COPY,DATA. - Rastreamento do Compose: o
android profiler systemtracepode registrar o que o Jetpack Compose faz em um app. Transmita--enable=compose.compositionpara registrar uma fração de cada função combinável executada ou--enable=compose.recompositionpara também registrar as leituras e gravações de estado que causam recomposições. O app precisa doandroidx.compose.runtime:runtime-tracing1.13 ou mais recente. O rastro é salvo como um arquivo ZIP que você abre no criador de perfil do Android Studio. - Heap dumps do Perfetto: transmita
--type=perfettoparaandroid profiler heapdump capturepara gravar o heap dump como um rastro do Perfetto. Ele tem os objetos e as referências entre eles, mas não os valores, por isso é menor que um arquivo.hprof. Ele requer o Android 12 (nível 31 da API) ou mais recente e um app que possa ser analisado ou depurado. - Formato de tamanho DEX da biblioteca na análise JSON: na
saída
android analyze --format=jsonpara artefatos de biblioteca (AARs e JARs), os camposdexSizeBytesemd8CompileResulter8CompileResultagora são números inteiros de 64 bits serializados como strings em vez de números. - Resultados de entrada como JSON: os subcomandos
android inputmostram o resultado como um objeto JSON com uma listaresultsna saída padrão, no mesmo formato para cada subcomando. Falhas como elementos sem correspondência ou várias correspondências são informadas no campostatusde cada resultado, em vez de como texto no erro padrão. - Códigos de saída do emulador:
android emulator create,start,stoperemoveagora saem com um código diferente de zero em caso de falha e mostram erros no erro padrão.
Versão 1.1.16717390 (outubro de 2026)
- Sinais de falha em campo: use o novo comando
android signalspara investigar como o app se comporta em campo com o Firebase Crashlytics. Depois de fazer login comandroid auth login, encontre seus projetos e apps comandroid signals context. Em seguida, liste, filtre e detalhe problemas de falha, ANR e não fatais comandroid signals crashes list,facets,describeesamples. - Heap dumps de campo: use
android signals heapspara listar, descrever e fazer o download dos heap dumps que o Crashlytics coleta em falhas de falta de memória e encerramentos do limitador de memória, além dos metadados, chaves personalizadas e registros da sessão que os produziu. - Criação de perfil de apps: use o novo comando
android profilerpara registrar rastreamentos do sistema comandroid profiler systemtracee capturar heap dumps da JVM comandroid profiler heapdump captureem um dispositivo conectado ou emulador. Gerencie as sessões de criação de perfil comandroid profiler sessionlist,statuseterminate. - Análise de artefatos: use o novo comando
android analyzepara inspecionar um ou mais APKs, AABs, AARs e JARs e informar os detalhes do pacote, tamanhos de DEX, métricas de redução e otimização do R8 e avisos sobre regras de manutenção de biblioteca e baixa otimização. Transmita--format=jsonou--format=textprotopara saída legível por máquina. - Prévias do Compose: use o novo comando
android preview listpara encontrar as funções@Previewdo Jetpack Compose em um destino eandroid preview render --fqn <name>para renderizá-las em imagens PNG e arquivos JSON de árvore de componentes na sua máquina, sem o Android Studio. Transmita--outputpara escolher onde os arquivos serão gravados. - Referências de build em execução e instalação:
android runeandroid installaceitam uma referência de build posicional para criar e implantar um destino específico. Os destinos do Gradle sem uma variante, como:app, agora usam a variantedebugcomo padrão. - Janela de espelhamento de dispositivo: use o novo comando
android device hubpara abrir uma janela de modo janela para computador para espelhamento de tela em tempo real e controle interativo de dispositivos Android físicos conectados (incluindo dispositivos remotos conectados peloandroid device remote connect) e Android Emulators.
Versão 1.0.16625370 (outubro de 2026)
- Interação com a interface: use o novo comando
android inputpara tocar, rolar, deslizar, digitar texto e pressionar teclas em um dispositivo conectado ou emulador. Segmente elementos da interface com seletores comotext=Submitouid=email,class=EditTexte combine-os comandroid layoutpara encontrar os elementos com que você quer interagir.
Versão 1.0.16500706 (outubro de 2026)
- Conectar na reserva: o
android device remote createagora conecta a nova reserva aoadbautomaticamente. Transmita--connect=falsepara criar apenas a reserva e se conectar mais tarde comandroid device remote connect.
Versão 1.0.16457483 (setembro de 2026)
- Fazer login nos Serviços do Google: com
android auth login, faça login na CLI do Android com sua Conta do Google para que ela possa chamar os Serviços do Google que exigem autenticação. - Catálogo de dispositivos remotos: encontre os projetos na nuvem do Google Cloud de onde você pode fazer streaming de dispositivos com
android device remote projectse navegue pelos dispositivos físicos disponíveis comandroid device remote models. - Reservas de dispositivos remotos: reserve um dispositivo físico remoto com
android device remote createe gerencie suas reservas comlist,extend --duration <minutes>eremove. - Conectar-se a dispositivos remotos: use
android device remote connectpara conectar um dispositivo reservado aoadbpor uma conexão em segundo plano, para que ele funcione comandroid run,android installe outros comandos de dispositivo, como um dispositivo local. Useandroid device remote disconnectpara desanexá-lo.
Versão 1.0.16406183 (setembro de 2026)
- Inicialização mais rápida: a CLI do Android é iniciada cerca de duas vezes mais rápido porque a biblioteca de download nativa é carregada apenas quando usada e não é mais descompactada em um diretório temporário a cada invocação.
- Códigos de saída fixos: os comandos agora retornam um código de saída diferente de zero quando
falham, incluindo
create,run,install,describe,layout,docs,info,skillseupdate, o que torna os scripts e a CI mais confiáveis. - Ajuste de anotação de tela: o
android screen --annotateexpõe parâmetros de ajuste para a detecção de recursos, incluindo limites de detecção de bordas, filtragem de formas e estratégia de clustering, documentados em--help. - Opções de criação de projetos: o
android createé compatível com as flags--application-ide--namespacee nomes de opções com hífen, como--min-sdk. O modelo do Compose agora usa um conjunto de origemsrc/main/kotline um tema do Material 3. - Emulador headless: inicie um emulador sem uma janela usando
android emulator start --headless. - Confiabilidade do SDK: os comandos
android sdkusam um bloqueio entre processos para que as invocações simultâneas não entrem em conflito, verificam o caminho e a versão dos pacotes instalados, atualizam arquivos XML legados apenas quando necessário e informam erros de forma mais clara. - Saída da visualização do Compose:
android studio render-compose-previewmostra o caminho absoluto da imagem renderizada e confirma a gravação, mesmo quando--print-semanticsé usado. - Suporte a níveis mais antigos da API: corrigimos falhas de interação com o dispositivo, como
android layout, em dispositivos com o nível 32 da API e anteriores.
Versão 1.0.16261425 (setembro de 2026)
- Correções de layout: corrigimos um problema em que o comando de layout não funcionava
em alguns cenários. Para reverter temporariamente para o comportamento de layout antigo,
export ANDROID_CLI_LAYOUT_V1=1.
Versão 1.0.16251017 (setembro de 2026)
- Layout dump: o
android layoutagora oferece suporte à flag--no-idlepara buscar o layout sem esperar pelo estado inativo. Oandroid layouttambém oferece suporte à flag--fullpara retornar toda a árvore de layout sem filtragem. Por padrão, olayoutretorna apenas elementos interativos. - Preenchimento automático do shell: gere e instale scripts de preenchimento automático do shell para
Bash e Zsh usando o novo comando
android completion. - Atualizar habilidades: mantenha as habilidades atualizadas com o novo comando
android skills updatee instale ou remova várias habilidades em uma única invocação (por exemplo,android skills install <skill1> <skill2>). - Listar habilidades por agente:
android skills listagora mostra por padrão uma exibição detalhada, incluindo descrições de habilidades e os agentes em que a habilidade está instalada. Oandroid skills listtambém é compatível com a flag--agent <agent>para listar todas as habilidades instaladas para um agente. - Desempenho da instalação delta: aplicação acelerada de patches incrementais de APK no
android installusando chamadas do sistema de kernel de cópia zero. - Detecção de bordas da tela: melhoria na detecção de recursos e bordas em
android screenusando algoritmos de detecção de bordas Canny.
Versão 1.0.15985488 (julho de 2026)
- Comando de instalação dedicado: instale APKs usando o comando independente
android install, que conta com o push incremental de APKs, tornando as instalações incrementais muito mais rápidas do que oadb. - Executar instalações incrementais: use a nova flag
--use-delta-installemandroid runpara implantações de APK incrementais mais rápidas em dispositivos. - Gerenciamento de SDK multiplataforma: segmente plataformas que não são de host com a nova
flag
--platform <os_arch>nos comandosandroid sdk(install,update,materialize) para inspecionar, resolver e instalar componentes em arquiteturas de SO e CPU. - Melhorias na CLI de habilidades: expandimos os subcomandos
android skills(add,remove,list,find) com a documentação de--help, feedback claro quando as habilidades estão ausentes e preparo de download atômico mais seguro com reversão automática.
Versão 1.0.15857036 (julho de 2026)
- Suporte mais amplo às habilidades do agente: instale habilidades em dezenas de ambientes de agente (incluindo Claude Code, Cursor, Cline, OpenHands, Windsurf, Zed e Devin) usando
android skills install. - Downloader nativo com suporte a proxy: faça o download de recursos de rede com segurança usando um downloader HTTP nativo com suporte pronto para uso para proxies corporativos.
- Gerenciamento de pacotes do SDK: gerencie pacotes do SDK com a remoção de vários pacotes
em
android sdk removee a resolução baseada em SHA emandroid sdk resolve. - Melhorias na descrição e na tela: confira os erros de build do Gradle diretamente na
saída padrão em
android describee segmente dispositivos específicos usando a flag--deviceemandroid screen. - Usabilidade da CLI e Error Reporting: mensagens de erro mais claras ao inserir comandos desconhecidos ou destinos de criação de projetos inválidos, comandos
android emulatorque não diferenciam maiúsculas de minúsculas.
Versão 1.0.15498356 (maio de 2026)
- Carregamento dinâmico de modelos do SDK: os modelos de projeto para
android createagora são baixados dinamicamente do pacote do SDK do Android, em vez de serem incluídos no binário da CLI. Isso garante que os novos projetos sempre usem os modelos mais recentes. - Compatibilidade com licenças do SDK: as licenças do SDK aceitas e salvas pelo
android sdkagora correspondem ao formato de arquivo esperado pelas ferramentas mais antigas do SDK do Android e pelos plug-ins do Gradle. - Suporte a links simbólicos: adicionamos suporte a links simbólicos em comandos da CLI e operações de arquivo.
- Extração binária atômica: evite disputas de extração durante invocações simultâneas de CLI de vários processos descompactando binários em um diretório temporário antes de movê-los atomicamente para o lugar.
- Estabilidade do Windows: melhoria na compatibilidade e no desempenho do Windows no Windows 11, além de correções para a resolução do caminho do diretório principal.
Versão 1.0.15433482 (maio de 2026)
- Integração com o Antigravity: a CLI do Android e as habilidades agora estão oficialmente integradas ao Google Antigravity 2.0 como um pacote opcional de recursos para simplificar o desenvolvimento de agentes.
- Comandos do Android Studio: use o novo comando
android studiopara permitir que seus agentes aproveitem os recursos profundos e contextuais do Android Studio, incluindo análise de código, pesquisas semânticas e renderização do Compose. - Suporte para jornadas: valide experiências críticas do usuário usando jornadas, que são descrições em linguagem natural de fluxos do usuário que seus agentes podem executar no terminal ou em CI/CD.
- Novas habilidades do Android: acesse a nova biblioteca de habilidades do Android, incluindo habilidades para migração do CameraX, interface adaptativa, AppFunctions e estilos do Compose.
- Mais opções de instalação: instale e atualize a CLI do Android usando gerenciadores de pacotes
conhecidos, como
apt-get,wingetehomebrew. Para mais detalhes, consulte as opções de download.
Versão 0.7 (abril de 2026)
Primeira versão!