12. Despliegue
Durante el desarrollo, [Android Studio] (o [gradlew installDebug]) instala la versión “debug” de la aplicación: firmada con una clave de depuración generada automáticamente, que habilita el depurador. Para desplegarla, se compila la versión “release”.
12.1. La versión de producción de la aplicación
- Compile la aplicación, especificando la dirección del servidor de producción. En una ventana de símbolo del sistema abierta en la carpeta [rdvmedecins_kotlin]:
[Gradle] compila el código [Kotlin] a “bytecode” y luego a código [Dalvik] (el formato de los archivos [.dex], ejecutados por la máquina virtual de [Android], [ART]), y empaqueta todo —junto con los recursos y las bibliotecas— en un archivo APK: el formato de instalación de las aplicaciones [Android]. A diferencia de [Flutter], no hay ningún motor que incorporar: la interfaz la renderiza [Compose], una biblioteca como cualquier otra. El archivo resultante, [app/build/outputs/apk/release/app-release-unsigned.apk], pesa unos pocos megabytes.
El bloque [buildTypes { release [ ... ] }] de [app/build.gradle.kts] configura esta versión. Allí se puede habilitar el optimizador [R8] ([optimization [ enable = true ]]): elimina el código no utilizado de las bibliotecas y acorta los nombres, lo que reduce el tamaño del APK. Luego hay que indicarle que conserve lo que el serializador encuentra mediante reflexión (las reglas de [kotlinx.serialization] se proporcionan con la biblioteca) y PROBAR la versión optimizada.
-
Fírmela. [Android] solo instala aplicaciones FIRMADAS. La forma más sencilla es usar [Android Studio]: el menú [Build / Generate Signed App Bundle or APK] crea la clave de desarrollador (un archivo “keystore” protegido con contraseña que debe guardar en un lugar seguro: todas las actualizaciones de la aplicación deben firmarse con ella), y luego compila y firma el APK. También puede definir la firma en [app/build.gradle.kts] (bloque [signingConfigs]) leyendo las contraseñas de las propiedades de [Gradle] en lugar de escribirlas directamente en el código.
-
Instálela. Con el teléfono conectado a la computadora (cable USB, depuración por USB habilitada):
También puede copiar el archivo APK al teléfono y abrirlo: [Android] le pedirá entonces que permita la instalación de aplicaciones “de orígenes desconocidos”.
-
Para la publicación real:
-
[Google Play Store] exige un “Android App Bundle” en lugar de un APK: [gradlew bundleRelease], o el mismo menú de [Android Studio]. Google genera los archivos APK adaptados a cada teléfono;
- el nombre y el ícono de la aplicación se configuran en [res/values/strings.xml] ([app_name]) y en [res/mipmap-*/] (menú [New / Image Asset] de [Android Studio]);
- [versionCode] (un entero) debe incrementarse con cada publicación; [versionName] es la versión que se muestra;
- el servidor debe configurarse con HTTPS (se transmiten contraseñas) y se elimina del manifiesto la línea [android:usesCleartextTraffic="true"];
- el token se almacena en [SharedPreferences], un archivo privado de la aplicación. Para mayor seguridad, se puede cifrar mediante el “keystore” de [Android] (biblioteca [androidx.security]).
12.2. El servidor de producción
En un entorno de producción real, no olvide el archivo [.env] del servidor:
- un [JWT_SECRET] largo y aleatorio;
- un [CAPTCHA_TEST] vacío;
- [COOKIE_SECURE=true] si el sitio se sirve mediante HTTPS (debe ser así). El cliente móvil envía la cookie independientemente de esta opción: es el navegador quien la aplica;
- [TRUST_PROXY=true] si el servidor se encuentra detrás de un proxy ([nginx]...), de modo que el límite de intentos vea la dirección IP real de los clientes.
Luego se inicia el servidor compilado: [npm run build], seguido de [npm run start:prod].