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

Prerequisiti

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 ID app Capgo:

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

Opzionale: sovrascrivi i valori di default al momento dell'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

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

Utilizzo di JavaScript

Dopo deviceready, l'aggiuntivo è 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 di TypeScript sono inclusi nel pacchetto npm:

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

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

Richiede Cordova Android 13+ affinché il WebView sia servito dallo schema predefinito. https://localhost/ scheme.
per servire gli asset del bundle scaricati. CordovaPluginPathHandler Richiede Cordova iOS 7+ con lo schema predefinito

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

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 la configurazione del configurazione dell'aggiornatore Capacitor — la maggior parte delle opzioni corrisponde plugin.xml Prossimi passaggi
Leggi Compatibilità con Live update prima della spedizione delle modifiche del plugin nativo.
Migrare a Capacitor in seguito? Mantieni lo stesso ID dell'app Capgo e canali; cambia solo il pacchetto del plugin del client.