Avvio con l'aggiornatore di Cordova

Copia un prompt di installazione con i passaggi 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 di @capgo/cordova-updater per un'applicazione Cordova in modo da poter ricevere Capgo aggiornamenti in tempo reale su iOS e Android.

Sezione intitolata “Requisiti”

Cordova CLI 12+
Un __CAPGO_KEEP_0__ account (
A Capgo account (capgo.app/register)

Installazione

Installa il plugin da npm e inserisci il tuo ID dell'app Capgo:
Finestra del terminale
```
cordova plugin add @capgo/cordova-updater --variable APP_ID=YOUR_CAPGO_APP_ID
```

Facoltativo: sovrascrivi i valori di default all'installazione (stesse variabili dell'aggiornatore 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 i progetti nativi dopo aver modificato le variabili del plugin:
Finestra del terminale
```
cordova prepare android ios
```

Utilizzo di 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 });
  }
});

Il tipo di dati TypeScript è incluso nel 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 del bundle scaricati.

Richiede Cordova iOS 7+ con il default app://localhost/ schema.
Il plugin implementa CDVPluginSchemeHandler per intercettare le richieste del 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'aggiornamento — la maggior parte delle opzioni si mappa a plugin.xml variabili.
Leggi Compatibilità dell'aggiornamento in tempo reale prima di spedire i cambiamenti del plugin nativo.
Migrare a Capacitor in un secondo momento? Mantieni lo stesso ID dell'applicazione Capgo e canali; cambia solo il pacchetto del plugin del client.