2. Capítulo 1 - Configuração do ambiente de trabalho
2.1. Instalar as ferramentas
- Node.js: baixe e instale a versão 22 (ou posterior) a partir de nodejs.org. Verifique a instalação em um terminal:
- 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).
- [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.
- Postman: disponível para download gratuito em postman.com.
2.1.1. Instalação do cliente Flutter
Inicie o VSCode sem selecionar nenhum projeto:

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

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

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

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

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

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

- 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:


- 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:

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:
Quando tudo estiver correto, você obterá um resultado como este (os números de versão podem variar):
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.
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:
Na coluna 2, você encontra os identificadores dos dispositivos reconhecidos. Para iniciar a aplicação Flutter em um deles:
Por exemplo, para iniciar a aplicação no navegador Chrome com o identificador (chrome):
Isso produz o seguinte resultado (ou um erro de conexão com o servidor):

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].
- [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].

- 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].
- 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).

- 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”.
- 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.”:
[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.
- [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.
- 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]).

- 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].



- 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):

- 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]):
[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].
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).

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:
- 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.
- 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 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]).
- Verifique se o [Flutter] detecta o celular: ele deve aparecer na lista exibida pelo comando a seguir, junto com a plataforma [android]:
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.