Guida rapida a Cordova Updater

Copia un prompt di setup 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 mostra come aggiungere @capgo/cordova-updater a un'app Cordova per ricevere Capgo live update su iOS e Android.

Prerequisiti

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

Installazione

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

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

Opzionale: sovrascrivi i default durante l'installazione (stesse variabili dell'updater 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
```

Avvio rapido

document.addEventListener('deviceready', async () => {
  await cordova.plugins.Updater.notifyAppReady();
});

Errori comuni

Non utilizzare cordova-plugin-ionic-webview con questo plugin.
Esegui notifyAppReady() non appena il bundle viene caricato, prima che il lavoro pesante sulla UI ritardi la finestra di rollback.
Mantieni corretti gli schemi di Cordova.

Utilizzo di JavaScript

Dopo aver 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 });
  }
});

I tipi TypeScript sono inclusi nel pacchetto npm:

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

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

Richiede Cordova Android 13+ affinché la WebView venga servita dallo https://localhost/ scheme.
Il plugin registra un CordovaPluginPathHandler per servire gli asset del bundle scaricato.

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

Carica il tuo primo bundle

Builda i tuoi asset web, poi carica con Capgo CLI (stesso workflow di Capacitor):

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

Prossimi passi

Confronta le impostazioni con la configurazione dell'updater Capacitor — la maggior parte delle opzioni corrisponde a plugin.xml variabili.
Leggi Compatibilità Live update prima di distribuire modifiche al plugin nativo.
Passerai a Capacitor in seguito? Mantieni lo stesso app ID e gli stessi canali Capgo; cambia solo il pacchetto del plugin client.