Skip to content

2. Capítulo 1 - Configuração do ambiente de trabalho

2.1. Instalação das ferramentas

  • Node.js: baixe e instale a versão 22 (ou posterior) em nodejs.org. Verifique a instalação em um terminal com os comandos [node --version] e [npm --version]. O Node.js só é útil para o servidor [NestJS].
  • [MySQL] 8: ele é instalado no Capítulo 2 com a ferramenta Laragon, que também fornece a ferramenta de administração HeidiSQL.
  • Postman: disponível para download gratuito em postman.com; é usado para testar o servidor no Capítulo 2.
  • Visual Studio Code: opcional, para ver o código do servidor [NestJS].

Para o cliente, só é necessária uma ferramenta: o [Android Studio]. Não é necessário instalar um JDK (Java Development Kit) separadamente: o Android Studio inclui o seu próprio, o JetBrains Runtime ([JBR]), que é usado para executar o [Gradle], a ferramenta de build de projetos Android. Também não é necessário instalar o compilador Kotlin: ele é um plugin do Gradle baixado automaticamente na primeira vez que o projeto é compilado.

2.1.1. Android Studio e Android SDK

O [Android Studio] pode ser baixado gratuitamente em [https://developer.android.com/studio]. Ao iniciá-lo pela primeira vez, o assistente oferece uma instalação padrão: aceite-a. Ele então baixará o Android SDK (as bibliotecas da plataforma, as ferramentas de compilação e o emulador).

Image

Este documento foi testado com o Android Studio Quail 4 (2026.1.4). A tela inicial dá acesso, pelo link [More Actions], ao [SDK Manager] e ao [Virtual Device Manager], que são usados mais adiante:

Image

  • O [SDK Manager] instala e atualiza os componentes do Android SDK. Aba [SDK Platforms]: verifique se uma plataforma Android recente está instalada; o projeto deste documento é compilado para a API 37 (Android 17). Se ela estiver ausente, o Gradle a baixará automaticamente durante o primeiro build;
  • Aba [SDK Tools]: verifique se [Android SDK Build-Tools], [Android SDK Platform-Tools] (que contém a ferramenta [adb]) e [Android Emulator] estão marcados.

Image

O SDK é instalado por padrão na pasta [%LOCALAPPDATA%\Android\Sdk] (no Windows). Duas de suas subpastas contêm ferramentas de linha de comando usadas neste documento: [platform-tools] (a ferramenta [adb], que controla um celular ou emulador a partir do computador) e [emulator]. Você pode adicionar essas duas pastas ao [PATH] do sistema para poder simplesmente digitar [adb] em um terminal.

2.2. Criação de um projeto Android com o Android Studio

O código do cliente acompanha este documento (pasta [rdvmedecins-kotlin-client]). Ele foi criado a partir do template de projeto do Android Studio [Empty Activity] e depois ampliado. Vejamos primeiro como esse projeto inicial é criado: é o equivalente do comando [flutter create] do curso de Flutter. Na tela inicial do Android Studio, clique em [New Project]:

Image

  • Na categoria [Phone and large screens], selecione o template [Empty Activity]. Esse é o template “Jetpack Compose”: um aplicativo de tela única cuja interface é definida em Kotlin. O template [Empty Views Activity], por outro lado, usa o sistema de views mais antigo, descrito em XML, que este documento não utiliza;
  • clique em [Next].

Image

  • [Name]: o nome do aplicativo, exibido abaixo do seu ícone no celular. Para este documento: [RdvMedecins];
  • [Package name]: o identificador único do aplicativo, na forma de um nome de domínio invertido. Para este documento: [fr.rdvmedecins.client]. Esse também é o pacote Kotlin base do código-fonte;
  • [Save location]: a pasta do projeto;
  • [Minimum SDK]: a versão mais antiga do Android com suporte. O cliente deste documento exige a API 26 (Android 8.0), que cobre quase todos os celulares em uso;
  • [Build configuration language]: a linguagem dos arquivos de configuração do Gradle. [Kotlin DSL (build.gradle.kts)] é a escolha recomendada: a configuração do build também é escrita em Kotlin;
  • [Finish] cria o projeto. O Android Studio então inicia uma “Gradle sync” inicial: ele baixa o próprio Gradle, o plugin do Android, o compilador Kotlin e as bibliotecas declaradas pelo projeto. Isso pode levar vários minutos na primeira vez.

O projeto criado tem a seguinte estrutura de diretórios (os arquivos que o leitor deste documento modificou ou adicionou são tratados no Capítulo 4):

MyApplication/
├── settings.gradle.kts            # configuração global: repositórios, módulos do projeto
├── build.gradle.kts               # plugins Gradle usados pelos módulos
├── gradle.properties              # opções do Gradle
├── gradlew, gradlew.bat           # o "wrapper" do Gradle (veja abaixo)
├── gradle/
│   ├── libs.versions.toml         # catálogo de versões das bibliotecas
│   └── wrapper/                   # versão do Gradle usada pelo projeto
└── app/                           # o módulo "application"
    ├── build.gradle.kts           # configuração do Android + dependências
    └── src/main/
        ├── AndroidManifest.xml    # o "documento de identidade" da aplicação
        ├── java/com/example/...   # o código Kotlin (pasta chamada java/ por tradição)
        └── res/                   # recursos: ícones, textos, tema

O [Gradle] desempenha aqui o mesmo papel que o [npm] em um projeto Node.js ou que o [flutter]/[pub] no projeto Flutter: ele baixa as dependências, compila o código e produz a aplicação instalável, um arquivo .apk. Os scripts [gradlew] (Linux, macOS) e [gradlew.bat] (Windows), o “wrapper” do Gradle, baixam, conforme necessário, a versão exata do Gradle exigida pelo projeto (especificada em [gradle/wrapper/gradle-wrapper.properties]): nenhuma instalação global do Gradle é necessária.

2.3. Abertura do projeto cliente

Se você baixou o código deste documento, o cliente fica na pasta [rdvmedecins-kotlin-client]. Para abri-lo: na tela inicial do Android Studio, clique no botão [Open] e selecione essa pasta (a que contém o [settings.gradle.kts]). O Android Studio iniciará a sincronização do Gradle descrita acima. O projeto aparecerá então na visão [Project] (à esquerda); a visão [Android], que é a padrão, agrupa os arquivos por tipo (manifests, Kotlin+Java, assets, res) em vez de por pasta.

O projeto também pode ser compilado sem abrir o Android Studio, pela linha de comando. Em um terminal aberto na pasta [rdvmedecins-kotlin-client]:

$env:JAVA_HOME = "C:\Program Files\Android\Android Studio\jbr"
.\gradlew.bat assembleDebug
  • a primeira linha (PowerShell) informa ao Gradle qual JDK usar: o do Android Studio. Isso é desnecessário se a variável [JAVA_HOME] já estiver definida na máquina;
  • a segunda linha executa a tarefa do Gradle [assembleDebug], que compila o projeto e produz um aplicativo “debug” que pode ser instalado em um emulador ou em um celular.

Durante o primeiro build, o Gradle baixa tudo de que precisa e depois exibe a lista de tarefas que está executando:

PS C:\Data\st-2026\dev\kotlin-nestjs-claude\rdvmedecins-kotlin-client> .\gradlew.bat assembleDebug
Welcome to Gradle 9.6.0!
...
> Task :app:processDebugResources
> Task :app:compileDebugKotlin
> Task :app:dexBuilderDebug
> Task :app:packageDebug
> Task :app:assembleDebug

BUILD SUCCESSFUL in 1m 11s
36 actionable tasks: 36 executed
  • [compileDebugKotlin]: compilação do código Kotlin em bytecode Java;
  • [dexBuilderDebug]: conversão desse bytecode para o formato DEX, o formato executado pela máquina virtual Android ([ART], Android Runtime);
  • [packageDebug]: montagem do arquivo [app/build/outputs/apk/debug/app-debug.apk], a aplicação instalável.

2.4. Configuração de um emulador Android

Se você não tem um celular, pode testar o aplicativo em um emulador Android: um celular virtual executado em uma janela do seu computador. Esta seção é igual à do curso de Flutter.

[Prerequisites]: a virtualização precisa estar habilitada na [BIOS] do computador e, no Windows, o recurso [Windows Hypervisor Platform] precisa estar marcado ([Control Panel / Programs / Turn Windows features on or off]), o que exige uma reinicialização. Caso contrário, o emulador não iniciará ou será executado muito lentamente.

Abra o [Device Manager] no Android Studio: [More Actions / Virtual Device Manager] na tela inicial, ou [Tools / Device Manager] quando um projeto está aberto.

Image

Clique em [Create Device], selecione um modelo (por exemplo, [Pixel 8]) e depois [Next]. Selecione uma imagem de sistema Android recente para o processador [x86_64] e baixe-a pelo link [Download] ao lado dela; em seguida, [Next] e [Finish].

Image

Image

Inicie o emulador com o botão [Play] do [Device Manager]:

Image

Você também pode iniciá-lo a partir de um terminal. O primeiro comando lista os emuladores que foram criados; o segundo inicia um deles:

& "$env:LOCALAPPDATA\Android\Sdk\emulator\emulator.exe" -list-avds
& "$env:LOCALAPPDATA\Android\Sdk\emulator\emulator.exe" -avd Pixel_8

Aguarde até que a tela inicial do Android apareça na janela do emulador (a primeira inicialização pode levar vários minutos) e verifique então se a ferramenta [adb] o detecta:

1
2
3
& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" devices
List of devices attached
emulator-5554    device

[Note]: se o [adb devices] exibir [offline] em vez de [device], o emulador não terminou de iniciar ou o [adb] está em um estado inconsistente. Aguarde a tela de boas-vindas e, se necessário, reinicie o [adb] com os comandos [adb kill-server] seguido de [adb start-server]. Se o problema persistir, use [where.exe adb] para verificar que nenhum outro [adb], de uma versão diferente (como o de um SDK anterior, por exemplo), está presente no [PATH].

2.4.1. Preparação do celular Android

Para executar o aplicativo em um celular Android real, é preciso configurá-lo para permitir o controle a partir do computador:

  • ative as opções do desenvolvedor: abra [Settings / About phone] e toque várias vezes (geralmente 7) em [Build number] até que o celular indique que você é um desenvolvedor. Os nomes exatos variam conforme o fabricante;
  • ative a [USB debugging] no menu [Developer options] (adicionado na etapa anterior);
  • conecte o celular ao computador com um cabo USB que transfira dados (e não apenas carregue o celular) e aceite no celular a solicitação de autorização de depuração USB. No Windows, se o celular não for reconhecido, instale o driver USB do fabricante (“OEM USB drivers”, veja [https://developer.android.com/studio/run/oem-usb]);
  • verifique se o celular aparece na lista exibida por [adb devices].

O celular acessará o servidor [NestJS] pelo endereço IP do computador na rede local ou pelo cabo USB, com o comando [adb reverse]. Essas configurações são descritas no Capítulo 5.