Saltare al contenuto principale
@capgo/cordova-updater Aggiornamenti Sorgente aperta

Aggiornatore di Cordova Plugin Cordova

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

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 utilizzare Cordova Updater in Cordova

Utilizzando @capgo/cordova-updater

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

Distribuisci un nuovo bundle

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

Consigli pratici

  • Ripristina lo stesso Capgo ID dell'app e dei canali se anche distribuisce un Capacitor o un client Electron.
  • Trovate gli aggiornamenti dei plugin nativi o delle piattaforme Cordova come qualsiasi altro cambiamento nativo: distribuisca un nuovo binario di archiviazione prima di affidarsi a nuove API native in bundle JavaScript.
  • Dettagli di configurazione completa sono disponibili in Dati di configurazione del Cordova updater.

FAQ

Faq del plugin di aggiornamento di Cordova

Come installare 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 di Cordova nella guida e il GitHub README.

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

Sì. Cordova Updater è un pacchetto Cordova, quindi funziona con qualsiasi framework web che esegue all'interno di Cordova, React, Vue, Angular, Svelte e JavaScript puro.

È @capgo/cordova-updater gratuito e open source?

Sì. Il codice sorgente code è pubblico su GitHub a https://github.com/Cap-go/cordova-updater/ e il pacchetto è gratuito per l'installazione da npm. I segnalazioni di bug e le richieste di pull sono benvenute.

Condividi le modifiche del plugin Cordova Updater senza attendere la revisione dell'app

Una volta che il plugin è presente nella tua build di store, Capgo aggiornamenti live inviano le tue modifiche JavaScript, HTML e CSS ai utenti in pochi minuti

Inizia con Capgo