Salta al contenuto principale
@capgo/cordova-updater Aggiornamenti Open source

Cordova Updater Plugin Cordova

Live update OTA per Cordova iOS e Android con lo stesso API di capacitor-updater

Installa

bun add @capgo/cordova-updater
npm, pnpm o yarn
  • npm install @capgo/cordova-updater
  • pnpm add @capgo/cordova-updater
  • yarn add @capgo/cordova-updater

Guida

Come usare Cordova Updater in Cordova

Usare @capgo/cordova-updater

@capgo/cordova-updater porta le live updates di Capgo nelle app Cordova iOS e Android con lo stesso API JavaScript di @capgo/capacitor-updater. Installa il plugin Cordova, chiama notifyAppReady() a 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

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 della piattaforma

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

Deploy di un nuovo bundle

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

Consigli pratici

  • Riutilizza lo stesso ID app e gli stessi canali Capgo se distribuisci anche un client Capacitor o Electron.
  • Gestisci gli upgrade dei plugin nativi o delle piattaforme Cordova come ogni altra modifica nativa: rilascia un nuovo binario sugli store prima di fare affidamento su nuove API native nei bundle JavaScript.
  • I dettagli completi sulla configurazione sono in documentazione di Cordova updater.

FAQ

FAQ sul plugin Cordova Updater

Come installo il plugin Cordova Updater in un'app Cordova?

Esegui "bun add @capgo/cordova-updater" (o "npm install @capgo/cordova-updater"), quindi segui i passaggi di configurazione Cordova nella guida e nel README di GitHub.

@capgo/cordova-updater funziona con React, Vue e Angular?

Sì. Cordova Updater è un pacchetto Cordova, quindi funziona con qualsiasi web framework in esecuzione all'interno di Cordova, come React, Vue, Angular, Svelte o JavaScript puro.

@capgo/cordova-updater è free e open source?

Sì. Il codice sorgente di code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/cordova-updater/ e il pacchetto è gratuito su npm. Bug report e pull request sono i benvenuti.

Distribuisci modifiche a Cordova Updater senza attendere la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo