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.