Skip to content

2. Configuração do ambiente de trabalho

2.1. Instalação das ferramentas

  1. Node.js: baixe e instale a versão 22 (ou posterior) em nodejs.org. Verifique a instalação em um terminal:

    node --version
    npm --version
    
  2. Visual Studio Code (VSCode): disponível para download gratuito em code.visualstudio.com. Instale a extensão [Flutter] (que também instala a extensão [Dart]).

  3. [MySQL] 8: instale, por exemplo, por meio do XAMPP, Laragon (no Windows) ou diretamente pelo [MySQL] Community Server. Uma ferramenta gráfica de administração (phpMyAdmin, [MySQL] Workbench, DBeaver, HeidiSQL…) simplifica o trabalho. Mais adiante, usa-se a ferramenta Laragon.

2.2. Instalação do cliente Flutter

Inicie o VSCode sem especificar um projeto:

Image

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

Image

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

Image

  • em [4], crie um aplicativo;

Image

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

Image

  • em [6], dê um nome ao projeto. Esse será também o nome da pasta criada para o projeto;

Image

  • Em [1-3], especifique os alvos do projeto em [1 – aplicativo Android, 2 – aplicativo desktop, 3 – aplicativo web];

Image

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

O comando [flutter doctor] verifica se tudo o que o [Flutter] precisa está no lugar, alvo por alvo. Execute-o em um terminal do VSCode no projeto Flutter recém-criado:

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] (alvo web) e [Visual Studio] (alvo Windows) aplicam-se apenas a esses alvos: um [!] ou um [X] em um alvo que você não usa pode ser ignorado.

Se o [Android toolchain] informar “cmdline-tools component is missing”, instale o [Android SDK Command-line Tools] (veja abaixo); se informar “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, liste os aplicativos (dispositivos) reconhecidos pelo Flutter:

1
2
3
4
5
6
7
PS ...> 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 IDs dos dispositivos reconhecidos. Para iniciar o aplicativo Flutter em um deles:

flutter run -d <device_id>

Por exemplo, para iniciar o aplicativo [flutter_application_1] no navegador Edge:

flutter run -d edge

O seguinte resultado aparece no navegador Edge:

Image

Descreveremos agora como instalar as ferramentas para o desenvolvimento Android.

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

O dispositivo-alvo deste curso é um celular [Android]. Para compilar o aplicativo e instalá-lo 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] —; ele serve aqui 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] (o menu [Tools / SDK Manager] quando um projeto está aberto, ou [More Actions / SDK Manager] na tela inicial): é ele que instala e atualiza os componentes do SDK do [Android].
  1. 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] (bem 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 [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 execute o comando novamente.

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 que é executado em uma janela do computador. O [Android Studio] instala o programa [Android Emulator] (se ele tiver sido 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; depois, clique em [Next] e em [Finish].

Image

Image

Image

  1. Inicie o emulador usando o botão [Play] do [Device Manager]:

Image

  1. Aguarde até que a tela inicial do [Android] apareça na janela do emulador: a primeira inicialização pode levar vários minutos. Em seguida, 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, mas 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], no [PowerShell]), sendo que o último deve exibir “device” em vez de “offline”; (3) no menu do dispositivo em [Device Manager] ([⋮]), 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 uma versão diferente, presente no [PATH]: duas versões do [adb] disputando a conexão causam esse problema.

Depois que o emulador for reconhecido, o aplicativo é iniciado nele com o comando a seguir (veja a seção “Instalação e execução”):

flutter run -d emulator-5554

Image

Preparação do celular Android

Para executar o aplicativo em um celular [Android] real, o celular deve ser configurado para permitir o controle a partir do computador:

  1. Habilite 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 rótulos exatos variam conforme o fabricante.
  2. Habilite a [USB debugging] no menu [Developer options] (adicionado na etapa anterior).
  3. Conecte o celular ao computador usando 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]).
  4. Verifique se o [Flutter] consegue detectar 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] por meio do endereço IP do computador na rede local (e não por meio de [localhost]): essa configuração é descrita no Capítulo 5.