1. Introdução
O PDF do documento está AQUI.
Os códigos do documento estão AQUI.
Este documento é um produto da IA Claude, da Anthropic. Ele segue o curso “Introdução passo a passo ao framework web React”, do qual toma emprestados o roteiro, os exemplos e o estudo de caso, mudando o alvo:
- Nos cursos [React], [Vue.js] e [Angular], o aplicativo é executado em um navegador; ele é construído com HTML, CSS e [JavaScript];
- Neste curso, o aplicativo é um aplicativo mobile, escrito com o framework [Flutter] e a linguagem [Dart], executado em um celular [Android]. O mesmo código, sem nenhuma alteração, também gera um aplicativo web (e um aplicativo [Windows], [macOS], ou [Linux] ).
O servidor, porém, continua o mesmo: é o servidor JSON [RdvMedecins] das lições anteriores, escrito com [NestJS]. E as telas do aplicativo são as que os leitores das outras lições já conhecem (login com CAPTCHA, agenda do médico, janela de consulta, portal do paciente, gerenciamento de médicos e clientes, criação de conta, inglês e francês), adaptadas para a tela de um celular.
O documento segue a mesma estrutura de seus antecessores: primeiro, vários exemplos curtos, cada um focado em um conceito de [Flutter], seguidos de um estudo de caso completo — o cliente [Flutter] do aplicativo [RdvMedecins] — com todos os arquivos totalmente comentados. Os 25 exemplos têm os mesmos números dos do curso de [React]: os leitores familiarizados com [React], [Vue.js] ou [Angular] encontrarão os mesmos exemplos, escritos no estilo de [Flutter].
Já existe um curso sobre este tema: Um exemplo cliente/servidor com Flutter / NestJS (2026), que apresenta um cliente completo logo de início. Este documento difere em sua abordagem: aprendemos [Flutter] passo a passo, por meio de pequenos exemplos, antes de abordar o cliente completo; e o servidor é tratado como uma caixa-preta, da qual só nos interessam a API e o JSON.
Pressupõe-se um conhecimento básico da linguagem [Dart]: esses fundamentos são abordados no curso “Introdução à linguagem Dart por meio de exemplos” (2026). No entanto, os recursos da linguagem específicos de [Flutter] (parâmetros nomeados, classes, [async] / [await], coleções etc.) são revisados ao longo dos exemplos à medida que são usados.
1.1. O papel do Flutter em um aplicativo cliente/servidor
O aplicativo tem duas partes, que se comunicam entre si apenas por meio de requisições HTTP:

- 1: O aplicativo [Flutter], executado no celular, envia uma requisição HTTP ao servidor, por exemplo, [GET /api/schedule?doctorId=1&day=2026-10-05];
- 2: O servidor responde com dados JSON: a agenda desse médico naquele dia. Ele não gera nenhuma página;
- 3: Com esses dados, o [Flutter] atualiza a tela do celular.
Esta é exatamente a arquitetura dos clientes [React], [Vue.js] e [Angular]: a única diferença é o que gera a exibição. Enquanto um navegador constrói uma página a partir de HTML e CSS, o [Flutter] desenha cada pixel da tela por conta própria, usando seu próprio motor gráfico. Ele não usa os componentes do sistema (os botões do [Android] ou do [iOS]): ele os imita ou fornece os seus próprios. É isso que lhe permite exibir o mesmo aplicativo, pixel a pixel, em um celular [Android], em um [iPhone], em um navegador ou em um computador.
[Flutter] é um framework criado pelo [Google] e lançado em 2018. Atualmente é o framework mais usado para escrever aplicativos mobile para [Android] e [iOS] a partir de uma única base de código. Ele se baseia em três conceitos centrais:
- tudo é um widget: a tela é descrita por uma árvore de widgets, objetos que representam cada um uma parte da interface — como um texto, um botão, uma margem, uma coluna ou uma tela inteira. Você cria seus próprios widgets combinando os fornecidos pelo [Flutter];
- a interface é uma função do estado: um widget tem um método [build()] que descreve o que exibir com base em seus dados. Quando os dados mudam ([setState()]), o [Flutter] chama [build()], compara a nova árvore com a antiga e redesenha o que mudou. Nunca escrevemos código que modifica a tela: descrevemos a tela com base em seu estado. Os leitores do curso de [React] reconhecerão esse princípio: é o mesmo dos componentes e do [useState];
- uma linguagem, [Dart], compilada em código de máquina para o celular (resultando em aplicativos rápidos), ou em [JavaScript] ou [WebAssembly] para o navegador. Durante o desenvolvimento, o [Dart] permite o hot reload: uma alteração no código é aplicada ao aplicativo em execução em um segundo, sem perder seu estado.
Assim como o [React], o [Flutter] não é um framework “completo” para a comunicação com um servidor: o cliente HTTP, o roteador, o estado compartilhado e as traduções são fornecidos por pacotes (bibliotecas) publicados no site pub.dev. Este curso usa os pacotes recomendados na documentação do [Flutter] e mantidos, em sua maioria, pela própria equipe do [Flutter]: [http] (requisições HTTP), [go_router] (o roteador), [provider] (estado compartilhado), [shared_preferences] (armazenamento no dispositivo), [intl] (datas e números em cada idioma), [flutter_svg] (imagens SVG).
1.2. Ferramentas utilizadas
Os exemplos foram escritos e testados com as seguintes ferramentas (sua instalação é descrita no apêndice):
- o SDK do [Flutter] 3.44, que inclui o SDK do [Dart] 3.12;
- o editor [Visual Studio Code] e sua extensão [Flutter] (que também instala a extensão [Dart]);
- [Android Studio], apenas pelo seu gerenciador de emuladores, e o SDK do [Android]: um emulador [Android] (um celular simulado no computador) ou um celular [Android] real conectado ao computador;
- o navegador [Chrome], para a versão web dos aplicativos;
- o SGBD [MySQL] (ou [MariaDB]), por exemplo, o do [Laragon] no [Windows] , e o [Node.js]: eles são exigidos pelo servidor JSON, como descrito no capítulo que o apresenta;
- a ferramenta de linha de comando [curl], que exibe as respostas HTTP brutas.
Os pacotes usados são os dos arquivos [pubspec.yaml]: [go_router] 16, [provider] 6, [http] 1.5, [shared_preferences] 2.5, [flutter_svg] 2, [intl], e os pacotes [flutter_localizations] e [flutter_test] incluídos no [Flutter].
1.3. Capturas de tela
As capturas de tela deste documento foram geradas automaticamente por testes do [Flutter] (pastas [test/captures] dos projetos): cada teste inicia um exemplo, interage com ele como um usuário faria (digitando texto, tocando em botões) e, em seguida, instrui o motor do [Flutter] a renderizar a tela como um arquivo de imagem na resolução de um celular [Android] (1080 x 2340 pixels). São, portanto, telas reais do aplicativo, renderizadas pelo mesmo motor que roda no celular; os únicos elementos ausentes são a barra de status do celular (hora, bateria) e o teclado na tela. O capítulo do primeiro exemplo mostra o mesmo aplicativo em execução em um emulador [Android].
1.4. Os exemplos
O código deste documento está organizado em três pastas:
Os exemplos formam um único projeto [Flutter], com cada exemplo em uma pasta dentro de [lib/]:
As pastas específicas de cada plataforma ([android/], [web/], [windows/]) não são fornecidas por inteiro: são pequenos projetos — [Android] (web) e [Windows] — que o [Flutter] pode gerar e que dependem da versão do [Flutter] instalada. Você os gera uma vez e depois baixa os pacotes em um console aberto na pasta [examples_flutter] (no [VS Code]: menu Terminal / Novo Terminal):
[flutter create .] (o ponto indica a pasta atual) completa o projeto sem modificar os arquivos existentes: o arquivo [android/app/src/main/AndroidManifest.xml] fornecido (veja o Exemplo 22) é preservado. Se você pular essa etapa, o comando [flutter run] falha em um celular com uma mensagem enganosa: “Build failed due to use of deleted Android v1 embedding” (o [Flutter] não encontra o projeto [Android] e presume que ele é muito antigo).
Em seguida, execute um exemplo especificando o arquivo [main.dart] com a opção [-t] (de “target”):
O comando [flutter run] pergunta em qual dispositivo executar o aplicativo se encontrar vários (um emulador [Android], o [Chrome], o [Windows]...). Você pode especificá-lo com a opção [-d] (de “device”):
Enquanto o aplicativo está em execução, o console aceita alguns comandos de uma letra: r (hot reload: as alterações no código são aplicadas e o estado é preservado), R (hot restart: o aplicativo reinicia do zero), q (parar). No [VS Code], você também pode abrir o arquivo do exemplo [main.dart] e pressionar F5; o dispositivo é então selecionado na barra de status, no canto inferior direito da janela.
Os exemplos 22 a 25 consultam os servidores JSON e [RdvMedecins]: você precisará tê-los instalados e em execução, conforme explicado no capítulo dedicado a eles.
1.5. Conteúdo do documento
Capítulo | Conteúdo | Exemplos |
Primeiros passos | Um projeto Flutter, widgets, estado (setState), eventos, campos de entrada, um reducer, validação, Form e FormField, formatação (intl) | 01 a 09 |
Widgets | parâmetros, funções como parâmetros, composição (child, builders), ciclo de vida, dados herdados (InheritedWidget), comportamentos reutilizáveis (mixins, animações), caixa de diálogo de confirmação | 10 a 16 |
Roteamento | go_router: rotas, parâmetros, shell, redirecionamentos, guards | 17 e 18 |
Processamento assíncrono e estado compartilhado | Future, Stream, timers, debounce, respostas expiradas, FutureBuilder, StreamBuilder, provider, shared_preferences | 19 e 20 |
Internacionalização | Um aplicativo em francês e inglês | 21 |
O servidor, uma caixa-preta | Instalação do servidor JSON, sua API, exemplos de curl | - |
Comunicação com o servidor | O pacote http, o endereço do servidor, o cookie de token, uma camada de acesso à API, um view model, erros do servidor | 22–25 |
Estudo de caso | O cliente Flutter do aplicativo RdvMedecins | - |
Implantação | O cliente web compilado, servido pelo servidor JSON; o aplicativo Android | - |
Cada exemplo é apresentado com seu código completo, comentado linha a linha, e capturas de tela de sua execução. O próprio código é amplamente comentado: esses comentários fazem parte do curso.