Pasar al contenido principal
Volver a plugins
@capgo/cordova-updater
Tutoriales
@capgo/cordova-updater

Actualización de Cordova

Actualizaciones en vivo OTA para Cordova iOS y Android con el mismo API como capacitor-actualizador

Guía

Tutorial sobre Actualizador de Cordova

Usando @capgo/cordova-updater

@capgo/cordova-updater trae actualizaciones en vivo de Capgo a las aplicaciones de Cordova iOS y Android con el mismo JavaScript API @capgo/capacitor-updaterInstale el plugin de Cordova, llame a notifyAppReady() en cada arranque, y suba paquetes con @capgo/cli.

Instalación

cordova plugin add @capgo/cordova-updater --variable APP_ID=com.example.app
cordova prepare android ios

Uso básico

document.addEventListener('deviceready', async () => {
  const { Updater } = cordova.plugins;

  await Updater.notifyAppReady();

  const { bundle } = await Updater.current();
  console.log('Active bundle', bundle);

  const latest = await Updater.getLatest();
  if (latest.url && !latest.error) {
    const downloaded = await Updater.download({
      url: latest.url,
      version: latest.version,
      checksum: latest.checksum,
    });

    await Updater.next({ id: downloaded.id });
  }
});

Requisitos del sistema

  • Android de Cordova 13+ y iOS de Cordova 7+
  • Esquemas de WebView Cordova predeterminados (https://localhost/ en Android, app://localhost/ en iOS)
  • Evita cordova-plugin-ionic-webview — impide el intercambio de paquetes

Despliega un nuevo paquete

bun run build
bunx @capgo/cli@latest bundle upload --channel=production

Consejos prácticos

  • Reutiliza el mismo ID de aplicación Capgo y canales si también envías un cliente Capacitor o Electron.
  • Trata las actualizaciones de plugins nativos o plataforma de Cordova como cualquier otro cambio nativo: envía un binario de tienda nuevo antes de confiar en nuevas APIs nativas en paquetes de JavaScript.
  • Detalles de configuración completos se encuentran en el Documentación de actualizador de Cordova.