14. Apéndices
La instalación de [Android Studio], del emulador y la configuración de un teléfono se describen en el capítulo “Configuración del entorno de desarrollo”. Estos apéndices complementan ese capítulo.
14.1. Uso de Android Studio
- [File / Open]: abre un proyecto ([examples_kotlin], [rdvmedecins_kotlin]); [Gradle] lo “sincroniza” (descarga las bibliotecas);
- el botón [Run] (o Shift-F10) instala e inicia la aplicación en el dispositivo seleccionado en la barra de herramientas; [Debug] (Shift-F9) la inicia con el depurador (puntos de interrupción, variables);
- [Apply Changes] reemplaza el código de una aplicación en ejecución sin reiniciarla, cuando es posible;
- la anotación [@Preview] en una función [@Composable] sin parámetros la muestra en el editor, sin un emulador;
- el “Layout Inspector” ([Tools / Layout Inspector]) muestra el árbol de componentes de la pantalla actual y el número de recomposiciones de cada componente; “App Inspection” muestra las solicitudes de red ([OkHttp]) y las bases de datos;
- Al presionar Alt-Enter sobre un error se sugieren correcciones (agregar un [import]...); Ctrl-Alt-L reformatea el archivo;
- Línea de comandos: [adb devices] (dispositivos conectados), [adb reverse tcp:8080 tcp:8080] (puerto 8080 del dispositivo conectado al puerto de la computadora), [adb install file.apk] (instalar una aplicación), [adb logcat] (el registro del teléfono; en [Android Studio], la ventana [Logcat]), [emulator -list-avds] y luego [emulator -avd Pixel_8] (iniciar un emulador sin [Android Studio]).
14.2. Capturas de pantalla de este documento
Las capturas de pantalla se generaron automáticamente mediante pruebas INSTRUMENTADAS: pruebas [JUnit] que se ejecutan EN el emulador —dentro del mismo proceso que la aplicación— y la controlan mediante la biblioteca de pruebas de [Compose] (encontrar un componente por su texto, tocarlo, escribir en él, etc.). Se encuentran en las carpetas [app/src/androidTest] de los dos proyectos: [Captures.kt] (una función de prueba por ejemplo) y [CaseStudyCaptures.kt] (un recorrido completo de la aplicación). Un extracto:
Los scripts [tools/captures_examples.bat] y [tools/captures_case_study.bat] inician el emulador si es necesario, compilan e instalan la aplicación y sus pruebas, configuran el emulador (idioma, barra de estado en “modo de demostración”), ejecutan las pruebas ([adb shell am instrument]) y luego recuperan las imágenes. El servidor JSON debe estar iniciado, junto con [CAPTCHA_TEST=test].
14.3. Instalación de Node.js
[Node.js] se descarga desde nodejs.org: seleccione la versión LTS (soporte a largo plazo). El instalador de [Windows] también instala [npm]. Solo es necesario para el servidor JSON. Verifique la instalación en una consola:
14.4. Instalación de MySQL con Laragon
El servidor JSON requiere [MySQL] (o [MariaDB]). [Laragon] (laragon.org) instala una instancia lista para usar en [Windows] 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: estos 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.5. Instalación de curl
[curl] viene incluido con las versiones 10 y 11 de [Windows] , [macOS], y con la mayoría de las distribuciones de [Linux]. Verifique su versión:
La opción [--json], utilizada 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 a partir de curl.se.
En [PowerShell], debe ingresar [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.