Avvio rapido con l'aggiornatore di Cordova

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 to a Cordova app so you can receive Capgo live updates on iOS and 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 sono inclusi 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/ Lo schema predefinito.
Il plugin registra un CordovaPluginPathHandler per servire gli asset dei bundle scaricati.

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

Sezione intitolata “Carica il tuo primo bundle”

Build your web assets, then upload with the Capgo CLI (same workflow as Capacitor):

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

Passaggi successivi

Confronta le impostazioni con il Capacitor configurazione dell'aggiornatore — la maggior parte delle opzioni si mappa con plugin.xml variabili.
Leggi Compatibilità dell'aggiornamento in tempo reale prima di distribuire modifiche ai plugin nativi.
Migrando a Capacitor in seguito? Mantieni lo stesso ID dell'applicazione Capgo e canali; cambia solo il pacchetto del plugin del client.