Guida introduttiva a Cordova Updater

Copia un prompt di configurazione 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 accompagna nell'aggiunta di @capgo/cordova-updater a un'app Cordova per ricevere aggiornamenti live Capgo 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 da npm e passa il tuo app ID Capgo:

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

Opzionale: sovrascrivi i valori predefiniti in fase di 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 usare cordova-plugin-ionic-webview con questo plugin.
Chiama notifyAppReady() non appena il bundle viene caricato, prima che le operazioni pesanti sulla UI ritardino la finestra di rollback.
Mantieni corrette le impostazioni dello schema 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+ in modo che la WebView venga servita dal default https://localhost/ predefinito.
Il plugin registra un CordovaPluginPathHandler per servire gli asset del bundle scaricato.

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

Carica il tuo primo bundle

Fai il build dei tuoi asset web, poi fai l'upload con Capgo CLI (stesso workflow di Capacitor):

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

Prossimi passi

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