Avvio con Cordova Updater

Copia un prompt di configurazione con le istruzioni di installazione e la guida markdown completa per questo 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.

Questa guida ti guida attraverso l'aggiunta @capgo/cordova-updater a un'applicazione Cordova per poter ricevere Capgo aggiornamenti live su iOS e Android.

Sezione intitolata “Requisiti preliminari”

Cordova CLI 12+
Cordova Android 13+ e/o Cordova iOS 7+
Un account Capgo (capgo.app/register)

Installazione

Installa il plugin da npm e passa il tuo Capgo ID app:

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

Facoltativo: sovrascrivi i valori di default all'installazione (stesse variabili dell'Capacitor updater):

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 i progetti nativi dopo aver modificato le variabili del plugin:
Finestra del terminale
```
cordova prepare android ios
```

Utilizzo del JavaScript

Dopo deviceready, il plugin è disponibile come 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 });
  }
});

Tipi TypeScript vengono spediti con il pacchetto npm:

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

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

Richiede Cordova Android 13+ quindi il WebView viene servito dal default https://localhost/ schema.
Il plugin registra un CordovaPluginPathHandler per servire gli asset dei bundle scaricati.

Richiede Cordova iOS 7+ con lo schema app://localhost/ default.
Il plugin implementa CDVPluginSchemeHandler per intercettare le richieste dei bundle.

Carica il tuo primo bundle

Costruisci i tuoi asset web, quindi caricali con il Capgo CLI (stesso workflow di Capacitor):

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

Passaggi successivi

Confronta le impostazioni con il Capacitor configurazione dell'aggiornatore — le maggiori opzioni si mappano con plugin.xml le variabili.
Leggi Compatibilità con l'aggiornamento in tempo reale prima di inviare modifiche ai plugin nativi.
Stai migrando a Capacitor in un secondo momento? Mantieni lo stesso ID dell'applicazione Capgo e canali; cambia solo il pacchetto del plugin del client.