Como Criar um App Android com o Android CLI
A Android CLI do Google, lançada em prévia em abril de 2026, oferece a desenvolvedores e agentes de IA uma interface limpa, baseada em terminal, para o desenvolvimento de aplicativos Android. Se você trabalha com fluxos agênticos, pipelines de CI ou simplesmente prefere seu editor a uma IDE completa, vale a pena conhecer essa ferramenta.
Este artigo percorre o fluxo principal: instalar a Android CLI, configurar o SDK, criar um projeto e executá-lo em um emulador — além de mostrar como os Android Skills e a Android Knowledge Base se encaixam no desenvolvimento assistido por IA.
Principais Conclusões
- A Android CLI é a ferramenta oficial do Google baseada em terminal, criada principalmente para agentes de IA, scripts de automação e fluxos de CI/CD.
- Ela complementa o Android Studio, em vez de substituí-lo, cuidando da configuração e do boilerplate, enquanto a IDE continua sendo a escolha para trabalho com UI, depuração e profiling.
- O fluxo principal — instalar, criar componentes do SDK, gerar a estrutura de um projeto, compilar o APK e executá-lo em um emulador — exige apenas alguns comandos.
- Os Android Skills e a Android Knowledge Base mantêm os agentes de IA alinhados com os padrões atuais do Android, mesmo quando seus dados de treinamento estão desatualizados.
- A CLI roda em Apple Silicon, AMD64 Linux e AMD64 Windows, e se integra a agentes como Gemini, Claude Code e Codex.
O Que é a Android CLI e Para Quem Ela Se Destina?
A Android CLI é uma ferramenta oficial do Google projetada principalmente para agentes de IA, scripts de automação e fluxos de CI/CD. Ela não substitui o Android Studio. Pense nela como a primeira metade de um contínuo de desenvolvimento: agentes e scripts cuidam da configuração e do boilerplate via CLI, e depois os desenvolvedores abrem o projeto no Android Studio para refinamento de UI, depuração e profiling em produção.
A CLI está disponível para Apple Silicon, AMD64 Linux e AMD64 Windows.
Observação: Experimentos internos do Google relatam redução no consumo de tokens de LLM e conclusão de tarefas mais rápida em comparação com agentes que navegam manualmente pelo ferramental padrão do SDK. Esses números vêm dos próprios testes do Google e não foram verificados de forma independente.
Passo 1: Instalar a Android CLI
Baixe o binário na página oficial dos Android agents e siga as instruções de instalação específicas para sua plataforma. Após a instalação, o comando android ficará disponível no seu terminal.
Para manter a ferramenta atualizada, execute:
android update
Passo 2: Configurar o Android SDK
Em vez de baixar uma instalação completa do Android Studio, a Android CLI permite obter apenas os componentes do SDK que você precisa:
android sdk install platforms/android-35 build-tools/35.0.0
Isso mantém seu ambiente enxuto — útil para runners de CI e ambientes provisionados por agentes, onde espaço em disco e tempo de configuração são relevantes.
Passo 3: Criar um Projeto de App Android
O comando android create gera um novo projeto a partir de um template oficial, com a arquitetura recomendada aplicada desde o início:
android create empty-activity --name="My App" --output=./my-app
Isso produz um projeto Android moderno, com Jetpack Compose, Material 3 e uma estrutura padrão sensata. Nenhuma configuração manual do Gradle é necessária para começar.
Passo 4: Criar um Emulador e Executar Seu App
Inicie um dispositivo virtual:
android emulator create
Em seguida, compile o APK e faça o deploy:
./gradlew assembleDebug
android run --apks app/build/outputs/apk/debug/app-debug.apk
A CLI simplifica a criação de dispositivos e o deploy, reduzindo os passos manuais de configuração que normalmente atrasam tanto desenvolvedores humanos quanto agentes de IA atuando em pipelines automatizados.
Discover how at OpenReplay.com.
Como os Android Skills e a Knowledge Base Se Encaixam
Dois recursos complementares ampliam o que os agentes podem fazer com a Android CLI:
Os Android Skills são conjuntos modulares de instruções em markdown (arquivos SKILL.md) que cobrem fluxos como configuração do Navigation 3, implementação de UI edge-to-edge e migrações para o AGP 9. Os Skills são projetados para serem acionados automaticamente quando o prompt de um agente corresponde aos metadados do skill, de modo que os agentes executam o padrão correto sem que você precise anexar documentação manualmente toda vez.
Explore os skills disponíveis com:
android skills list
A Android Knowledge Base, acessível pelo comando android docs, permite que agentes consultem orientações atualizadas da documentação para desenvolvedores Android, Firebase e Kotlin. Isso é importante porque os dados de treinamento de LLMs ficam desatualizados. Mesmo que o modelo do seu agente tenha um ano de idade, ele ainda pode obter as melhores práticas atuais por meio da Knowledge Base.
Android CLI vs. Android Studio: Quando Usar Cada Um
| Tarefa | Android CLI | Android Studio |
|---|---|---|
| Configuração do SDK em CI | ✅ | ❌ |
| Criação de projetos por agentes | ✅ | ✅ |
| Design visual de UI | ❌ | ✅ |
| Depuração interativa | ❌ | ✅ |
| Profiling de desempenho | ❌ | ✅ |
| Gerenciamento de emulador por scripts | ✅ | ❌ |
Começando
A Android CLI está em prévia, então espere arestas e documentação em evolução. Dito isso, o fluxo principal — instalar, criar, compilar e executar — já funciona bem para experimentação e fluxos automatizados com agentes como Gemini, Claude Code e Codex.
Comece com android create, abra o resultado no Android Studio quando estiver pronto para refinar, e use os Android Skills para manter seu agente alinhado com os padrões atuais do Android.
Conclusão
A Android CLI preenche uma lacuna real no desenvolvimento Android ao oferecer a agentes e pipelines de automação um ponto de entrada limpo e roteirizável, que antes exigia encapsular o ferramental do Android Studio. Combiná-la com os Android Skills e a Knowledge Base cria um fluxo no qual os agentes permanecem alinhados com as melhores práticas atuais, enquanto os desenvolvedores mantêm todo o poder do Android Studio para o trabalho que realmente se beneficia de uma IDE gráfica. À medida que a ferramenta amadurece para além da prévia, espere que ela se torne parte padrão de configurações de CI e fluxos Android conduzidos por agentes.
Perguntas Frequentes
Não. A Android CLI foca em tarefas roteirizáveis, como instalação do SDK, geração da estrutura de projetos, gerenciamento de emuladores e fluxos conduzidos por agentes. O Android Studio continua sendo o ambiente recomendado para design visual de UI, depuração interativa e profiling de desempenho. As duas ferramentas se complementam ao longo das diferentes fases do desenvolvimento.
A versão em prévia suporta Macs com Apple Silicon, AMD64 Linux e AMD64 Windows. ARM64 Windows e ARM64 Linux não estão atualmente listados entre as plataformas suportadas, então desenvolvedores nessas arquiteturas devem consultar a documentação oficial da Android CLI por atualizações antes de depender da ferramenta em pipelines de produção.
Os Android Skills são arquivos de instrução em markdown reutilizáveis que guiam agentes por fluxos específicos, como configuração do Navigation 3 ou migrações de AGP, sendo acionados automaticamente com base nos metadados do prompt. A Knowledge Base é uma interface de consulta que busca documentação atualizada de fontes do Android, Firebase e Kotlin, ajudando os agentes a acessar orientações recentes mesmo quando seus dados de treinamento estão desatualizados.
A Android CLI ainda está em prévia, então sua superfície de API e comportamento podem mudar. Ela é adequada para experimentação e pipelines internos onde mudanças incompatíveis podem ser gerenciadas, mas equipes que dependem de ferramentas estáveis para lançamentos de produção devem acompanhar as notas de versão do Google e considerar fixar versões específicas até que a ferramenta atinja disponibilidade geral.
Understand every bug
Uncover frustrations, understand bugs and fix slowdowns like never before with OpenReplay — the open-source session replay tool for developers. Self-host it in minutes, and have complete control over your customer data. Check our GitHub repo and join the thousands of developers in our community.