Guía
Cómo usar Updater en Capacitor
Ionic y live updates de Capacitor con @capgo/capacitor-updater
@capgo/capacitor-updater es el plugin de actualización open source detrás de las live updates de Capgo para apps de Ionic y de Capacitor. Descarga web bundles aprobados, los aplica con protección nativa de rollback y mantiene los cambios exclusivos del binario en el flujo normal de revisión de App Store y Play Store.
Úsalo cuando necesites actualizaciones OTA para HTML, CSS, JavaScript, assets y otros cambios de la capa web una vez que tu shell nativo ya esté aprobado.
Instalar
npm install @capgo/capacitor-updater
npx cap sync
Dónde encaja
Para equipos de Ionic, las live updates normalmente implican el mismo flujo: lanzar un nuevo web bundle sin obligar a cada usuario a pasar por un release completo de la tienda. Capgo gestiona ese flujo para apps de Capacitor con canales, verificaciones de compatibilidad, control de rollout, logs de dispositivos y rollback.
Los plugins nativos, los entitlements, los cambios en el manifest de Android, los cambios en el plist de iOS y las actualizaciones del binario de SDK siguen requiriendo un release normal en la tienda. Mantén esos cambios en tu pipeline de build nativo y usa live updates para la capa web aprobada.
Lo que expone este plugin
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.
Ejemplo de uso
notifyAppReady
Notifica a la capa nativa que JavaScript se inicializó correctamente.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
const result = await CapacitorUpdater.notifyAppReady();
console.log(result);
setUpdateUrl
Configura la URL de actualización de la app dinámicamente en runtime.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.setUpdateUrl({ url: 'https://example.com' });
setStatsUrl
Configura la URL de estadísticas de la app dinámicamente en runtime.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.setStatsUrl({ url: 'https://example.com' });
setChannelUrl
Configura la URL del canal de la app dinámicamente en runtime.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.setChannelUrl({ url: 'https://example.com' });
Referencia completa
- GitHub: https://github.com/Cap-go/capacitor-updater/
- Docs: /docs/plugins/updater/
- Producto Live update: /live-update/
Sigue avanzando con @capgo/capacitor-updater
Si estás usando @capgo/capacitor-updater para planificar live updates, conéctalo con Live Updates para el flujo de trabajo del producto, @capgo/capacitor-updater para detalles de implementación, Primeros pasos, Canales, y Reversiones.