13. Apéndices
13.1. Instalación de Node.js
[Node.js] puede descargarse desde nodejs.org: elija la versión LTS (soporte a largo plazo) 24, o la versión 22 a partir de la 22.22: así lo exige [React Router] 8 ([Vite] 8 solo requiere la 20.19). El instalador de [Windows] también instala [npm]. Verifique la instalación en una consola:
Para ejecutar varias versiones de [Node.js] en la misma máquina, se puede usar [nvm-windows] (en [Windows]) o [nvm] (en [Linux] y [macOS]).
Los ejemplos y el caso de estudio no requieren, en general, la instalación de ninguna herramienta: [Vite], [TypeScript] (y, para el servidor, la herramienta [nest]) forman parte de las dependencias de cada proyecto, instaladas por [npm install]. Los scripts de [package.json] ([npm start], [npm run build]) las localizan en la carpeta [node_modules]. Para crear usted mismo un nuevo proyecto, puede usar [npm create vite@latest my-project -- --template react-ts] sin instalar nada.
13.2. Instalación de Visual Studio Code
[Visual Studio Code] puede descargarse desde code.visualstudio.com. Incluye JSX y [TypeScript] de forma predeterminada: autocompletado de código, verificación de tipos mientras se escribe, navegación desde un componente ([<InputField>]) hasta su definición y cambio de nombre de una prop en todo el proyecto. No se requiere ninguna extensión; se puede agregar ESLint (junto con las reglas [eslint-plugin-react-hooks], que señalan las dependencias faltantes en [useEffect] y los hooks invocados condicionalmente) desde el panel Extensiones (Ctrl-Shift-X).
Abra un proyecto mediante el menú File / Open Folder (la carpeta [examples-react], por ejemplo) y abra una consola dentro de él mediante el menú Terminal / New Terminal.
13.3. La extensión React Developer Tools
La extensión React Developer Tools puede instalarse desde la tienda de extensiones de [Chrome], [Edge] o [Firefox]. Agrega dos pestañas a las herramientas para desarrolladores del navegador (F12):
- “Components”: el árbol de componentes de la página (no el árbol de etiquetas HTML) y, para cada componente, sus props, su estado y sus hooks ([useState], [useContext]...) junto con sus valores; el componente que lo renderizó;
- “Profiler”: un registrador que muestra qué componentes se volvieron a renderizar en cada actualización, por qué (“props changed”, “hook 2 changed”, etc.) y cuánto tiempo tomó.
Allí se puede modificar una prop o un estado y ver cómo se actualiza la página: una excelente manera de entender cuándo y por qué se vuelve a renderizar un componente. La opción “Highlight updates when components render” hace que cada componente que se vuelve a renderizar parpadee en la página.
13.4. Instalación de MySQL con Laragon
El servidor JSON requiere [MySQL] (o [MariaDB]). [Laragon] (laragon.org) instala uno en [Windows], listo para usar, junto con la herramienta de administración [HeidiSQL]. Después de la instalación:
- el botón “Start All” inicia el servidor [MySQL] en el puerto 3306;
- el usuario [root] no tiene contraseña: son los valores por defecto del archivo [.env.example] del servidor;
- En [HeidiSQL] (el botón “Database”), la opción de menú File / Run SQL File ejecuta el script [database/dbrdvmedecins2.sql].
En [Linux] o [macOS], instale [MySQL] o [MariaDB] mediante el administrador de paquetes del sistema y ejecute el script con el cliente de línea de comandos: [mysql -u root -p < database/dbrdvmedecins2.sql].
13.5. Instalación de curl
[curl] viene incluido con las versiones 10 y 11 de [Windows] , [macOS], y la mayoría de las distribuciones de [Linux]. Verifique su versión:
La opción [--json], usada en este documento, está disponible desde la versión 7.82 (2022). Si usa una versión anterior, reemplace [--json @file] por [-H "Content-Type: application/json" -d @file], o instale una versión reciente desde curl.se.
Para [PowerShell], debe escribir [curl.exe] y no [curl]: en [PowerShell], [curl] es un alias de otro comando ([Invoke-WebRequest]), que no incluye las opciones de [curl]. El símbolo del sistema ([cmd]) no tiene este problema.