ElVendedorDocs

Despliegue de la app móvil

Compilar, versionar, firmar y distribuir la APK de ElVendedor para Android, con la URL de backend que elijas por entorno.

Para implementadores4 min de lecturaActualizado el 16 de noviembre de 2026

La app móvil es Ionic/Angular 17 sobre Capacitor 6. El repositorio ya trae los comandos que compilan, sincronizan con Android e instalan en un dispositivo conectado. Al terminar esta página sabrás generar la APK correcta para cada entorno, comprobar la versión instalada y volver atrás si algo falla.

Antes de empezar

  • Node.js y npm con las dependencias del proyecto instaladas (npm ci).
  • Un JDK y el Android SDK configurados para Gradle. La versión exacta no está declarada en el repositorio.
  • Un dispositivo con depuración USB o un emulador si vas a usar los comandos del repo, porque terminan en adb install.

El proyecto Android del repositorio está incompleto: conviven android/app/build.gradle y las fuentes Java, pero no están en el repositorio gradlew, settings.gradle ni variables.gradle, que es donde build.gradle resuelve minSdkVersion, targetSdkVersion y las versiones de las librerías de AndroidX.

Comandos reales del repositorio

npm run android:prod      # ng build && npx cap sync android && ./gradlew assembleProdDebug
npm run android:staging   # ng build --configuration staging && npx cap sync android && ./gradlew assembleStagingDebug

Ambos scripts hacen lo mismo en cadena: compilan la web en www (angular.json define outputPath: www y capacitor.config.ts apunta webDir a www), copian el resultado al proyecto Android con npx cap sync android, compilan la variante Gradle y la instalan por ADB sobre el paquete correspondiente:

Script Tarea Gradle APK generada Paquete instalado
android:prod assembleProdDebug app-prod-universal-debug.apk com.miraloaki.elvendedor
android:staging assembleStagingDebug app-staging-universal-debug.apk com.miraloaki.elvendedor.staging

Y cierran con adb shell monkey -p <paquete> -c android.intent.category.LAUNCHER 1 para abrir la app. Las APK quedan bajo android/app/build/outputs/apk/<flavor>/debug/; el nombre termina en -universal-debug.apk porque build.gradle activa splits.abi con universalApk true y abiFilters para armeabi-v7a, arm64-v8a, x86 y x86_64.

Si solo quieres compilar la web, los comandos son npm run build y npm run build:staging.

URL del backend por entorno

La URL se resuelve por reemplazo de archivo en angular.json: la configuración production sustituye environment.ts por environment.prod.ts y la configuración staging lo sustituye por environment.staging.ts. El valor está en sync_api_url:

# src/environments/environment.prod.ts
sync_api_url: 'https://elvendedor.laravel.cloud'

# src/environments/environment.staging.ts
sync_api_url: 'https://elvendedor-staging-staging-ydffdy.laravel.cloud'

environment.ts (desarrollo) apunta a http://127.0.0.1:8000. Para un backend on-premise, edita el archivo del entorno que vayas a construir antes del build: la URL queda dentro de la APK y no se puede cambiar desde la interfaz.

Versión de la app

Dónde Valor actual Cuándo cambiarlo
package.json → version 2.1.6 En cada release
android/app/build.gradle → versionName 2.1.6 En cada release, igual que package.json
android/app/build.gradle → versionCode 2 En cada APK que se instale encima

Android rechaza instalar un versionCode igual o menor sobre una app ya instalada: sube el entero siempre, aunque solo cambie un parche. La app debe quedar además en o por encima de SYNC_MINIMUM_APP_VERSION del backend.

# android/app/build.gradle (fragmento actual)
defaultConfig {
    applicationId "com.miraloaki.elvendedor"
    versionCode 2
    versionName "2.1.6"
}

Firma

Pendiente de validación

android/app/build.gradle no declara signingConfigs, no hay keystore versionado y los scripts del repositorio generan variantes debug (assembleProdDebug, assembleStagingDebug). Falta definir con el Lead cómo se produce y custodia la APK firmada de release, y con qué comando. No inventes un procedimiento de firma hasta que esté documentado.

Distribución

La vía confirmada es la instalación directa del APK: el archivo se entrega al cliente y se abre en el teléfono (ver Instalar la app móvil). Al actualizar se instala encima, sin desinstalar, para conservar los datos locales.

Pendiente de validación

No está confirmado que la app se publique en Play Store ni que se distribuya por un MDM. Mientras tanto, entrega siempre el APK del canal acordado con el proveedor y registra la versión y el versionCode entregados.

Verificación post-instalación

  1. Versión: en el teléfono, Ajustes → Aplicaciones → ElVendedor → Versión, debe coincidir con versionName.
  2. Arranque: la app abre y llega a la pantalla de licencia o de inicio de sesión sin errores de paquete.
  3. Sincronización: en GET /api/v1/sync/bootstrap el cliente debe leer sync_version=1, contract_version=1 y compatibility.policy. La pantalla de sincronización muestra la política, el contrato y los rechazos con causa.
  4. Entidades: el móvil envía X-Client-Entities con su matriz y no anuncia invoices ni restaurant_layouts (son de escritorio).
  5. Prueba de extremo a extremo: una venta creada en el móvil descuenta stock en un escritorio sincronizado.

Rollback

Si la versión nueva falla en el cliente:

  1. Haz respaldo y sincroniza antes de tocar nada (Respaldo y restauración).
  2. Reinstala el APK anterior. Android no acepta instalar un versionCode menor sobre una instalación existente, así que el APK viejo puede ser rechazado; en ese caso toca el paso 3.
  3. Como último recurso, desinstala y vuelve a instalar: eso borra los datos locales del negocio, así que solo con respaldo y con el negocio cerrado.
  4. Documenta versión, versionCode y síntoma en la ficha del cliente.

Siguiente paso

↑↓ para navegar · Enter para abrir · Esc para cerrar