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

Icoda Updater

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

Guida

Tutorial sul Cordova Updater

Utilizza @capgo/cordova-updater

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

Installazione

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

Uso 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 di Cordova 13+ e iOS di Cordova 7+
  • Schemi di WebView di Cordova predefiniti (https://localhost/ su Android, app://localhost/ su iOS)
  • Evita cordova-plugin-ionic-webview – impedisce lo scambio di bundle

Distribuisci un nuovo bundle

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

Consigli pratici

  • Ripeti lo stesso ID dell'app Capgo e i canali se anche distribuisci un client Capacitor o Electron.
  • Tieni conto degli aggiornamenti dei plugin nativi o delle piattaforme di Cordova come di ogni altro cambiamento nativo: distribuisci un nuovo binario di negozio prima di affidarti a nuove API native in bundle JavaScript.
  • Dettagli di configurazione completo sono disponibili in Dati del documento aggiornatore di Cordova.