Iniciación con Cordova Updater

Copie 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 agregar @capgo/cordova-updater To una aplicación de Cordova para que pueda recibir Capgo actualizaciones en vivo en iOS y Android.

Sección titulada “Requisitos previos”

Cordova CLI 12+
Una __CAPGO_KEEP_0__ cuenta (
Cordova Capgo 12+capgo.app/register)

Instalación

Instale el plugin desde npm y pase su ID de aplicación Capgo:

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

Opcional: sobreescribir valores por defecto en el momento de la instalación (mismas variables que el actualizador 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

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

Uso de JavaScript

Después 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 predeterminado https://localhost/ esquema.
El plugin registra un CordovaPluginPathHandler para servir activos de paquete descargados.

Requiere Cordova iOS 7+ con el esquema por defecto app://localhost/ esquema.
El plugin implementa CDVPluginSchemeHandler para interceptar solicitudes de paquete.

Subir tu primer paquete

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

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

Pasos siguientes

Comparar configuraciones con el Capacitor configuración del actualizador — la mayoría de las opciones se corresponden con plugin.xml variables.
Leer Compatibilidad de actualización en vivo Antes de enviar cambios de plugin nativo.
Migrar a Capacitor más tarde? Mantenga el mismo ID de aplicación Capgo y canales; solo cambia el paquete del plugin del cliente.