@capgo/capacitor-updater

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:

Updater para Cordova OTA para Cordova en iOS 7+ y Android 13+.

Updater para Electron Live updates para escritorio con los mismos API

Resumen

@capgo/capacitor-updater que impulsan Actualizaciones de bundles de JavaScript en apps de producción Capacitor sin esperar la revisión de la tienda. Descarga bundles firmados en segundo plano, controla el despliegue con canales y reglas de retraso, y haz rollback si notifyAppReady() no se llama dentro de la configuración de appReadyTimeout.

Usos típicos: hotfix de bugs en producción, betas escalonadas por canal, experimentos de UI A/B y rollback de emergencia al bundle integrado.

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

Los clientes de Cordova y Electron usan los plugins vinculados arriba con el mismo backend Capgo.

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 channel de la app dinámicamente en runtime.

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 channel de la app dinámicamente en runtime.
download	Descarga un nuevo bundle desde la URL para instalarlo después.
next	Define el siguiente bundle para activarlo al pausar o reiniciar la app.
set	Establece el bundle actual y recarga la app inmediatamente.
delete	Elimina un bundle del almacenamiento local para liberar espacio.
setBundleError	Marca manualmente un bundle como fallido en modo de actualización manual.
list	Obtén todos los bundles descargados localmente en tu app.
reset	Restablece la app a un bundle estable conocido.
current	Obtén información sobre el bundle que está activo actualmente.
reload	Recarga la app manualmente para aplicar una actualización pendiente.
setMultiDelay	Configura las condiciones necesarias para aplicar una actualización pendiente.
cancelDelay	Cancela las condiciones de espera y aplica la actualización de inmediato.
getLatest	Consulta el servidor de actualizaciones para ver la última versión disponible.
setChannel	Establece un canal de actualización local para este dispositivo. No crea un override de dispositivo en el dashboard de API.
unsetChannel	Elimina el canal asignado al dispositivo y vuelve al canal por defecto.
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 integrada (la versión original incluida en tu Native Build).
getDeviceId	Obtén el identificador único y privado de este dispositivo.
getPluginVersion	Obtén la versión del plugin Capacitor Updater instalada en tu app.
isAutoUpdateEnabled	Comprueba si las actualizaciones automáticas están habilitadas.
removeAllListeners	Elimina todos los event listeners registrados para este plugin.
addListener	Escucha el evento de descarga del bundle en la App. Se dispara al iniciar, durante y al finalizar la descarga, devolviendo el porcentaje de progreso.
addListener	Escucha el evento de 'no hay necesidad de actualizar', útil si quieres forzar la comprobación cada vez que se lanza la app.
addListener	Escucha el evento de actualización disponible, útil si quieres forzar una comprobación cada vez que se lanza la app.
addListener	Escucha los eventos de downloadComplete.
addListener	Escucha eventos de actualizaciones críticas cuando el backend marca una actualización como incompatible con la app actual. Emite el mismo payload que el majorAvailable listener.
addListener	Escucha el evento de actualización Major en la App; te avisa cuando una actualización importante se bloquea al configurar disableAutoUpdateBreaking.
addListener	Escucha el evento de fallo de actualización en la App; te avisa cuando una actualización no se pudo instalar al iniciar la app.
addListener	Escucha el evento set en la App; te avisa cuando un bundle se ha aplicado con éxito. Este evento se retiene nativamente hasta que JavaScript lo consume, por lo que si la app se recarga antes de conectar tu listener, el último set evento pendiente se entregará al suscribirse el listener.
addListener	Escucha el evento set next en la App; te avisa cuando un bundle se ha encolado como el próximo en instalarse.
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 de reload en la App; te avisa cuando se ha producido 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 puede entregarse tras un reload aunque el listener se conecte más tarde en el arranque.
addListener	Escucha el evento privado del canal, que se dispara al intentar establecer un canal que no permite la autoasignación del dispositivo.
addListener	Escucha los cambios de estado de las actualizaciones flexibles en Android.
isAutoUpdateAvailable	Comprueba si la función de auto-update está disponible (no desactivada por una configuración de servidor personalizada).
getNextBundle	Obtén información sobre el bundle en cola para activarse en el próximo reload.
getFailedUpdate	Recupera información sobre el bundle más reciente que falló al cargar.
setShakeMenu	Activa o desactiva el menú de gesto de sacudir (shake) para debugging y testing.
isShakeMenuEnabled	Comprueba si el menú de debug por gesto de sacudir está habilitado.
setShakeChannelSelector	Activa o desactiva el selector de canal por gesto de sacudir en runtime.
isShakeChannelSelectorEnabled	Comprueba si el selector de canal por gesto de sacudir está habilitado.
getAppId	Obtén el App ID configurado actualmente para la comunicación con el servidor de updates.
setAppId	Cambia dinámicamente el App ID usado para la comunicación con el servidor de updates.
getAppUpdateInfo	Obtén información sobre la disponibilidad de la app en la App Store o Play Store.
openAppStore	Abre la página de la app en la 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

Esta referencia se sincroniza desde src/definitions.ts en capacitor-updater.

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.