Ambiente Android com Kotlin no Android Studio: instalação e configuração essencial

O que você precisa ter antes de começar

Para desenvolver apps Android com Kotlin, você precisa de três componentes funcionando em conjunto: (1) a IDE (Android Studio), (2) o Android SDK (ferramentas, plataformas e build-tools) e (3) um “alvo” para executar o app (emulador via AVD ou um dispositivo físico). A instalação correta garante que o Android Studio consiga sincronizar o projeto (Gradle Sync), compilar (Build) e executar (Run) sem erros.

Instalação do Android Studio (passo a passo)

1) Baixar e instalar

• Baixe o Android Studio no site oficial do Android Developers.
• Instale com as opções padrão. Se o instalador oferecer instalar o Android SDK e o Emulator, mantenha marcado.

2) Primeira execução e assistente (Setup Wizard)

• Ao abrir pela primeira vez, escolha o tipo de instalação Standard (recomendado para iniciantes).
• Confirme o local do SDK (pasta do Android SDK). Anote esse caminho: ele é útil para resolver problemas depois.
• Deixe o assistente baixar os componentes necessários (SDK Platform, Build-Tools, Platform-Tools, Emulator).

3) Verificar atualizações

No Android Studio, verifique se está na versão estável mais recente (menu de ajuda/atualizações). Versões muito antigas costumam causar incompatibilidades com plugins e Gradle.

Configuração essencial do Android SDK

Abrindo o SDK Manager

No Android Studio, acesse o SDK Manager (geralmente em Tools > SDK Manager ou pelo ícone de engrenagem). Você verá duas abas principais: SDK Platforms e SDK Tools.

O que instalar (mínimo recomendado)

• SDK Platforms: instale pelo menos uma versão recente do Android (por exemplo, a mais atual estável) e, se possível, mais uma versão anterior para testes.
• SDK Tools (essenciais):
  • Android SDK Platform-Tools (inclui ADB)
  • Android SDK Build-Tools
  • Android SDK Command-line Tools (latest)
  • Android Emulator (se for usar emulador)

Como validar o SDK rapidamente

Abra o terminal e verifique se o ADB está disponível (o caminho pode variar conforme o SO):

adb version

Se o comando não for encontrado, o SDK pode não estar instalado corretamente ou o platform-tools não está no PATH (não é obrigatório colocar no PATH, mas ajuda em diagnósticos).

Continue em nosso aplicativo e ...

• Ouça o áudio com a tela desligada
• Ganhe Certificado após a conclusão
• + de 5000 cursos para você explorar!

ou continue lendo abaixo...

Baixar o aplicativo

Criando e configurando um Emulador (AVD)

Conceito: AVD e imagem de sistema

Um AVD (Android Virtual Device) é um perfil de dispositivo virtual (modelo, tela, Android version) que roda no Android Emulator. Para criar um AVD, você precisa de uma System Image (imagem do sistema) compatível.

Passo a passo para criar um AVD

1. Abra o Device Manager (geralmente em Tools > Device Manager).
2. Clique em Create device.
3. Escolha um modelo comum (ex.: Pixel) para reduzir variáveis.
4. Selecione uma System Image (ex.: Android recente). Se não tiver, clique em Download.
5. Finalize e inicie o emulador com Play.

Dicas para desempenho e estabilidade

• Se o emulador estiver lento, verifique se a virtualização está habilitada no BIOS/UEFI e se o SO está usando aceleração (Hyper-V/WHPX no Windows, Hypervisor Framework no macOS, KVM no Linux).
• Prefira imagens x86_64 quando disponíveis (geralmente mais rápidas em emuladores).
• Evite criar muitos AVDs no início; mantenha 1 ou 2 perfis.

Usando um dispositivo físico (recomendado para testar)

Conceito: ADB e depuração USB

Para rodar o app em um celular real, o Android Studio usa o ADB (Android Debug Bridge). Você precisa habilitar a Depuração USB no aparelho e permitir a conexão no computador.

Passo a passo (Android)

1. No celular, ative as Opções do desenvolvedor (geralmente tocando várias vezes em “Número da versão” em Configurações > Sobre o telefone).
2. Ative Depuração USB em Configurações > Sistema > Opções do desenvolvedor (o caminho pode variar).
3. Conecte via cabo USB.
4. No celular, aceite o prompt “Permitir depuração USB” (marque “Sempre permitir” se for seu computador).

Validando a conexão com ADB

adb devices

Você deve ver um dispositivo listado como device. Se aparecer unauthorized, desbloqueie o celular e aceite a autorização. Se não aparecer nada, verifique cabo/porta USB e drivers (especialmente no Windows).

Validando a instalação: executar um app template

1) Criar um projeto de teste

1. No Android Studio, crie um novo projeto.
2. Escolha um template simples (ex.: Empty Activity).
3. Selecione Kotlin como linguagem.
4. Mantenha as configurações padrão de minSdk/targetSdk sugeridas pelo Android Studio (para evitar incompatibilidades no início).

2) Sincronizar e compilar

• Aguarde o Gradle Sync terminar (ícone/indicador de sincronização).
• Se solicitado, permita downloads de componentes do SDK.

3) Executar no emulador ou dispositivo

1. Selecione o alvo (emulador/dispositivo) no seletor de dispositivos.
2. Clique em Run.
3. Confirme se o app abre e exibe a tela inicial do template.

4) Conferir logs básicos no Logcat

Abra o Logcat e filtre pelo nome do app/processo. Você deve ver logs de inicialização sem erros críticos repetidos (crashes). Se houver crash, o Logcat mostrará a stacktrace.

Partes principais do Android Studio (o que observar no dia a dia)

Project View

É a área onde você navega pelos arquivos do projeto. Para iniciantes, dois modos são úteis:

• Android: agrupa arquivos por “visão Android” (Manifest, Kotlin/Java, res).
• Project: mostra a estrutura real de pastas (útil para localizar arquivos do Gradle e configurações).

Build / Sync

Sync (Gradle Sync) baixa dependências, valida plugins e configura o projeto. Build compila o código e gera o APK/Bundle. Muitos erros aparecem primeiro no Sync, antes mesmo de compilar.

• Se o Sync falhar, normalmente o Run/Build também falhará.
• Observe a aba de mensagens do Gradle/Build para detalhes do erro.

Logcat

Console de logs do dispositivo/emulador. Use para:

• Ver crashes (stacktrace).
• Inspecionar mensagens de debug.
• Filtrar por app, tag ou nível (Error/Warning/Info).

Gradle Tool Window

Janela que permite:

• Executar tarefas Gradle (ex.: assembleDebug).
• Ver módulos e tarefas disponíveis.
• Reexecutar ações sem depender do botão Run.

Problemas comuns de configuração e como resolver

1) “SDK location not found” / SDK ausente

Sintoma: o projeto não sincroniza e o Android Studio reclama que não encontra o SDK.

Passos para resolver:

• Abra SDK Manager e confirme o caminho do SDK.
• Em Settings/Preferences, procure por Android SDK e ajuste o caminho.
• Se o projeto usa um arquivo local de configuração, verifique se existe um arquivo local.properties na raiz do projeto contendo:

sdk.dir=/caminho/para/Android/Sdk

Observação: em Windows, o caminho usa barras invertidas, mas muitas vezes funciona melhor com barras normais:

sdk.dir=C:\Users\SeuUsuario\AppData\Local\Android\Sdk

2) Erros de Gradle Sync (dependências, plugin, rede)

Sintomas comuns: mensagens como “Could not resolve…”, “Plugin not found”, “SSLHandshakeException”, “Read timed out”.

Checklist de correção:

• Confirme conexão com a internet e se há proxy corporativo. Se houver, configure proxy em Settings > HTTP Proxy.
• Clique em Sync Now após qualquer ajuste.
• Verifique se o Gradle JDK está configurado (em geral, use o JDK embutido do Android Studio, quando disponível).
• Se o erro for de cache corrompido, tente File > Invalidate Caches / Restart.
• Se o download de dependências falhar, tente limpar caches do Gradle (pode exigir fechar a IDE) e sincronizar novamente.

3) Falta de permissões no sistema operacional

Sintomas: falha ao criar AVD, não consegue escrever em pastas do SDK, erros ao iniciar emulador, ou o Android Studio não consegue baixar componentes.

Como resolver:

• Instale o Android Studio e o SDK em um local onde seu usuário tenha permissão de escrita.
• Evite pastas protegidas pelo SO sem permissões (ex.: algumas pastas de sistema).
• No Windows, se drivers/ADB não funcionarem, instale drivers do fabricante (quando necessário) e teste outra porta/cabo.
• No macOS/Linux, se o ADB não listar dispositivos, verifique permissões/udev rules (Linux) e autorização no aparelho.

4) Emulador não inicia ou fecha sozinho

Causas frequentes: virtualização desativada, conflito com hypervisor, falta de recursos (RAM/CPU), imagem incompatível.

Ações práticas:

• Confirme virtualização habilitada no BIOS/UEFI.
• Reduza recursos do AVD (RAM/cores) e tente novamente.
• Crie um AVD novo com uma imagem de sistema diferente.
• Atualize o Android Emulator no SDK Tools.

Checklist de configuração mínima (ambiente funcional)

Critérios para considerar o ambiente pronto

• Você consegue criar um projeto Kotlin (template) e o Gradle Sync termina sem erros.
• Você consegue executar o app no emulador ou em um dispositivo físico e ver a tela inicial.
• O Logcat está acessível e você consegue identificar logs do seu app.
• O SDK Manager mostra pelo menos uma plataforma Android instalada e as ferramentas essenciais (platform-tools, build-tools, command-line tools).
• Se usar emulador: um AVD inicia de forma consistente. Se usar dispositivo físico: adb devices lista o aparelho como autorizado.