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.
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 assembleStagingDebugAmbos 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
- Versión: en el teléfono, Ajustes → Aplicaciones → ElVendedor → Versión,
debe coincidir con
versionName. - Arranque: la app abre y llega a la pantalla de licencia o de inicio de sesión sin errores de paquete.
- Sincronización: en
GET /api/v1/sync/bootstrapel cliente debe leersync_version=1,contract_version=1ycompatibility.policy. La pantalla de sincronización muestra la política, el contrato y los rechazos con causa. - Entidades: el móvil envía
X-Client-Entitiescon su matriz y no anunciainvoicesnirestaurant_layouts(son de escritorio). - 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:
- Haz respaldo y sincroniza antes de tocar nada (Respaldo y restauración).
- Reinstala el APK anterior. Android no acepta instalar un
versionCodemenor sobre una instalación existente, así que el APK viejo puede ser rechazado; en ese caso toca el paso 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.
- Documenta versión,
versionCodey síntoma en la ficha del cliente.
Siguiente paso
¿Falta algo o encontraste un error?
Ayúdanos a mejorar esta documentación con tu experiencia real.
Escribir a soporte