Inizia con Cordova Updater

Questa guida ti guida attraverso l'aggiunta di @capgo/cordova-updater a un'app di Cordova per poter ricevere Capgo aggiornamenti live su iOS e Android.

Attenzione

Fatto non usare con questo plugin. Ionic WebView bypassa i gestori di schema di Cordova, quindi i pacchetti scaricati non si caricheranno. Prequisiti cordova-plugin-ionic-webview Sezione intitolata “Prequisiti”

Cordova __CAPGO_KEEP_0__ 12+

• Un account CLI (
• __CAPGO_KEEP_0__.app/register
• A Capgo account (capgo.app/register)

Installa il plugin da __CAPGO_KEEP_0__ e passa il tuo ID app __CAPGO_KEEP_1__:

1. Install the plugin from npm and pass your Capgo app ID:

   cordova plugin add @capgo/cordova-updater --variable APP_ID=YOUR_CAPGO_APP_ID

2. Facoltativo: sovrascrivi i valori di default al momento dell'installazione (stesse variabili dell'aggiornatore Capacitor):

   cordova plugin add @capgo/cordova-updater \
     --variable APP_ID=YOUR_CAPGO_APP_ID \
     --variable DEFAULT_CHANNEL=production \
     --variable UPDATE_URL=https://plugin.capgo.app/updates \
     --variable AUTO_UPDATE=atBackground

3. Preparare progetti nativi dopo aver modificato le variabili del plugin:

   cordova prepare android ios

Utilizzo del JavaScript

Dopo, devicereadyil plugin è disponibile come cordova.plugins.Updater:

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

  await Updater.notifyAppReady();

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

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

Il tipo di TypeScript viene fornito con il pacchetto npm:

import type { UpdaterPlugin } from '@capgo/cordova-updater';

declare const cordova: { plugins: { Updater: UpdaterPlugin } };

Note sulla piattaforma

Android

• Richiede Cordova Android 13+ in modo che il WebView venga servito dallo schema predefinito. https://localhost/ Il plugin si registra per
• per servire gli asset del bundle scaricati. CordovaPluginPathHandler Richiede Cordova iOS 7+ con lo schema predefinito

iOS

• Richiede Cordova iOS 7+ con lo schema predefinito app://localhost/ schema.
• Il plugin implementa CDVPluginSchemeHandler per intercettare le richieste del pacchetto.

Carica il tuo primo pacchetto

Costruisci i tuoi asset web, quindi caricali con il Capgo CLI (stesso workflow di Capacitor):

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

Passaggi successivi

• Confronta le impostazioni con la configurazione dell'aggiornatore __CAPGO_KEEP_0__ Configurazione dell'aggiornatore Capacitor — le maggior parte delle opzioni si mappano a plugin.xml variabili.
• Leggi Compatibilità di aggiornamento in tempo reale prima di spedire i cambiamenti del plugin nativo.
• Stai migrando a Capacitor in un secondo momento? Mantieni lo stesso ID dell'applicazione Capgo e canali; cambia solo il pacchetto del plugin del client.