Introducción a Cordova Updater

Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/cordova-updater`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/cordova-updater/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Esta guía te explica cómo añadir @capgo/cordova-updater a una app de Cordova para que recibas actualizaciones en vivo de Capgo en iOS y Android.

Requisitos

Cordova CLI 12+
Cordova Android 13+ y/o Cordova iOS 7+
Una cuenta de Capgo (capgo.app/register)

Instalación

Instala el plugin desde npm y pasa tu ID de app de Capgo:

cordova plugin add @capgo/cordova-updater --variable APP_ID=YOUR_CAPGO_APP_ID

Opcional: sobrescribe los valores predeterminados en la instalación (mismas variables que el updater de Capacitor):

cordova plugin add @capgo/cordova-updater \
  --variable APP_ID=YOUR_CAPGO_APP_ID \
  --variable DEFAULT_CHANNEL=production \
  --variable UPDATE_URL=https://plugin.capgo.app/updates \
  --variable AUTO_UPDATE=atBackground

Prepara los proyectos nativos tras cambiar las variables del plugin:
Ventana de terminal
```
cordova prepare android ios
```

Inicio rápido

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

Errores comunes

No uses cordova-plugin-ionic-webview con este plugin.
Llama a notifyAppReady() en cuanto cargue tu bundle, antes de que el trabajo pesado de la UI retrase la ventana de rollback.
Mantén correcta la configuración del scheme de Cordova.

Uso de JavaScript

Después de deviceready, el plugin está disponible como cordova.plugins.Updater:

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

  await Updater.notifyAppReady();

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

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

Los tipos de TypeScript se incluyen con el paquete npm:

import type { UpdaterPlugin } from '@capgo/cordova-updater';

declare const cordova: { plugins: { Updater: UpdaterPlugin } };

Requiere Cordova Android 13+ para que el WebView se sirva desde el https://localhost/ scheme.
El plugin registra un CordovaPluginPathHandler para servir los assets del bundle descargado.

Requiere Cordova iOS 7+ con el app://localhost/ scheme.
El plugin implementa CDVPluginSchemeHandler para interceptar las peticiones del bundle.

Sube tu primer bundle

Genera tus web assets y luego súbelos con Capgo CLI (mismo flujo que Capacitor):

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

Próximos pasos

Compara los ajustes con la configuración del updater de Capacitor — la mayoría de las opciones plugin.xml variables.
Consulta la compatibilidad de Live update antes de publicar cambios en plugins nativos.
¿Migrarás a Capacitor más adelante? Mantén el mismo app ID y canales de Capgo; solo cambia el paquete del plugin cliente.