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

Updater Cordova 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 gli aggiornamenti live di Capgo alle 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 swap dei bundle

Deploy di un nuovo bundle

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

Consigli pratici

  • Riutilizza lo stesso app ID e gli stessi canali di Capgo se distribuisci anche un client Capacitor o Electron.
  • Tratta gli aggiornamenti dei plugin nativi o delle piattaforme Cordova come qualsiasi altra modifica nativa: pubblica un nuovo binario sullo store prima di affidarti alle nuove API native nei bundle JavaScript.
  • I dettagli completi della configurazione si trovano nella Documentazione updater Cordova.

FAQ

FAQ del 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"), poi segui i passaggi di configurazione Cordova nella guida e il README di GitHub.

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

Sì. Cordova Updater è un pacchetto Cordova, quindi funziona con qualsiasi framework web che gira dentro Cordova, come React, Vue, Angular, Svelte e JavaScript puro.

@capgo/cordova-updater è gratuito 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 da installare da npm. Bug report e pull request sono benvenuti.

Pubblica le modifiche di Cordova Updater senza aspettare 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