Iniziare con l'aggiornamento di Cordova

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 guida attraverso l'aggiunta @capgo/cordova-updater to a Cordova app so you can receive Capgo live updates on iOS and Android.

Prerequisites

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

Installazione

Installa il plugin da npm e passa il tuo Capgo ID dell'applicazione:
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'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

Preparare progetti nativi dopo aver modificato le variabili dei plugin:
Finestra del terminale
```
cordova prepare android ios
```

Utilizzo del JavaScript

Dopo devicereadyil 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 tipo 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 dallo schema predefinito. https://localhost/ scheme.
Il plugin si registra un CordovaPluginPathHandler per servire gli asset del bundle scaricati.

Richiede Cordova iOS 7+ con lo schema predefinito. app://localhost/ scheme.
per intercettare le richieste del bundle. CDVPluginSchemeHandler Carica il tuo primo bundle

Sottosezione intitolata “Carica il tuo primo bundle”

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

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

Next steps

Confronta le impostazioni con il Capacitor configurazione dell'aggiornatore — la maggior parte delle opzioni si mappa a plugin.xml variabili.
Leggi Live update compatibilità prima di inviare le modifiche del plugin nativo.
Migrando a Capacitor in seguito? Mantieni lo stesso ID dell'applicazione Capgo e canali; cambia solo il pacchetto del plugin del client.