Skip to content

14. Apéndices

14.1. Instalación de Node.js

[Node.js] se descarga desde nodejs.org: seleccione la versión LTS (soporte a largo plazo), la versión 24 al momento de escribir este documento. El instalador de [Windows] también instala [npm]. [Node.js] es necesario tanto para los proyectos [Ionic] ([Angular CLI] 22 requiere la versión 22.22 o posterior) como para el servidor JSON. Verifique la instalación en una consola:

node --version
npm --version

Si otro proyecto requiere una versión anterior de [Node.js], un administrador de versiones permite instalar varias versiones y cambiar entre ellas: [nvm-windows] en [Windows], [nvm] en [Linux] y [macOS] ([nvm install 24], y luego [nvm use 24]).

En [Windows], [PowerShell] puede negarse a ejecutar los comandos [npm] y [npx] («la ejecución de scripts está deshabilitada en este sistema»): el comando [Set-ExecutionPolicy -Scope CurrentUser RemoteSigned] lo habilita para el usuario actual.

14.2. Instalación de Android Studio y de un emulador

[Android Studio] se puede descargar desde developer.android.com/studio. No se utiliza para escribir código, sino para instalar el SDK y [Android], proporcionar un JDK y crear un emulador (los detalles se encuentran en el capítulo «Configuración del entorno de desarrollo»):

  • En el primer inicio, el asistente instala el SDK y [Android];
  • menú «More Actions» / «SDK Manager», pestaña «SDK Tools»: marque «Android SDK Platform-Tools» ([adb]), «Android Emulator» y «Android SDK Command-line Tools»;
  • cree las variables de entorno [ANDROID_HOME] (la carpeta del SDK) y [JAVA_HOME] (la subcarpeta [jbr] de [Android Studio]), que [Capacitor] necesita para compilar la aplicación;
  • menú «More Actions» / «Virtual Device Manager»: cree un teléfono virtual (por ejemplo, un «Pixel») con una imagen de sistema reciente. Haga clic en el botón ▶ para iniciarlo; [adb devices] lo detectará entonces con el nombre [emulator-5554]. También puede iniciarlo sin abrir [Android Studio]: [npx cap run android] muestra los emuladores que ha creado, incluso si están detenidos, e inicia el que usted seleccione; o bien, desde la línea de comandos, el programa [emulator] del SDK: [emulator -list-avds] muestra los nombres de los emuladores y [emulator -avd <name>] inicia uno (en [Windows]: [%ANDROID_HOME%\emulator\emulator.exe]).

Para un teléfono real: en Configuración / Acerca del teléfono, al tocar siete veces «Número de compilación» aparecen las «Opciones de desarrollador», donde se puede habilitar la «Depuración por USB». Al conectarlo a la computadora, el teléfono solicita autorizar la computadora; [adb devices] lo detecta entonces.

El proyecto [Android] creado por [Capacitor] (la carpeta [android/]) se abre en [Android Studio] mediante [npx cap open android]. Entre otras cosas, contiene la ventana [Logcat] (mensajes de la aplicación y del sistema, incluidos los de los plugins de [Capacitor]) y el botón [Run], que hace lo mismo que [npx cap run android].

14.3. Instalación de Visual Studio Code

[Visual Studio Code] se descarga desde code.visualstudio.com. El soporte para [TypeScript] y [JavaScript] viene integrado. En el panel Extensions (Ctrl+Shift+X), instale:

  • la extensión [Angular Language Service] (del equipo de [Angular]): autocompletado y validación en las plantillas ([HTML]: propiedades y métodos de la clase, entradas de los componentes y atributos de los componentes de [Ionic]), navegación desde una plantilla hasta el código de su clase (F12) y visualización de los errores de compilación de la plantilla mientras se escribe;
  • la extensión [Ionic] (del equipo de [Ionic]): un panel que inicia la aplicación en el navegador o en un dispositivo [Android], administra los plugins de [Capacitor] y avisa a los usuarios de las actualizaciones de los paquetes de [Ionic] y [Capacitor] ;
  • opcionalmente, la extensión [Prettier], que formatea el código al guardar según las reglas especificadas en el archivo [.prettierrc] de los proyectos.

Abra un proyecto mediante el menú File / Open Folder (la carpeta [examples_ionic], por ejemplo) y abra una consola mediante el menú Terminal / New Terminal; allí se escribe [npm install], [npm start], [npx ng build], [npx cap run android]... El archivo [.vscode/launch.json] de los proyectos también permite iniciar la aplicación con F5: [VS Code] ejecuta entonces [npm start], abre [Chrome] en la aplicación, y se pueden establecer puntos de interrupción directamente en el código [TypeScript] dentro del editor.

14.4. Herramientas de desarrollo de Chrome

Las herramientas de desarrollo de [Chrome] son para una aplicación [Ionic] lo que [Flutter DevTools] es para una aplicación [Flutter]. Se abren con F12 (o Ctrl+Shift+I). Sus pestañas más útiles son:

  • la barra de emulación de dispositivos (Ctrl-Shift-M): la aplicación ajustada al tamaño de un teléfono (un modelo de la lista, o dimensiones especificadas), con eventos táctiles. Así se desarrolla la aplicación antes de pasar a [Android];
  • «Elements»: el árbol de elementos de la página y, para cada elemento, sus estilos (que se pueden editar en tiempo real). El ícono de flecha en la esquina superior izquierda permite hacer clic en un elemento de la página para ubicarlo en el árbol. Allí se ven las etiquetas [<ion-...>] y, dentro de cada una, su «shadow DOM»: los elementos HTML que la componen. Esta herramienta responde a la pregunta: «¿Por qué este elemento no está en su lugar?»;
  • «Console»: los mensajes de la aplicación ([console.log()]) y los errores, junto con el archivo y la línea ([TypeScript]) donde se originaron;
  • «Sources»: el código de la aplicación ([TypeScript]) (mediante los «source maps» de la configuración [development]), donde se establecen los puntos de interrupción;
  • «Network»: las solicitudes (HTTP) de la aplicación, junto con sus encabezados y cuerpos: aquí se puede ver el cookie del token enviado y recibido (en el navegador);
  • «Application»: el almacenamiento de la página ([localStorage], donde la extensión [@capacitor/preferences] guarda sus valores en un navegador) y sus cookies.

La extensión [Angular DevTools] (que se instala desde [Chrome Web Store]) agrega una pestaña «Angular»: el árbol de componentes de [Angular] de la pantalla y, para cada componente, sus entradas, signals y propiedades, que se pueden modificar en tiempo real; su pestaña «Profiler» muestra lo que [Angular] actualizó, y cuánto tardó, después de cada evento.

Las mismas herramientas pueden depurar la aplicación instalada en el emulador o en el teléfono. En [Chrome] en la computadora, abra la dirección [chrome://inspect]: la página muestra los dispositivos conectados mediante [adb] y, para cada uno, el WebView de las aplicaciones en ejecución cuya depuración está permitida (esto se aplica a las aplicaciones [Capacitor] compiladas en modo «debug», como con [npx cap run android]). El enlace «Inspect» abre una ventana de herramientas de desarrollo vinculada al WebView de la aplicación, con la pantalla del teléfono a la izquierda: allí encontrará las pestañas «Elements», «Console», «Sources», «Network» y otras... Como las solicitudes realizadas por [CapacitorHttp] pasan por el código nativo de [Android], no todas aparecen en la pestaña «Network»: la ventana [Logcat] de [Android Studio] las muestra.

14.5. Instalación de MySQL con Laragon

El servidor JSON requiere [MySQL] (o [MariaDB]). [Laragon] (laragon.org) instala uno en [Windows], listo para usar, 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 predeterminados del archivo [.env.example] del servidor;
  • En [HeidiSQL] (el botón «Database»), la opción de menú File / Run SQL ejecuta el script [database/dbrdvmedecins2.sql].

En [Linux] o [macOS], instale [MySQL] o [MariaDB] con 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].

14.6. Instalación de curl

[curl] viene incluido con las versiones 10 y 11 de [Windows] , con [macOS] y con la mayoría de las distribuciones de [Linux]. Verifique su versión:

curl --version

La opción [--json], utilizada en este documento, está disponible desde la versión 7.82 (2022). Si utiliza una versión anterior, reemplace [--json @file] por [-H "Content-Type: application/json" -d @file], o instale una versión reciente a partir de curl.se.

En [PowerShell], debe escribir [curl.exe], 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.