📥 Instalação e Configuração

Antes de criar seu primeiro projeto (Cap 01), você precisa preparar o ambiente de desenvolvimento. Este guia cobre a instalação do Android Studio, as variáveis de ambiente do Windows, a criação de um emulador (AVD) e uma alternativa usando VS Code + ADB. No final, um checklist confirma que tudo está funcionando.

✅ Tabela de Versões Recomendadas

Escolher as versões certas evita a maioria dos erros de build. Para projetos modernos (Kotlin ou Java), a combinação estável e recomendada é:

Componente Versão Recomendada
JDK 17 (LTS)
Gradle 8.5 ou superior
Android Gradle Plugin (AGP) 8.2 ou superior
Kotlin 1.9+ ou 2.x
compileSdk 34 ou mais recente

💡 Regra de ouro: sempre deixe o Android Studio gerar o projeto com as versões padrão sugeridas por ele — essas versões já vêm testadas e compatíveis entre si.

📖 Dicionário do Programador

🖥️ Instalando o Android Studio

  1. Baixe o instalador oficial em developer.android.com/studio.
  2. Durante a instalação, mantenha as opções padrão (Android SDK, Android Virtual Device, etc.).
  3. Ao abrir o Android Studio pela primeira vez, ele baixa o SDK e um JDK próprio embutido, chamado jbr-17 (JetBrains Runtime, baseado no JDK 17).

💡 Você não precisa instalar um JDK separado: o Android Studio já vem com o jbr-17, que atende à versão recomendada da tabela acima.

🔧 Variáveis de Ambiente (Windows)

Algumas tarefas — rodar gradlew no terminal, usar adb, abrir o projeto no VS Code — exigem que o Windows saiba onde estão o SDK, o JDK e o Gradle. Configure as variáveis abaixo em Painel de Controle → Sistema → Configurações Avançadas → Variáveis de Ambiente:

Variável Valor Sugerido
JAVA_HOME %USERPROFILE%\AppData\Local\Programs\Android Studio\jbr
ANDROID_HOME %USERPROFILE%\AppData\Local\Android\Sdk
ANDROID_SDK_ROOT %USERPROFILE%\AppData\Local\Android\Sdk
ANDROID_AVD_HOME %USERPROFILE%\.android\avd
GRADLE_USER_HOME %USERPROFILE%\.gradle

Depois, adicione estas pastas ao PATH:

%JAVA_HOME%\bin
%ANDROID_HOME%\platform-tools
%ANDROID_HOME%\emulator
%ANDROID_HOME%\tools

⚠️ Atenção: se JAVA_HOME apontar para um JDK diferente do JDK embutido do Android Studio, o Gradle pode iniciar dois daemons diferentes (um para cada JDK), deixando o build mais lento e instável. Garanta que os dois apontem para o mesmo caminho — ver “Erros Comuns” abaixo.

📱 Criando um Emulador (AVD)

O AVD (Android Virtual Device) é o “celular virtual” onde você testa seus apps sem precisar de um aparelho físico.

  1. No Android Studio, abra o Device Manager (ícone de celular na barra lateral).
  2. Clique em Create Device.
  3. Escolha um modelo de celular (ex.: Pixel 6) e clique em Next.
  4. Escolha uma imagem do sistema (ex.: API 34), baixe-a se necessário, e clique em Next → Finish.
  5. Clique no ▶️ ao lado do emulador criado para iniciá-lo.

💡 Os arquivos do emulador ficam salvos na pasta ANDROID_AVD_HOME (%USERPROFILE%\.android\avd). Se precisar liberar espaço em disco, é nessa pasta que estão os AVDs criados.

💻 Alternativa: VS Code + ADB

Se preferir escrever código no VS Code (mantendo o Android Studio só para SDK, emulador e Preview do Compose), o fluxo é:

1. Verifique o ADB

No PowerShell:

adb --version

Se o comando não for encontrado, confira se %ANDROID_HOME%\platform-tools está no PATH (seção anterior) e abra um novo terminal.

2. Extensões recomendadas no VS Code

3. Criando o projeto

Crie o projeto pelo Android Studio normalmente (New Project), depois abra a pasta no VS Code:

code .

4. Build e instalação via terminal

Na raiz do projeto (onde está o gradlew):

.\gradlew assembleDebug    # gera o APK em app/build/outputs/apk/debug/
.\gradlew installDebug     # compila E instala no emulador/celular conectado

5. Testando em um celular físico (USB)

  1. No celular: Configurações → Sobre o telefone → tocar 7x em “Número da versão” (ativa as Opções do Desenvolvedor).
  2. Em Opções do Desenvolvedor, ative a Depuração USB.
  3. Conecte o cabo USB e confirme: 
    adb devices
  4. Aceite o pop-up de autorização no celular. O dispositivo deve aparecer como device (e não unauthorized).

📋 Comandos Úteis do Dia a Dia

adb devices                            # lista dispositivos/emuladores conectados
adb logcat                              # mostra os logs do app em tempo real
adb logcat | findstr nome_do_pacote     # filtra logs do seu app
adb uninstall com.seu.pacote            # remove o app do dispositivo
adb kill-server && adb start-server     # reinicia o ADB
.\gradlew clean                         # limpa o build (use quando algo "não atualiza")

💡 Script opcional: quem usa o VS Code com frequência pode automatizar build + instalação + logcat com um script PowerShell (run-android.ps1, na raiz do projeto) que detecta o dispositivo conectado, roda gradlew assembleDebug/installDebug e abre o adb logcat ao final. Não é obrigatório para o curso, mas é um bom exercício de automação para quem já está confortável com terminal.

⚠️ Erros Comuns

Erro Causa Solução
“Multiple Gradle daemons might be spawned because the Gradle JDK and JAVA_HOME locations are different” JAVA_HOME aponta para um JDK diferente do JDK usado pelo Android Studio (jbr-17) Alinhe JAVA_HOME para o mesmo caminho do JDK do Android Studio (seção “Variáveis de Ambiente”)
adb não é reconhecido como comando platform-tools não está no PATH Adicione %ANDROID_HOME%\platform-tools ao PATH e abra um novo terminal
emulator -list-avds não mostra nenhum dispositivo Nenhum AVD foi criado ainda, ou ANDROID_AVD_HOME está apontando para outro lugar Crie um AVD pelo Device Manager (seção “Criando um Emulador”)
Erro de versão do AGP/Gradle incompatível ao abrir um projeto compileSdk/AGP do projeto é mais novo que o suportado pelo Android Studio instalado Atualize o Android Studio, ou aceite a sugestão de upgrade automático do Gradle/AGP
adb devices mostra unauthorized A autorização da Depuração USB não foi confirmada no celular Desconecte e reconecte o cabo, e aceite o pop-up de autorização no celular

✅ Checklist Final de Verificação

Rode estes comandos no terminal para confirmar que o ambiente está pronto:

java -version          # deve mostrar algo como "17.x.x"
.\gradlew --version     # (dentro de um projeto) deve listar Gradle e JVM
adb devices             # deve listar pelo menos um dispositivo/emulador
emulator -list-avds     # deve listar pelo menos um AVD criado

Se os quatro comandos funcionarem, seu ambiente está pronto para o Cap 01!

⬅️ Voltar para a Home