También disponible para Cordova y Electron
Sección titulada “También disponible para Cordova y Electron”Las live updates de Capgo no se limitan a Capacitor. Usa el mismo backend y CLI con plugins cliente hermanos:
@capgo/capacitor-updater incluye Actualizaciones de bundle de JavaScript a apps de Capacitor en producción sin esperar la revisión de la tienda. Descarga bundles firmados en segundo plano, controla el despliegue con canales y reglas de retraso, y revierte si notifyAppReady() is not called within the configured appReadyTimeout.
Usos típicos: hotfix de bugs en producción, betas escalonadas por canal, experimentos A/B de UI y rollback de emergencia al bundle integrado.
Soporte de plataformas
Sección titulada “Soporte de plataformas”| Plataforma | Soporte |
|---|---|
| iOS | Sí |
| Android | Sí |
| Web | Los bundles se aplican a la capa WebView en shells nativos, no a sitios estáticos alojados |
Los clientes de Cordova y Electron usan plugins hermanos vinculados arriba con el mismo backend de Capgo.
Funcionalidades principales
Sección titulada “Funcionalidades principales”notifyAppReady- Notifica a la capa nativa que JavaScript se inicializó correctamente.setUpdateUrl- Configura la URL de actualización de la app dinámicamente en runtime.setStatsUrl- Configura la URL de estadísticas de la app dinámicamente en runtime.setChannelUrl- Configura la URL del canal de la app dinámicamente en runtime.
Público API
Sección titulada “Público API”| Método | Descripción |
|---|---|
notifyAppReady | Notifica a la capa nativa que JavaScript se inicializó correctamente. |
setUpdateUrl | Configura la URL de actualización de la app dinámicamente en runtime. |
setStatsUrl | Configura la URL de estadísticas de la app dinámicamente en runtime. |
setChannelUrl | Configura la URL del canal de la app dinámicamente en runtime. |
download | Descarga un nuevo bundle desde la URL proporcionada para su instalación posterior. |
next | Establece el próximo bundle que se activará cuando la app pase a segundo plano o se reinicie. |
set | Establece el bundle actual y recarga la app inmediatamente. |
delete | Elimina un bundle del almacenamiento local para liberar espacio en disco. |
setBundleError | Marca manualmente un bundle como fallido/errored en modo de actualización manual. |
list | Obtén todos los bundles descargados localmente y almacenados en tu app. |
reset | Restablece la app a un bundle conocido y estable. |
current | Obtén información sobre el bundle actualmente activo. |
reload | Recarga manualmente la app para aplicar una actualización pendiente. |
setMultiDelay | Configura las condiciones que deben cumplirse antes de aplicar una actualización pendiente. |
cancelDelay | Cancela todas las condiciones de retraso y aplica la actualización pendiente de inmediato. |
getLatest | Consulta el servidor de actualizaciones para obtener la última versión de bundle disponible. |
setChannel | Establece un canal de actualización de runtime local para este dispositivo. No crea una superposición de dispositivo en el dashboard/API. |
unsetChannel | Elimina la asignación de canal del dispositivo y vuelve al canal predeterminado. |
getChannel | Obtén el canal actual asignado a este dispositivo. |
listChannels | Obtén una lista de todos los canales disponibles para que este dispositivo se autoasigne. |
setCustomId | Set a custom identifier for this device. |
getBuiltinVersion | Obtén la versión del bundle integrado (la versión original incluida con tu app nativa). |
getDeviceId | Obtén el identificador único y respetuoso con la privacidad de este dispositivo. |
getPluginVersion | Obtén la versión del plugin Capacitor Updater instalado en tu app. |
isAutoUpdateEnabled | Comprueba si las actualizaciones automáticas están activadas actualmente. |
removeAllListeners | Elimina todos los listeners de eventos registrados para este plugin. |
addListener | Escucha el evento de descarga de bundle en la App. Se dispara una vez que comienza la descarga, durante la misma y al finalizar. Esto te devolverá el porcentaje de descarga durante el proceso. |
addListener | Escucha el evento de no necesidad de actualización, útil cuando quieres forzar la comprobación cada vez que se lanza la app. |
addListener | Escucha el evento de actualización disponible, útil cuando quieres forzar la comprobación cada vez que se lanza la app. |
addListener | Escucha los eventos de downloadComplete. |
addListener | Escucha eventos de actualización incompatible cuando el backend marca una actualización como no compatible con la app actual. Emite el mismo payload que el legacy majorAvailable listener manual. |
addListener | Escucha el evento de Major update en la App, te avisa cuando una major update está bloqueada por la configuración disableAutoUpdateBreaking. |
addListener | Escucha el evento de fallo de actualización en la App para saber cuándo la instalación falla al iniciar la aplicación. |
addListener | Escucha el evento set en la App, te avisa cuando un bundle se ha aplicado correctamente. Este evento se retiene nativamente hasta que JavaScript lo consume, por lo que si la app se recarga antes de que se adjunte tu listener, el último pendiente set se entrega una vez que el listener se suscribe. |
addListener | Escucha el evento set next en la App, te avisa cuando un bundle se ha encolado como el siguiente bundle a instalar. |
addListener | Escucha el evento de fallo de descarga en la App, te avisa cuando la descarga de un bundle ha fallado. |
addListener | Escucha el evento reload en la App, te avisa cuando ha ocurrido un reload. |
addListener | Escucha el evento app ready en la App, te avisa cuando la app está lista para usarse. Este evento se retiene nativamente hasta que JavaScript lo consume, por lo que aún puede entregarse después de un reload incluso si el listener se adjunta más tarde en el inicio de la app. |
addListener | Escucha el evento channel private, se dispara al intentar establecer un channel que no permite la autoasignación del dispositivo. |
addListener | Escucha cambios en el estado de actualización flexible en Android. |
isAutoUpdateAvailable | Comprueba si la función de actualización automática está disponible (no deshabilitada por la configuración del servidor). |
getNextBundle | Obtén información sobre el bundle en cola para activarse en la próxima recarga. |
getFailedUpdate | Recupera información sobre el bundle más reciente que falló al cargar. |
setShakeMenu | Activa o desactiva el menú de gesto de sacudida para depuración y pruebas. |
isShakeMenuEnabled | Comprueba si el menú de depuración por gesto de sacudida está actualmente activado. |
setShakeChannelSelector | Activa o desactiva el selector de canal por sacudida en tiempo de ejecución. |
isShakeChannelSelectorEnabled | Comprueba si el selector de canal por sacudida está actualmente activado. |
getAppId | Obtén el App ID configurado actualmente para la comunicación con el servidor de actualizaciones. |
setAppId | Cambia dinámicamente el App ID usado para la comunicación con el servidor de actualizaciones. |
getAppUpdateInfo | Obtén información sobre la disponibilidad de la app en App Store o Play Store. |
openAppStore | Abre la página de la app en App Store o Play Store. |
performImmediateUpdate | Realiza una actualización inmediata en la app en Android. |
startFlexibleUpdate | Inicia una actualización flexible en la app en Android. |
completeFlexibleUpdate | Completa una actualización flexible en la app en Android. |
Fuente de verdad
Sección titulada “Fuente de verdad”Esta referencia se sincroniza desde src/definitions.ts en capacitor-updater.
Sigue avanzando con @capgo/capacitor-updater
Sección titulada “Sigue avanzando con @capgo/capacitor-updater”Si estás usando @capgo/capacitor-updater para planificar el trabajo con plugins nativos, conéctalo con Al usar @capgo/capacitor-updater para la funcionalidad nativa al usar @capgo/capacitor-updater, Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para el detalle de implementación en los Plugins de Capacitor por Capgo, Añadir o actualizar plugins para el detalle de implementación en Agregar o actualizar plugins, y Alternativas a plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas a plugins de Ionic Enterprise.