13. Apêndices
13.1. Instalação do Node.js
O [Node.js] pode ser baixado em nodejs.org: selecione a versão LTS (suporte de longo prazo), de preferência a 22 (o [Vite] 7 exige no mínimo a versão 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 a instalação de nenhuma ferramenta global: [Vite], [TypeScript], [vue-tsc] (e, para o servidor, a ferramenta [nest]) fazem parte das dependências de cada projeto, instaladas pelo [npm install].
13.2. Instalação do Visual Studio Code
O [Visual Studio Code] é baixado em code.visualstudio.com. Para os arquivos [.vue], instale a extensão Vue (Official) (publicador Vue.volar) no painel Extensions (Ctrl+Shift+X): realce de sintaxe, autocompletar código, verificação de tipos ([TypeScript]) nos templates e navegação até a definição de um componente ou de uma prop.
Abra um projeto pelo menu File / Open Folder (a pasta [examples-vuejs], por exemplo) e abra um console dentro dele pelo menu Terminal / New Terminal.
13.3. A extensão Vue.js devtools
A extensão Vue.js devtools pode ser instalada a partir da loja de extensões do [Chrome], [Edge], ou [Firefox]. Ela adiciona uma aba “Vue” às ferramentas de desenvolvedor do navegador (F12), que exibe:
- a árvore de componentes da página e, para cada componente, suas props e seu estado ([ref], [reactive], [computed]);
- os stores [Pinia] e seus conteúdos;
- as rotas do roteador e a rota atual;
- uma linha do tempo dos eventos emitidos pelos componentes.
Você pode modificar um dado ali e ver a página se atualizar: uma excelente forma de entender a reatividade.
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 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] já vem incluído nas versões 10 e 11 do [Windows] , 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ê estiver usando uma versão mais antiga, substitua [--json @file] por [-H "Content-Type: application/json" -d @file], ou instale uma versão recente em curl.se.
No [PowerShell], é preciso 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.