1. Introdução
O PDF deste documento está AQUI.
O código deste documento está AQUI.
Este documento é um produto de Claude, a IA da Anthropic. Ele segue o curso “Introdução passo a passo ao framework mobile Flutter”, do qual toma emprestados o roteiro, os exemplos e o estudo de caso, e o curso “Introdução passo a passo ao framework Angular”, do qual toma emprestadas as ferramentas:
- No curso [Flutter], a aplicação é um aplicativo mobile escrito em [Dart], cujo motor, o [Flutter], renderiza cada pixel por conta própria;
- No curso de [Angular], a aplicação é uma aplicação web: HTML, CSS e [TypeScript], executados por um navegador;
- Neste curso, a aplicação é AS DUAS COISAS: uma aplicação web, escrita com [Angular] e com componentes do framework [Ionic], que a ferramenta [Capacitor] empacota em uma aplicação [Android] instalada no celular. O mesmo código, sem nenhuma alteração, também roda em um navegador.
O servidor, por sua vez, permanece inalterado: é 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, francês e inglês), adaptadas para a tela de um celular.
O documento segue a mesma estrutura de seus predecessores: primeiro, numerosos exemplos curtos, cada um centrado em um conceito de [Ionic] ou [Angular], seguidos de um estudo de caso completo, o cliente [Ionic] da aplicação [RdvMedecins], cujos arquivos são todos comentados. Os 25 exemplos têm a mesma numeração e exibem as mesmas telas que os do curso de [Flutter] (e os dos cursos de [React] e [Vue.js] ): o leitor familiarizado com um desses frameworks reconhecerá os mesmos exemplos, escritos no estilo de [Ionic] e [Angular]. Cada exemplo também termina com uma comparação com o [Flutter].
Pressupõe-se que o leitor conheça os fundamentos da linguagem [TypeScript] e do framework [Angular]: eles são abordados nos cursos “Introdução à linguagem TypeScript por meio de exemplos” e “Introdução passo a passo ao framework Angular”. Mesmo assim, os conceitos de [Angular] utilizados (signals, templates, injeção de dependência, roteador, formulários reativos etc.) são revistos ao longo dos exemplos, conforme se tornam necessários.
1.1. O papel do Ionic em uma aplicação cliente/servidor
A aplicação tem duas partes, que se comunicam entre si apenas por meio de requisições HTTP:

- 1: a aplicação [Ionic], executada 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 para esse dia. Ele não gera nenhuma página;
- 3: a partir desses dados, o [Angular] atualiza a tela do celular.
Esta é exatamente a arquitetura dos clientes [Flutter], [React], [Vue.js] e [Angular]: a única diferença é o que gera a exibição. E, nesse aspecto, o [Ionic] é o oposto do [Flutter]. [Flutter] é um motor de renderização: não depende em nada do navegador e renderiza por conta própria cada pixel da tela. [Ionic], por outro lado, não renderiza nada: é uma biblioteca de web components: novos elementos HTML ([<ion-button>], [<ion-input>], [<ion-list>], [<ion-tabs>]...), criados com a ferramenta [Stencil] da equipe do [Ionic], que qualquer navegador sabe exibir. Esses componentes imitam os componentes nativos do celular em dois “modos”: [md] ([Material Design], a aparência do [Android]) e [ios] (a aparência do [iPhone]). Este curso impõe o modo [md] em todos os lugares, inclusive no navegador. Por serem simples elementos HTML, os componentes do [Ionic] podem ser usados com [Angular], [React] ou [Vue.js]: este curso os utiliza com [Angular] (o pacote [@ionic/angular]).
A aplicação é, portanto, uma aplicação web comum: uma página HTML, uma folha de estilos e código [JavaScript] compilado a partir de [TypeScript]. É o [Capacitor] (da mesma equipe do [Ionic]) que a transforma em uma aplicação [Android]:
- [Capacitor] gera um projeto [Android] nativo, cuja única tela é uma WebView: o motor do navegador [Chrome] do celular, em tela cheia, sem barra de endereço. A aplicação web compilada é copiada para esse projeto, e a WebView a carrega na inicialização. Para o usuário, é como qualquer outro aplicativo: um ícone, uma tela de abertura e o botão Voltar do [Android];
- o código [JavaScript] acessa os recursos do celular (armazenamento, câmera, notificações, geolocalização etc.) por meio de plugins do [Capacitor], que funcionam como uma ponte para o código nativo. Este curso usa dois deles: [@capacitor/preferences] (um pequeno repositório chave-valor no dispositivo, exemplo 20) e [CapacitorHttp] (requisições HTTP feitas pelo código nativo do [Android], exemplos 22 a 25);
- O mesmo código roda em um navegador, onde os plugins têm uma versão web (o armazenamento do [Capacitor] passa então a usar o [localStorage] do navegador). Assim, desenvolvemos no [Chrome], no tamanho de um celular, usando suas ferramentas de desenvolvimento, e depois passamos para o [Android] para testar.
As três camadas da aplicação e o que cada uma oferece:
- [Angular]: o framework da aplicação. Fornece os componentes (uma classe [TypeScript] e um template HTML), os signals (o estado, cujas mudanças atualizam a tela), a injeção de dependência (serviços, estado compartilhado), o roteador (um endereço por tela), os formulários, o cliente HTTP e os “pipes” (formatação). Os leitores do curso de [Flutter] reconhecerão o princípio: a interface é uma função do estado. Nunca modificamos a própria tela: mudamos o estado, e o [Angular] atualiza tudo o que depende dele;
- [Ionic]: os componentes de interface, que se parecem com os de um aplicativo mobile (barras de ferramentas, listas, campos, botões flutuantes, abas, janelas de alerta, calendário etc.), e a navegação de um aplicativo mobile: uma pilha de páginas, animada como no [Android], da qual o botão Voltar retira a página do topo;
- [Capacitor]: o aplicativo [Android] e o acesso ao celular.
Ao contrário do [Flutter], não são necessários pacotes adicionais para a comunicação com um servidor: o [Angular] fornece o cliente HTTP, o roteador, os formulários e a injeção de dependência; o [JavaScript], junto com o objeto [Intl], fornece a formatação de datas e números para cada idioma; a biblioteca [RxJS], incluída com o [Angular], fornece fluxos assíncronos de dados. As traduções (Exemplo 21) ficam a cargo de uma pequena classe escrita especificamente para esse fim, que lê os dicionários JSON.
1.2. Ferramentas utilizadas
Os exemplos foram escritos e testados com as seguintes ferramentas (sua instalação é descrita no próximo capítulo e no apêndice):
- [Node.js] 24 e seu gerenciador de pacotes [npm]: o [Angular CLI] 22 exige o [Node.js] 22.22.3 (ou uma versão 22 mais recente), 24.15 ou superior, ou 26 e posteriores. O [Node.js] também executa o servidor JSON;
- [Angular CLI] 22.2 (o comando [ng]), o [Angular] 22.2 e o [TypeScript] 6.0;
- [Ionic] 9.0 (o pacote [@ionic/angular] 9.0.6) e seus ícones, [ionicons] 8.1;
- [Capacitor] 8.5 (os pacotes [@capacitor/core], [@capacitor/android] e [@capacitor/cli]) e seu plugin [@capacitor/preferences] 8.0;
- o editor [Visual Studio Code] e suas extensões [Angular Language Service] e [Ionic];
- [Android Studio], para o SDK [Android], seu JDK e seu gerenciador de emuladores: um emulador [Android] (um celular simulado no computador) ou um celular [Android] real conectado ao computador;
- o navegador [Chrome], para desenvolver e depurar a aplicação, tanto no computador quanto no celular;
- o SGBD [MySQL] (ou [MariaDB]), por exemplo, o do [Laragon] no [Windows]: ele é necessário para o 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 utilizados são os dos arquivos [package.json] dos dois projetos [Ionic], que são idênticos: os [@angular/...] 22.2, [@ionic/angular] 9.0, [ionicons] 8.1, [@capacitor/...] 8.5, [@capacitor/app] 8.1, [@capacitor/preferences] 8.0, [rxjs] 7.8 e, somente para desenvolvimento, [typescript] 6.0, [prettier] 3 (formatação do código) e [playwright] 1.56 (capturas de tela).
1.3. Capturas de tela
As capturas de tela deste documento foram geradas automaticamente por programas que usam a biblioteca [Playwright] (pastas [captures/] dos dois projetos [Ionic]). O programa [captures/captures.mjs] controla um navegador [Chromium] (a versão livre do [Chrome]) no tamanho de um celular [Android]: 412 x 892 pontos, a 2,625 pixels por ponto, resultando em imagens de 1082 x 2342 pixels. Para cada exemplo, ele executa um “cenário” da pasta [captures/scenarios/]: abre a página do exemplo, interage com ela como um usuário faria (digitando texto, pressionando botões) e, em seguida, salva a tela como um arquivo de imagem.
São, portanto, capturas reais da aplicação, renderizadas pelo motor do [Chrome], o mesmo usado pela WebView do celular; faltam apenas a barra de status do celular (hora, bateria) e o teclado na tela. O leitor pode recriá-las (a aplicação deve estar em execução; veja abaixo):
- linha 1: uma única vez: baixa o navegador [Chromium] usado pelo [Playwright];
- linha 2: recria todas as capturas na pasta [captures/images/];
- linha 3: recria apenas as dos exemplos 05 e 17.
As capturas dos exemplos 22 a 25 e do estudo de caso também exigem que o servidor JSON esteja em execução em “modo de teste” para o CAPTCHA (veja o capítulo que descreve o servidor).
1.4. Os exemplos
O código deste documento está organizado em três pastas:
Os exemplos formam um único projeto [Ionic]: uma página inicial, o menu de exemplos e uma página por exemplo, cada uma em sua própria pasta [src/app/] (o Exemplo 01 apresenta o projeto em detalhes):
As pastas [node_modules/] (os pacotes) e [android/] (o projeto [Android]) não são fornecidas: a primeira é preenchida por [npm install] e a segunda é gerada pelo [Capacitor]. Em um console aberto na pasta [examples_ionic] (no [VS Code]: menu Terminal / Novo Terminal):
- Linha 1: uma única vez, para todos os exemplos: baixa os pacotes descritos em [package.json] para a pasta [node_modules/];
- linha 2: inicia o [ng serve], o servidor de desenvolvimento do [Angular], no endereço [http://localhost:8100].
Abra este endereço no [Chrome]: a página inicial lista os 25 exemplos, agrupados por capítulo; tocar em um exemplo o abre, e o botão Voltar de sua barra de ferramentas leva de volta ao menu. Também é possível ir diretamente a um exemplo pelo seu endereço: [http://localhost:8100/ex05] para o exemplo 05, por exemplo. Para ver a aplicação no tamanho de um celular, abra as ferramentas de desenvolvimento (F12) e, em seguida, a barra de emulação de dispositivos (Ctrl+Shift+M). Enquanto o [ng serve] estiver em execução, cada alteração de arquivo é compilada e aplicada imediatamente no navegador; Ctrl+C o interrompe.
No [Android], a aplicação de exemplo é instalada de uma só vez, com seus 25 exemplos e o menu:
- Linha 1: executar uma única vez: cria a pasta [android/] e um projeto [Android Studio] completo;
- Linha 2: compila a aplicação web na pasta [dist/examples_ionic/browser/];
- Linha 3: copia-a para o projeto [Android];
- linha 4: compila a aplicação [Android], instala-a em um emulador em execução ou em um celular conectado (o comando pergunta qual, se houver vários) e a inicia.
As linhas 2 a 4 devem ser executadas novamente após cada alteração no código. O Exemplo 01 também mostra como ativar o recarregamento automático do [ng serve] no celular.
Os exemplos 22 a 25 consultam os servidores JSON e [RdvMedecins]: é preciso tê-los instalados e em execução, como explicado no capítulo dedicado a eles. No navegador, o servidor de desenvolvimento lhes envia as requisições [/api] (arquivo [proxy.conf.json]); no emulador, eles se conectam ao servidor no endereço [http://10.0.2.2:8080] (veja o Exemplo 22).
1.5. Conteúdo do documento
Capítulo | Conteúdo | Exemplos |
Primeiros passos com o Ionic | um projeto Ionic (Angular + Capacitor), componentes Ionic, estado (signal, computed, effect), templates (@if, @for), eventos, todos os tipos de campos, um reducer, validação, formulários reativos, formatação (Intl, pipes) | 01 a 09 |
Componentes | Entradas (input), saídas (output, model), composição (projeção de conteúdo, ng-template), ciclo de vida, injeção de dependência (serviços, inject), diretivas e animações, caixa de diálogo de confirmação (AlertController) | 10 a 16 |
Roteamento | O roteador do Angular e o ion-router-outlet: rotas, parâmetros, shell com ion-tabs, carregamento tardio (lazy loading), página 404, guards | 17 e 18 |
Operações assíncronas e estado compartilhado | Promise, Observable (RxJS), timers, antirrepique (debounce), respostas obsoletas, async pipe, toSignal, resource, um serviço baseado em signals, @capacitor/preferences, tema escuro | 19 e 20 |
Internacionalização | Um aplicativo em francês e inglês | 21 |
O servidor RdvMedecins, uma caixa-preta | Instalação do servidor JSON, sua API, exemplos com curl | - |
Interação com o servidor | HttpClient, o proxy de desenvolvimento, o endereço do servidor, CapacitorHttp no Android, o cookie de token httpOnly (armazenado pelo navegador ou pelo Android), uma camada de acesso à API, erros do servidor | 22 a 25 |
Estudo de caso | o cliente Ionic da aplicação RdvMedecins | - |
Implantação | O cliente web compilado, servido pelo servidor JSON; a aplicação 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.