Saltare al contenuto principale
Indietro ai plugin
@capgo/cordova-updater
Tutorial
@capgo/cordova-updater

Aggiornamento Cordova

Aggiornamenti in tempo reale OTA per Cordova iOS e Android con lo stesso API come capacitor-aggiornatore

Guida

Tutorial sul Cordova Updater

Usando @capgo/cordova-updater

@capgo/cordova-updater porta Capgo aggiornamenti live a Cordova iOS e Android app con lo stesso JavaScript API @capgo/capacitor-updaterInstalla il plugin Cordova, chiama notifyAppReady() a ogni avvio, e carica bundle con @capgo/cli.

Installazione

cordova plugin add @capgo/cordova-updater --variable APP_ID=com.example.app
cordova prepare android ios

Utilizzo base

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

  await Updater.notifyAppReady();

  const { bundle } = await Updater.current();
  console.log('Active bundle', bundle);

  const latest = await Updater.getLatest();
  if (latest.url && !latest.error) {
    const downloaded = await Updater.download({
      url: latest.url,
      version: latest.version,
      checksum: latest.checksum,
    });

    await Updater.next({ id: downloaded.id });
  }
});

Requisiti del sistema

  • Android Cordova 13+ e iOS Cordova 7+
  • Schemi di WebView Cordova predefiniti (https://localhost/ su Android, app://localhost/ su iOS)
  • Evita cordova-plugin-ionic-webview — impedisce lo scambio di pacchetti

Distribuisci un nuovo pacchetto

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

Consigli pratici

  • Ripeti lo stesso ID dell'app Capgo e canali se anche distribuisci un client Capacitor o Electron.
  • Tratta gli aggiornamenti dei plugin nativi o delle piattaforme Cordova come qualsiasi altro cambiamento nativo: distribuisci un nuovo binario di magazzino prima di affidarti a nuove API native in bundle JavaScript.
  • Dettagli di configurazione completi sono disponibili in Dal documento di aggiornamento di Cordova.