Saltar al contenido principal
@capgo/cordova-updater Actualizaciones Código abierto

Updater de Cordova Plugin de Cordova

Live updates OTA para Cordova en iOS y Android con la misma API que capacitor-updater

Instalar

bun add @capgo/cordova-updater
npm, pnpm o yarn
  • npm install @capgo/cordova-updater
  • pnpm add @capgo/cordova-updater
  • yarn add @capgo/cordova-updater

Guía

Cómo usar Cordova Updater en Cordova

Usar @capgo/cordova-updater

@capgo/cordova-updater ofrece Capgo live updates para apps de Cordova en iOS y Android con la misma API de JavaScript que @capgo/capacitor-updater. Instala el plugin de Cordova y llama a notifyAppReady() en cada inicio, y sube bundles 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 de la plataforma

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

Desplegar un nuevo bundle

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

Consejos prácticos

  • Reutiliza el mismo ID de app y canales de Capgo si también lanzas un cliente Capacitor o Electron.
  • Trata las actualizaciones de plugins nativos o de plataformas Cordova como cualquier otro cambio nativo: publica un nuevo binario en la tienda antes de usar nuevas APIs nativas en tus bundles de JavaScript.
  • Los detalles de la configuración completa están en la documentación de Cordova updater.

FAQ

Preguntas frecuentes del plugin Cordova Updater

¿Cómo instalo el plugin Cordova Updater en una app de Cordova?

Ejecuta "bun add @capgo/cordova-updater" (o "npm install @capgo/cordova-updater") y luego sigue los pasos de configuración de Cordova en la guía y el README de GitHub.

¿Funciona @capgo/cordova-updater con React, Vue y Angular?

Sí. Cordova Updater es un paquete de Cordova, por lo que funciona con cualquier framework web que se ejecute dentro de Cordova: React, Vue, Angular, Svelte y JavaScript puro.

¿Es @capgo/cordova-updater gratuito y de código abierto?

Sí. El código fuente de code es público en GitHub en https://github.com/Cap-go/cordova-updater/ y el paquete se puede instalar gratis desde npm. Se aceptan informes de errores y pull requests.

Publica cambios de Cordova Updater sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo