Skip to content

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

2.1. Instalar as ferramentas

  1. Node.js: baixe e instale a versão 22 (ou posterior) a partir de nodejs.org. Verifique a instalação em um terminal:
    node --version
    npm --version
    
  1. Visual Studio Code (VSCode): disponível para download gratuito em code.visualstudio.com. Instale a extensão “TypeScript and JavaScript Language Features” (geralmente já incluída).
  1. [MySQL] 8: instale, por exemplo, por meio do XAMPP, do Laragon (no Windows) ou diretamente pelo [MySQL] Community Server. Uma ferramenta gráfica de administração (phpMyAdmin, [MySQL] Workbench, DBeaver, HeidiSQL…) facilita o trabalho. A seguir, será usada a ferramenta Laragon.
  2. Postman: disponível para download gratuito em postman.com.

2.1.1. Instalação do cliente Flutter

Inicie o VSCode sem selecionar nenhum projeto:

Image

  • Em [1-2], abra a paleta de comandos;

Image

  • Em [3], crie um novo projeto Flutter;

Image

  • em [4], crie uma aplicação vazia;

Image

  • Em [5-6], especifique uma pasta na qual será criada a subpasta do projeto;

Image

  • Em [6], digite um nome para o projeto. Esse também será o nome da pasta criada para o projeto;

Image

  • Em [1-3], especifique os destinos do projeto [1 – aplicação Android, 2 – aplicação desktop, 3 – aplicação web];

Image

  • em [4], o projeto criado. O VSCode baixa automaticamente o Flutter SDK;

Se você baixou o código deste documento, ele está em duas pastas:

Image

Image

  • em [1], o cliente [Flutter];
  • em [2], o servidor [NestJS];
  • em [3], o conteúdo de [2]. Copie todo esse conteúdo para a pasta do seu projeto Flutter. Novos elementos aparecerão no seu projeto:

Image

O comando [flutter doctor] verifica se tudo o que o [Flutter] precisa está no lugar, destino por destino. Execute-o em um terminal dentro do projeto Flutter:

flutter doctor

Quando tudo estiver correto, você obterá um resultado como este (os números de versão podem variar):

PS C:\Data\st-2026\dev\flutter-nestjs-sept-2026\flutter_application_1> flutter doctor
Doctor summary (to see all details, run flutter doctor -v):
[√] Flutter (Channel stable, 3.44.9, on Microsoft Windows [version 10.0.26200.9457], locale fr-FR)
[√] Windows Version (Windows 11 or higher, 25H2, 2009)
[√] Android toolchain - develop for Android devices (Android SDK version 37.0.0)
[√] Chrome - develop for the web
[√] Visual Studio - develop Windows apps (Visual Studio Build Tools 2026 18.9.0)
[√] Connected device (3 available)
[√] Network resources

• No issues found!

Cada linha começa com um símbolo: [√] (tudo certo), [!] (aviso: falta um elemento, o que não impede necessariamente o código de funcionar) ou [X] (erro). Para este curso, as linhas relevantes são [Flutter], [Android toolchain] (compilação para um celular [Android]) e [Connected device] (pelo menos um dispositivo detectado, especificamente o celular). As linhas [Chrome] (destino web) e [Visual Studio] (destino Windows) só se aplicam a esses destinos: um [!] ou um [X] em um destino que você não está usando pode ser ignorado.

Se o [Android toolchain] indicar “cmdline-tools component is missing”, instale o [Android SDK Command-line Tools] (veja adiante); se indicar “Android license status unknown”, aceite as licenças (etapa 5). O comando [flutter doctor -v] fornece detalhes sobre cada verificação.

PS C:\Data\st-2026\dev\flutter-nestjs-sept-2026\flutter_application_1> flutter doctor -v
[√] Flutter (Channel stable, 3.44.9, on Microsoft Windows [version 10.0.26200.9457], locale fr-FR) [305ms]
    • Flutter version 3.44.9 on channel stable at C:\Users\serge\flutter
    • Upstream repository https://github.com/flutter/flutter.git
    • Framework revision 6b182d2c75 (7 weeks ago), 2026-08-05 10:04:07 -0700
    • Engine revision 5a2a6a42cc
    • Dart version 3.12.2
    • DevTools version 2.57.0
    • Feature flags: enable-web, enable-linux-desktop, enable-macos-desktop, enable-windows-desktop,
      enable-android, enable-ios, cli-animations, enable-native-assets, enable-swift-package-manager,
      omit-legacy-version-file, enable-lldb-debugging, enable-uiscene-migration

[√] Windows Version (Windows 11 or higher, 25H2, 2009) [895ms]

[√] Android toolchain - develop for Android devices (Android SDK version 37.0.0) [1 793ms]
    • Android SDK at C:\Users\serge\AppData\Local\Android\sdk
    • Emulator version 37.1.11.0 (build_id 15917651) (CL:N/A)
    • Platform android-37.0, build-tools 37.0.0
    • Java binary at: C:\Program Files\Android\Android Studio\jbr\bin\java
      This is the JDK bundled with the latest Android Studio installation on this machine.
      To manually set the JDK path, use: `flutter config --jdk-dir="path/to/jdk"`.
    • Java version OpenJDK Runtime Environment (build 25.0.3+-15898627-b508.16)
    • All Android licenses accepted.

[√] Chrome - develop for the web [114ms]
    • Chrome at C:\Program Files\Google\Chrome\Application\chrome.exe

[√] Visual Studio - develop Windows apps (Visual Studio Build Tools 2026 18.9.0) [113ms]
    • Visual Studio at C:\Program Files (x86)\Microsoft Visual Studio\18\BuildTools
    • Visual Studio Build Tools 2026 version 18.9.12105.275
    • Windows 10 SDK version 10.0.26100.0

[√] Connected device (3 available) [216ms]
    • Windows (desktop) • windows • windows-x64    • Microsoft Windows [version 10.0.26200.9457]
    • Chrome (web)      • chrome  • web-javascript • Google Chrome 151.0.7922.174
    • Edge (web)        • edge    • web-javascript • Microsoft Edge 153.0.4234.48

[√] Network resources [274ms]
    • All expected network resources are available.

• No issues found!

Agora você já pode iniciar a aplicação Flutter, mesmo que o serviço web com o qual ela precisa se comunicar não tenha sido iniciado. Primeiro, liste os dispositivos reconhecidos pelo Flutter:

1
2
3
4
5
6
7
PS C:\Data\st-2026\dev\flutter-nestjs-sept-2026\rdvmedecins_flutter_client> flutter devices                 
Found 4 connected devices:
sdk gphone16k x86 64 (mobile) • emulator-5554 • android-x64    • Android 17 (API 37) (emulator)
Windows (desktop)             • windows       • windows-x64    • Microsoft Windows [version
10.0.26200.9457]
Chrome (web)                  • chrome        • web-javascript • Google Chrome 153.0.8010.48
Edge (web)                    • edge          • web-javascript • Microsoft Edge 153.0.4234.48

Na coluna 2, você encontra os identificadores dos dispositivos reconhecidos. Para iniciar a aplicação Flutter em um deles:

flutter run -d <device_id>

Por exemplo, para iniciar a aplicação no navegador Chrome com o identificador (chrome):

flutter run -d chrome

Isso produz o seguinte resultado (ou um erro de conexão com o servidor):

Image

Talvez você não tenha instalado o SDK do Android exigido pelo Flutter. Vamos agora descrever como instalá-lo.

2.1.2. Android Studio e ferramentas de linha de comando do Android

O destino mobile deste curso é um celular [Android]. Para compilar a aplicação e instalá-la nesse celular, o [Flutter] precisa do SDK do [Android], que é instalado junto com o [Android Studio], o ambiente de desenvolvimento do Google. O [Android Studio] não é usado para escrever código (o editor continua sendo o [VSCode]); aqui ele serve apenas para instalar e atualizar o SDK do [Android].

  1. [Android Studio]: baixe-o gratuitamente em [https://developer.android.com/studio] e instale-o. Ao iniciá-lo pela primeira vez, o assistente oferecerá uma instalação padrão: aceite-a, e ele baixará o SDK do [Android].

Image

  1. Abra o [SDK Manager] a partir do [Android Studio] (menu [Tools / SDK Manager] quando um projeto está aberto, ou [More Actions / SDK Manager] na tela inicial): essa é a ferramenta que instala e atualiza os componentes do SDK do [Android].
  2. Aba [SDK Platforms]: verifique se uma plataforma [Android] recente está instalada (a documentação do [Flutter] especifica a versão 36 no momento da redação).

Image

  1. Aba [SDK Tools]: marque [Android SDK Command-line Tools (latest)], [Android SDK Build-Tools] e [Android SDK Platform-Tools] (assim como o [Android Emulator] se quiser testar em um emulador) e clique em [Apply]. A documentação do [Flutter] também recomenda o [CMake] e o [NDK (Side by side)]. São os pacotes do [Android SDK Command-line Tools] que estão faltando quando o [flutter doctor] exibe “cmdline-tools component is missing”.
  2. Aceite as licenças do SDK do [Android] digitando o comando a seguir em um terminal dentro do projeto Flutter e respondendo “[y]” a cada pergunta, até ver a mensagem “All SDK package licenses accepted.”:
    flutter doctor --android-licenses
    

[Nota]: Com a versão 23.0 do [Android SDK Command-line Tools], o comando acima pode terminar imediatamente, sem perguntar nada, exibindo “The --licenses option is no longer needed.” Trata-se de um problema conhecido do [Flutter] (issues 191558 e 191487 em github.com/flutter/flutter). Solução alternativa: no [SDK Manager], aba [SDK Tools], marque [Show Package Details], substitua a versão 23.0 do [Android SDK Command-line Tools] pela versão 22.0, clique em [Apply], e então execute o comando novamente.

2.1.3. Criar um emulador Android

Se você não tem um celular, pode testar a aplicação em um emulador [Android]: um celular virtual que roda em uma janela do seu computador. O [Android Studio] instala o programa [Android Emulator] (se ele foi marcado no [SDK Manager], veja acima), mas não fornece um dispositivo virtual pronto para uso: é preciso criar um.

  1. [Pré-requisito]: a virtualização deve estar habilitada na [BIOS] do computador e, no [Windows], o recurso [Windows Hypervisor Platform] deve 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 ficará muito lento.
  2. Abra o [Device Manager] a partir do [Android Studio]: [More Actions / Virtual Device Manager] na tela inicial ou [Tools / Device Manager] quando um projeto está aberto (dependendo da versão: [View / Tool Windows / Device Manager]).

Image

  1. 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 usando o link [Download] ao lado dela; em seguida, clique em [Next] e em [Finish].

Image

Image

Image

  1. Inicie o emulador pelo botão [Play] do [Device Manager] ou a partir de um terminal (o primeiro comando lista os emuladores e seus IDs):
    flutter emulators
    flutter emulators --launch <id>
    

Image

  1. Aguarde até que a tela de boas-vindas do [Android] apareça na janela do emulador: a primeira inicialização pode levar vários minutos. Depois, verifique se o [Flutter] reconhece o emulador, que deve aparecer na lista (por exemplo, [emulator-5554], plataforma [android-x64]):
flutter devices
1
2
3
4
5
6
7
PS C:\Data\st-2026\dev\flutter-nestjs-sept-2026\rdvmedecins_flutter_client> flutter devices
Found 4 connected devices:
  sdk gphone16k x86 64 (mobile) • emulator-5554 • android-x64    • Android 17 (API 37) (emulator)
  Windows (desktop)             • windows       • windows-x64    • Microsoft Windows [version
  10.0.26200.9457]
  Chrome (web)                  • chrome        • web-javascript • Google Chrome 153.0.8010.48
  Edge (web)                    • edge          • web-javascript • Microsoft Edge 153.0.4234.48

[Nota]: se o comando [flutter devices] não exibir o emulador e mostrar a mensagem “Device emulator-5554 is offline”, o emulador não terminou de iniciar ou o [adb] (a ferramenta que conecta o computador ao dispositivo, instalada junto com o [Android SDK Platform-Tools]) está em um estado inconsistente. Tente o seguinte, nesta ordem: (1) aguarde a tela de boas-vindas aparecer e execute o comando novamente; (2) reinicie o [adb] com os três comandos a seguir (no [Windows], dentro do [PowerShell]), de modo que o último exiba “device” em vez de “offline”; (3) no [Device Manager], no menu [⋮] do dispositivo, selecione [Cold Boot Now] ou, em último caso, [Wipe Data].

1
2
3
& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" kill-server
& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" start-server
& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" devices

Se o problema persistir, use [where.exe adb] para verificar se não há outro [adb], de versão diferente, no [PATH]: duas versões do [adb] disputando a conexão causam esse problema.

Depois que o emulador for reconhecido, a aplicação é iniciada nele com o comando a seguir. Atenção: no emulador, [localhost] refere-se ao próprio emulador e não ao computador; o campo “Server URL” deve conter [http://10.0.2.2:8080] (veja o Capítulo 5).

flutter run -d emulator-5554

Image

2.1.4. Preparação do celular Android

Para executar a aplicação em um celular [Android] real, o celular precisa ser configurado para permitir o controle a partir do computador:

  1. Ative as opções do desenvolvedor: abra [Settings / About phone] e toque em [Build number] várias vezes (geralmente 7) até que o celular indique que você é um desenvolvedor. Os nomes exatos variam conforme o fabricante.
  2. Ative a [USB debugging] no menu [Developer options] (adicionado na etapa anterior).
  3. Conecte o celular ao computador com um cabo USB que transfira dados (e não apenas carregue o aparelho) e aceite o pedido de permissão de depuração USB no celular. 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]).
  4. Verifique se o [Flutter] detecta o celular: ele deve aparecer na lista exibida pelo comando a seguir, junto com a plataforma [android]:
    flutter devices
    

O celular acessará o servidor [NestJS] pelo endereço IP do computador na rede local (e não por [localhost]): essa configuração é descrita no Capítulo 5.