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.