Mobile

App Mobile para ANDES

Notas

Como Angular y Angular-CLI son proyectos que están en constante actualización, recomendamos utilizar las versiones específicas detalladas en este documento

Requerimientos Android/Linux

Instalar Android Studio

• Descargar Android Studio o usando el instalador de paquetes del sistema
• Abrir Android Studio y seguir estos pasos:
  • Ir al menú File => Settings
  • Ir a System Settings => Android SDK
  • Seleccionar Android 10.0/API Level 29
  • Instalar (botón Apply)

Configurar Android SDK (Linux)

Agregar al PATH en el archivo ~/.bashrc

# ejemplo: export ANDROID_SDK_ROOT="/home/andrrr/Android/Sdk"
export ANDROID_SDK_ROOT="/home/MI-USUARIO/RUTA/A/ANDROID/Sdk"
PATH=$PATH:$ANDROID_SDK_ROOT/tools 
PATH=$PATH:$ANDROID_SDK_ROOT/platform-tools

Licencias

Para poder generar builds, es necesario aceptar ciertas licencias de uso. Para ello se debe navegar por consola a

/home/MI-USUARIO/Android/Sdk/tools/bin

y ejecutar el siguiente comando (aceptar todo):

./sdkmanager --licenses

Instalar JDK8 (Ubuntu/Mint/Debian)

Android/Cordova necesitan la versión 8, no funciona con versiones más nuevas. Por tanto, si hay una versión más nueva, primero se desinstala. También se puede instalar la versión de Oracle.

sudo apt update
sudo apt remove openjdk*
sudo apt install openjdk-8-jdk

Instalar y configurar Gradle

• Descargar la última versión de Gradle.
• Agregar al PATH en el archivo ~/.bashrc:

export PATH=$PATH:/home/MI-USUARIO/RUTA/A/GRADLE/gradle-X.Y.Z/bin

Instalación dentro del proyecto

cd mobile-app

Ionic 5

sudo npm install -g @ionic/cli@6.12.4

Native run para Ionic

sudo npm install -g native-run

Cordova y cordova-res (genera íconos y splash screen)

sudo npm install -g cordova@10.0.0 cordova-res

Instalar dependencias

npm install

Definir environment

cd src/environments
cp environment.ts.example environment.ts
cp environment.ts.example environment.dev.ts

Para desarrollo completar el archivo environment.dev.ts Para producción completar el archivo environment.ts

Compilar e iniciar la aplicación

1. Generar resources (splash screen, íconos):

cordova-res
# Nota: se ejecuta sólo la primera vez, o cada vez que se cambie el diseño de íconos o splash screen

2. Agregar platform y correr en dispositivo

ionic cordova platform add android (o ios)
ionic cordova run android (o ios) 

Uso del entorno

import { ENV } from '@app/env';
  ...
const baseUrl = ENV.API_URL;  

Generar release para Android APK (.apk) y Bundle (.aab)

0. Deben estar presentes los archivos privados andes-key.jks, build-andes.json (antes era build.json) y google-services.json
1. Se debe incrementar la versión en ionic.config.json según corresponda, por ejemplo:
   • Si es un fix se incrementa el último número 4.1.4 => 4.1.5
   • Si es una mejora se incrementa el segundo número 4.1.4 => 4.2.0
   • Si es un cambio importante en el entorno completo 4.1.4 => 5.0.0
   • Si es un cambio en una configuración, chore o lint, no incrementa versión
2. Hacer commit de los cambios (así se puede incrementar la versión con npm)
3. Con el directorio de trabajo limpio, ejecutar:
   1. Release Google Play Desarrollo:
      • Android APK: npm run build:demo:android:apk
      • Android Bundle (.aab): npm run build:demo:android:aab
   2. Release Google Play Producción:
      • Android APK: npm run build:prod:android:apk
      • Android Bundle (.aab): npm run build:prod:android:aab
4. Al final del proceso se genera un archivo local —firmado y optimizado— con el nombre "andes{Prod|Demo}-v{X.Y.Z}.{apk|aab}" siendo X.Y.Z la versión configurada en ionic.config.json. Si un archivo con la misma versión ya existe, el proceso de build falla.
5. La versión APK es para pruebas, la versión Bundle para Google Play.

Tests con Emulador

En algunas situaciones se requiere correr la app en un emulador con una versión de Android específica. El escenario típico es el de un usuario con una versión de Android (API level) diferente al target. A continuación se explica cómo correr un emulador desde la línea de comando para no tener que abrir Android Studio cada vez.

Correr la aplicación en un emulador

0. Crear device con Android Studio, según la API level, resolución, etcétera que se necesite.
1. Navegar por línea de comando a la carpeta del SDK Android/Sdk/tools/bin/ en la carpeta de usuario (la ubicación puede variar en cada sistema).
2. Ejecutar ./avdmanager list avd para ver la lista de emuladores disponibles para usar. Si no hay ninguno es porque no hay ninguno creado. A continuación un ejemplo de resultado:

...
  Name: 3.2_HVGA_slider_ADP1_API_24
  Device: 3.2in HVGA slider (ADP1) (Generic)
    Path: /home/andrrr/.android/avd/3.2_HVGA_slider_ADP1_API_24.avd
  Target: Google APIs (Google Inc.)
          Based on: Android 7.0 (Nougat) Tag/ABI: google_apis/x86
    Skin: 320x480
  Sdcard: 512 MB

3. Copiar el nombre del avd, en este caso 3.2_HVGA_slider_ADP1_API_24
4. Salir de la carpeta bin ejecutando cd ... Ahora estamos en Android/Sdk/tools/.
5. Abrir el emulador con ./emulator -avd 3.2_HVGA_slider_ADP1_API_24
6. Correr la app ionic con ionic cordova run android --emulator -l (el parámetro -l es opcional, implementa live reload si estamos desarrollando).

Listar, crear y correr emulador con scripts npm

0. npm run sdk:install|uninstall --androidApiLevel=NUMERO_API_LEVEL: Instala/Desinstala un SDK de Android para ser usado en un emulador
1. npm run avd:list:avd: Lista los emuladores actualmente instalados y disponibles para usar
2. npm run avd:list:target: Lista las API level/versiones disponibles para instalar
3. npm run avd:list:devices: Lista los dispositivos virtuales disponibles para instalar
4. npm run avd:create --name=NOMBRE_SIMPLE_SIN_ESPACIOS --androidApiLevel=NUMERO_API_LEVEL --deviceName=NOMBRE_DEVICE:
5. npm run avd:run --name=NOMBRE_SIMPLE_SIN_ESPACIOS:
6. Podés consultar las API levels/versiones de Android

Ejemplo de uso:

  # Bajar el SDK de API Level 25 (Android 7.1)
  npm run sdk:install --androidApiLevel=25

  # Crear un AVD "android7Andes" con la API level 25, modelo "Nexus 6"
  npm run avd:create --name=android7Andes --androidApiLevel=25 --deviceName="Nexus 6"

  # Correr el AVD usando el nombre asignado
  npm run avd:run --name=android7Andes

  # Eliminar el AVD
  npm run avd:delete --name=android7Andes