Saltar al contenido principal
@capgo/actualizador-de-cordova Actualizaciones Fuente abierta

Actualizador de Cordova Plugin de Cordova

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

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

Usando @capgo/cordova-updater

@capgo/cordova-updater trae Capgo actualizaciones en vivo a aplicaciones de Cordova iOS y Android con el mismo JavaScript API @capgo/capacitor-updater. Instale el plugin de Cordova, llame 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

  • Cordova Android 13+ y Cordova iOS 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

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

FAQ

Actualizador de Cordova FAQ

¿Cómo instalo el plugin de actualizador de Cordova en una aplicación 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 el GitHub README.

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

Sí. El actualizador de Cordova 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 code está público en GitHub en https://github.com/Cap-go/cordova-updater/ y el paquete es gratuito para instalar desde npm. Se aceptan informes de errores y solicitudes de cambios.

Envíe cambios de Cordova Updater sin esperar la revisión de la aplicación

Una vez que el plugin esté en tu tienda de construcción, Capgo actualizaciones en vivo envían cambios en JavaScript, HTML y CSS a los usuarios en minutos.

Comience con Capgo