1.2.0 • Published 3 years ago
android-updater v1.2.0
android-updater
Plugin para actualizar la versión de las aplicaciones android sin necesidad de subirlas a las Play store
Install
npm install android-updater
npx cap sync android
Import
Para utilizar el plugin cuando ya ha sido instalado se debe importar en la clase de typescript en la que se quiera usar
import { DownloadUpdate } from "android-updater";
API
startDownload(...)
Descripción del plugin
- Al iniciar comprueba si tienes los permisos requeridos para que el plugin funcione (Los permisos requeridos son de lectura y escritura en el dispositivo).
- Si no obtiene los permisos se notificará al usuario, se detendrá la ejecución del plugin y enviará una
promise<any> con un boolean false
. - Si no se encuentra la versión objetivo (Versión de la aplicación actualizada) se detendrá la ejecución del plugin y enviará una
promise<any> con un boolean false
.
- Si no obtiene los permisos se notificará al usuario, se detendrá la ejecución del plugin y enviará una
- Si se encuentra la versión objetivo se empezará la descarga y actualización de la aplicación
- Cuando se finalize la descarga se detendrá la ejecución del plugin y enviará una
promise<any> con un boolean false
(Ya que la aplicación va a reiniciarse debido a la actualización)
- Cuando se finalize la descarga se detendrá la ejecución del plugin y enviará una
- Si la versión objetivo es mayor o igual a la versión actual de la aplicación se detendrá la ejecución del plugin y enviará una
promise<any> con un boolean true
.
Parámetros
startDownload({ repository: string; apkName: string; currentVersion: string; targetVersion: string; }) => Promise<any>
Parámetro | Tipo | Descripción |
---|---|---|
repository | String | Url de la página (repositorio) donde se aloja la nueva versión compilada del programa .apk |
apkName | String | Nombre del fichero .apk |
currentVersion | String | Versión actual del programa (Se comparará con targetVersion) |
targetVersion | String | Versión objetivo del programa (Última versión disponible) (Se comparará con currentVersion) |
Datos devueltos por el plugin / Returns
El plugin devuelve una promesa con un objeto con el estado de la actualización {allow_enter: boolean}
.
- Solo devolverá true cuando no haya nuevas actualizaciones.
- Devolverá false cuando haya ocurrido un error (Por no tener los permisos necesarios, fallo al buscar la actualización...) o cuando se esté descargando una nueva actualización (Porque se reiniciará la aplicación tras la actualización)