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.

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.

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

A Android CLI substitui o Android Studio?

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.

Quais plataformas a Android CLI suporta?

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.

Qual a diferença entre os Android Skills e a Android Knowledge Base?

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 é segura para uso em pipelines de CI em produção?

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.