Notas da versão da CLI do Android

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 install e android run nã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 systemtrace pode registrar o que o Jetpack Compose faz em um app. Transmita --enable=compose.composition para registrar uma fração de cada função combinável executada ou --enable=compose.recomposition para também registrar as leituras e gravações de estado que causam recomposições. O app precisa do androidx.compose.runtime:runtime-tracing 1.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=perfetto para android profiler heapdump capture para 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=json para artefatos de biblioteca (AARs e JARs), os campos dexSizeBytes em d8CompileResult e r8CompileResult agora são números inteiros de 64 bits serializados como strings em vez de números.
  • Resultados de entrada como JSON: os subcomandos android input mostram o resultado como um objeto JSON com uma lista results na 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 campo status de cada resultado, em vez de como texto no erro padrão.
  • Códigos de saída do emulador: android emulator create, start, stop e remove agora 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 signals para investigar como o app se comporta em campo com o Firebase Crashlytics. Depois de fazer login com android auth login, encontre seus projetos e apps com android signals context. Em seguida, liste, filtre e detalhe problemas de falha, ANR e não fatais com android signals crashes list, facets, describe e samples.
  • Heap dumps de campo: use android signals heaps para 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 profiler para registrar rastreamentos do sistema com android profiler systemtrace e capturar heap dumps da JVM com android profiler heapdump capture em um dispositivo conectado ou emulador. Gerencie as sessões de criação de perfil com android profiler session list, status e terminate.
  • Análise de artefatos: use o novo comando android analyze para 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=json ou --format=textproto para saída legível por máquina.
  • Prévias do Compose: use o novo comando android preview list para encontrar as funções @Preview do Jetpack Compose em um destino e android 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 --output para escolher onde os arquivos serão gravados.
  • Referências de build em execução e instalação: android run e android install aceitam 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 variante debug como padrão.
  • Janela de espelhamento de dispositivo: use o novo comando android device hub para 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 pelo android device remote connect) e Android Emulators.

Versão 1.0.16625370 (outubro de 2026)

  • Interação com a interface: use o novo comando android input para tocar, rolar, deslizar, digitar texto e pressionar teclas em um dispositivo conectado ou emulador. Segmente elementos da interface com seletores como text=Submit ou id=email,class=EditText e combine-os com android layout para encontrar os elementos com que você quer interagir.

Versão 1.0.16500706 (outubro de 2026)

  • Conectar na reserva: o android device remote create agora conecta a nova reserva ao adb automaticamente. Transmita --connect=false para criar apenas a reserva e se conectar mais tarde com android 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 projects e navegue pelos dispositivos físicos disponíveis com android device remote models.
  • Reservas de dispositivos remotos: reserve um dispositivo físico remoto com android device remote create e gerencie suas reservas com list, extend --duration <minutes> e remove.
  • Conectar-se a dispositivos remotos: use android device remote connect para conectar um dispositivo reservado ao adb por uma conexão em segundo plano, para que ele funcione com android run, android install e outros comandos de dispositivo, como um dispositivo local. Use android device remote disconnect para 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, skills e update, o que torna os scripts e a CI mais confiáveis.
  • Ajuste de anotação de tela: o android screen --annotate expõ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-id e --namespace e nomes de opções com hífen, como --min-sdk. O modelo do Compose agora usa um conjunto de origem src/main/kotlin e um tema do Material 3.
  • Emulador headless: inicie um emulador sem uma janela usando android emulator start --headless.
  • Confiabilidade do SDK: os comandos android sdk usam 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-preview mostra 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 layout agora oferece suporte à flag --no-idle para buscar o layout sem esperar pelo estado inativo. O android layout também oferece suporte à flag --full para retornar toda a árvore de layout sem filtragem. Por padrão, o layout retorna 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 update e instale ou remova várias habilidades em uma única invocação (por exemplo, android skills install <skill1> <skill2>).
  • Listar habilidades por agente: android skills list agora mostra por padrão uma exibição detalhada, incluindo descrições de habilidades e os agentes em que a habilidade está instalada. O android skills list també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 install usando 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 screen usando 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 o adb.
  • Executar instalações incrementais: use a nova flag --use-delta-install em android run para 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 comandos android 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 remove e a resolução baseada em SHA em android sdk resolve.
  • Melhorias na descrição e na tela: confira os erros de build do Gradle diretamente na saída padrão em android describe e segmente dispositivos específicos usando a flag --device em android 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 emulator que 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 create agora 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 sdk agora 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 studio para 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, winget e homebrew. Para mais detalhes, consulte as opções de download.

Versão 0.7 (abril de 2026)

Primeira versão!