Saltar al contenido principal

Introducción

Documentación técnica de la aplicación móvil de Maroun S.A. Este proyecto es una aplicación nativa desarrollada con Flutter que actúa como un contenedor inteligente (WebView) para el ecosistema web de la empresa.

Descripción General​

Este proyecto corresponde a una aplicación móvil desarrollada en Flutter que funciona como contenedor WebView del sitio web institucional de Maroun SA. La aplicación no posee lógica de negocio propia compleja, sino que renderiza contenido web remoto y controla la navegación desde una interfaz móvil estructurada.

Para poder ejecutar el proyecto es necesario tener instalado el SDK de Flutter en su versión estable, junto con Android Studio o Visual Studio Code y el Android SDK correctamente configurado. También se requiere un emulador configurado o un dispositivo físico con depuración USB habilitada.

Enlace de descarga del proyecto

Descargar Aplicación Maroun

Descripción de los Archivos​

A continuación se detalla la función técnica de cada elemento presente en el repositorio:

1. app-release.aab​

Es el Android App Bundle. Es el formato de publicación oficial para Google Play Store. A diferencia de un APK simple, este archivo permite que Google Play genere versiones optimizadas de la aplicación según el dispositivo del usuario, reduciendo el tamaño de descarga.

2. maroun-release-key.jks​

Es el Java KeyStore. Este es el archivo más crítico del proyecto, ya que contiene la llave digital utilizada para firmar la aplicación. Sin este archivo, es imposible subir actualizaciones a las tiendas oficiales o garantizar la autenticidad de la app ante el sistema operativo Android.

3. key.properties​

Archivo de configuración que vincula el código fuente con la firma digital. Contiene las rutas locales y las referencias necesarias (como el alias de la llave) para que el proceso de compilación (flutter build) sepa cómo firmar el archivo .aab automáticamente.

4. main.dart​

Es el archivo principal del código fuente en Flutter.Contiene la lógica de inicialización, la configuración de la WebView y la gestión de la interfaz de usuario que permite visualizar el sitio web de Maroun dentro de la app.

5. MarounKey.txt y MarounKey (Documento)​

Son archivos de respaldo que contienen la información administrativa de la firma:

  • Passwords: Claves de acceso al almacén de llaves.
  • Alias: El nombre identificador de la llave dentro del archivo .jks.
  • Detalles técnicos: Instrucciones para la recuperación de la firma en caso de migración de servidor.

⚠️ Advertencia de Seguridad​

El archivo .jks y sus contraseñas asociadas deben manejarse con extrema confidencialidad. Su pérdida impediría actualizar la aplicación móvil existente, obligando a los usuarios a desinstalar y reinstalar una versión completamente nueva con una firma diferente.