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

Cordova Updater Plugin de Cordova

OTA live updates para Cordova en iOS y Android con el mismo 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 el mismo 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 plataforma

  • Cordova Android 13+ y Cordova iOS 7+
  • Esquemas por defecto de Cordova WebView (https://localhost/ en Android, app://localhost/ en iOS)
  • Evita cordova-plugin-ionic-webview — esto evita 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 plataformas Cordova como cualquier otro cambio nativo: lanza un nuevo binario a 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

FAQ 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"), luego sigue los pasos de configuración de Cordova en la guía y en 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 o JavaScript puro.

¿Es @capgo/cordova-updater gratuito y open source?

Sí. El código fuente de code es público en GitHub en https://github.com/Cap-go/cordova-updater/ y el paquete es gratuito en npm. Los reportes de bugs y pull requests son bienvenidos.

Lanza 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