Empezar con Cordova Updater

Copia un prompt de configuración con los pasos de instalación y la guía de markdown completa 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 guía a través de la adición @capgo/cordova-updater a una aplicación de Cordova para que puedas recibir Capgo actualizaciones en vivo en iOS y Android.

Requisitos previos

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

Instalación

Instale el plugin desde npm y proporcione su Capgo ID de aplicación:
Ventana de terminal
```
cordova plugin add @capgo/cordova-updater --variable APP_ID=YOUR_CAPGO_APP_ID
```

Optional: sobreescribir valores por defecto durante la instalación (mismas variables que el Capacitor actualizador):

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

Preparar proyectos nativos después de cambiar las variables del plugin:
Ventana de terminal
```
cordova prepare android ios
```

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 envían 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 esquema predeterminado. https://localhost/ scheme.
para servir activos de paquete descargados. CordovaPluginPathHandler servir activos de paquete descargados.

Requiere Cordova iOS 7+ con el esquema predeterminado app://localhost/ esquema.
La plugin implementa CDVPluginSchemeHandler para interceptar solicitudes de paquetes.

Carga tu primer paquete

Construye tus activos web, luego carga con el Capgo CLI (mismo flujo que Capacitor):

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

Pasos siguientes

Comparar configuraciones con el Configuración del actualizador Capacitor — la mayoría de las opciones se corresponden con plugin.xml variables.
Lee compatibilidad con Live update antes de enviar cambios en el plugin nativo.
Migrando a Capacitor más adelante? Mantén el mismo ID de aplicación Capgo y canales; solo cambia el paquete del cliente del plugin.