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.

esta

Cordova CLI 12+
Android 13+ de Cordova y/o iOS 7+ de Cordova
Una cuenta de Capgo (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 navegador se sirva desde el esquema predeterminado. https://localhost/ El esquema.
El plugin registra un CordovaPluginPathHandler para servir activos de paquete descargados.

Requiere Cordova iOS 7+ con el esquema predeterminado. app://localhost/ El plugin implementa
para interceptar solicitudes de paquete. CDVPluginSchemeHandler Subir su primer paquete

Sección titulada “Subir su primer paquete”

Build your web assets, then upload with the Capgo CLI (same workflow as Capacitor):

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

Pasos siguientes

— la mayoría de las opciones se corresponden con Capacitor updater configuration Leer plugin.xml Compatibilidad con actualizaciones en vivo
antes de enviar cambios en el plugin nativo. Migrar a __CAPGO_KEEP_0__ más tarde? Mantenga el mismo ID de aplicación __CAPGO_KEEP_1__ y canales; solo cambia el paquete del cliente del plugin. Paso siguiente
Migrating to Capacitor later? Keep the same Capgo app ID and channels; only the client plugin package changes.