13. Apêndices
13.1. Instalação do Node.js
O [Node.js] pode ser baixado em nodejs.org: escolha a versão LTS (suporte de longo prazo) 24 ou a versão 22 a partir da 22.22: isso é exigido pelo [React Router] 8 (o [Vite] 8 exige apenas a 20.19). O instalador do [Windows] também instala o [npm]. Verifique a instalação em um console:
Para executar várias versões do [Node.js] na mesma máquina, você pode usar o [nvm-windows] (no [Windows]) ou o [nvm] (no [Linux] e no [macOS]).
Os exemplos e o estudo de caso não exigem, em geral, a instalação de nenhuma ferramenta: o [Vite], o [TypeScript] (e, para o servidor, a ferramenta [nest]) fazem parte das dependências de cada projeto, instaladas por [npm install]. Os scripts do [package.json] ([npm start], [npm run build]) os localizam na pasta [node_modules]. Para criar você mesmo um novo projeto, pode usar [npm create vite@latest my-project -- --template react-ts] sem instalar nada.
13.2. Instalação do Visual Studio Code
O [Visual Studio Code] pode ser baixado em code.visualstudio.com. Ele inclui JSX e [TypeScript] por padrão: autocompletar de código, verificação de tipos enquanto você digita, navegação de um componente ([<InputField>]) até sua definição e renomeação de uma prop em todo o projeto. Nenhuma extensão é necessária; você pode adicionar o ESLint (junto com as regras [eslint-plugin-react-hooks], que sinalizam dependências ausentes em [useEffect] e hooks chamados condicionalmente) pelo painel Extensões (Ctrl-Shift-X).
Abra um projeto pelo menu File / Open Folder (a pasta [examples-react], por exemplo) e abra um console nela pelo menu Terminal / New Terminal.
13.3. A extensão React Developer Tools
A extensão React Developer Tools pode ser instalada pela loja de extensões do [Chrome], do [Edge] ou do [Firefox] . Ela adiciona duas abas às ferramentas de desenvolvedor do navegador (F12):
- “Components”: a árvore de componentes da página (não a árvore de tags HTML) e, para cada componente, suas props, seu estado e seus hooks ([useState], [useContext]...) com seus valores; o componente que o renderizou;
- “Profiler”: um registrador que mostra quais componentes foram renderizados novamente a cada atualização, por quê (“props changed”, “hook 2 changed” etc.) e quanto tempo levou.
Você pode modificar uma prop ou um estado ali e ver a página se atualizar: uma excelente maneira de entender quando e por que um componente é renderizado novamente. A opção “Highlight updates when components render” faz cada componente renderizado novamente piscar na página.
13.4. Instalação do MySQL com o Laragon
O servidor JSON requer o [MySQL] (ou o [MariaDB]). O [Laragon] (laragon.org) instala um deles no [Windows], pronto para uso, junto com a ferramenta de administração [HeidiSQL]. Após a instalação:
- o botão “Start All” inicia o servidor [MySQL] na porta 3306;
- o usuário [root] não tem senha: esses são os valores padrão do arquivo [.env.example] do servidor;
- No [HeidiSQL] (botão “Database”), o item de menu File / Run SQL File executa o script [database/dbrdvmedecins2.sql].
No [Linux] ou no [macOS], instale o [MySQL] ou o [MariaDB] usando o gerenciador de pacotes do sistema e execute o script com o cliente de linha de comando: [mysql -u root -p < database/dbrdvmedecins2.sql].
13.5. Instalação do curl
O [curl] vem incluído no [Windows] versões 10 e 11, no [macOS] e na maioria das distribuições do [Linux]. Verifique sua versão:
A opção [--json], usada neste documento, está disponível desde a versão 7.82 (2022). Se você usa uma versão mais antiga, substitua [--json @file] por [-H "Content-Type: application/json" -d @file], ou instale uma versão recente a partir de curl.se.
No [PowerShell], você deve digitar [curl.exe], e não [curl]: no [PowerShell], [curl] é um alias de outro comando ([Invoke-WebRequest]), que não inclui as opções do [curl]. O prompt de comando ([cmd]) não tem esse problema.