Skip to content

13. Apêndices

13.1. Instalação do Node.js

[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.3: são as versões exigidas pelo [Angular] 22. O instalador do [Windows] também instala o [npm]. Verifique a instalação em um console:

node --version
npm --version

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: o [Angular CLI] (o comando [ng]), o compilador do [Angular], [TypeScript] (e, para o servidor, a ferramenta [nest]) fazem parte das dependências de cada projeto, instaladas por [npm install]. Os scripts de [package.json] ([npm start], [npm run build]) encontram essas ferramentas na pasta [node_modules]. Para criar um novo projeto por conta própria, você pode usar [npx @angular/cli new my-project] sem instalar nada.

13.2. Instalação do Visual Studio Code

[Visual Studio Code] pode ser baixado em code.visualstudio.com. Para o [Angular], instale a extensão Angular Language Service (editor Angular) no painel Extensões (Ctrl+Shift+X): preenchimento de código e verificação de tipos nos templates, navegação de um seletor ([<app-input-field>]) para a classe do componente, de um [templateUrl] para o arquivo do template e destaque em tempo real dos erros do compilador do [Angular] enquanto você digita.

Abra um projeto pelo menu Arquivo / Abrir Pasta (a pasta [examples-angular], por exemplo) e abra um console nela pelo menu Terminal / Novo Terminal.

13.3. A extensão Angular DevTools

A extensão Angular DevTools pode ser instalada na loja de extensões do [Chrome], [Edge], ou [Firefox]. Ela adiciona uma aba "Angular" às ferramentas do desenvolvedor do navegador (F12), que exibe o seguinte para uma aplicação em execução em modo de desenvolvimento:

  • a árvore de componentes da página e, para cada componente, seus inputs, outputs e propriedades (signals e seus valores);
  • o grafo de signals de um componente: qual [computed] depende de qual signal;
  • os serviços injetados e a árvore de injetores;
  • as rotas do roteador;
  • um profiler, que mede o tempo gasto na atualização de cada componente.

Você pode modificar um dado ali e ver a página se atualizar: uma excelente maneira de entender a reatividade.

13.4. Instalação do MySQL com o Laragon

O servidor JSON requer o [MySQL] (ou o [MariaDB]). [Laragon] (laragon.org) instala um deles no [Windows], pronto para uso, 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

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

curl --version

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