Se stai cercando un'alternativa a Cordova hot code push, probabilmente è perché cordova-hot-code-push-plugin e CodePush di Microsoft per Cordova hanno smesso di funzionare o di essere mantenuti. Un'opzione mantenuta oggi è @capgo/cordova-updater, un plugin Cordova che porta Capgo live updates a app Cordova Android 13+ e Cordova iOS 7+, con canali, rollback e bundle cifrati, senza costringerti a migrare prima a Capacitor.
Lo stato delle live updates per Cordova nel 2026
cordova-hot-code-push è archiviato
Il nordnet/cordova-hot-code-push il repository è archiviato su GitHub. L'ultima modifica al code è stata nel settembre 2018 e l'ultimo rilascio npm di cordova-hot-code-push-plugin è 1.5.3. Era progettato per le piattaforme Cordova e il caricamento WebView basato su file di quell'epoca. Il moderno Cordova Android serve l'app da https://localhost tramite un path handler, e Cordova iOS usa WKWebView con un app:// scheme. Un plugin che presuppone file:// loading non si adatta a quel modello e nessuno lo sta aggiornando.
Le installazioni esistenti potrebbero sembrare funzionanti se non aggiorni mai le piattaforme Cordova. È la trappola: non puoi passare a un Android Cordova o Xcode attuale senza rischiare il meccanismo di aggiornamento.
CodePush per Cordova è scomparso
Microsoft ha archiviato cordova-plugin-code-push, ha terminato il supporto per Cordova in App Center nel 2022 e ha dismesso il servizio core di App Center, incluso build, distribuzione e CodePush, il 31 marzo 2025. Il plugin comunicava con il servizio CodePush in App Center, quindi non c'è più un backend per servire gli aggiornamenti. Se sei passato all'auto-hosting del server CodePush, dipendi comunque da un plugin client archiviato.
Alternative a Ionic Appflow
cordova-plugin-ionic ha collegato le app Cordova agli aggiornamenti live di Ionic Appflow. Ionic ha annunciato che Appflow verrà chiuso, quindi le team che lo usano cercano anche loro un'alternativa. Copriamo quel percorso nella guida alle alternative di Appflow.
Cosa serve a un'alternativa
Prima di scegliere qualsiasi tool, verificalo rispetto a questi requisiti:
| Requisito | Perché è importante |
|---|---|
| Funziona con Cordova Android e iOS attuali | I requisiti dei store impongono aggiornamenti di piattaforma: Xcode 26 per gli upload su App Store da aprile 2026 e incrementi annuali del target Android API su Google Play |
Nessuna dipendenza da cordova-plugin-ionic-webview |
Quel plugin è obsoleto e va in conflitto con i moderni scheme handler |
| Rollback automatico | Un bundle errato non deve bloccare l'app |
| Canali | Testa sugli utenti interni prima di tutti gli altri |
| Bundle firmati o criptati | Previene la manomissione di code trasmessi via rete |
| Targeting delle versioni | Non inviare mai JavaScript che richieda un native shell più recente |
| CLI compatibile con la CI | I rilasci dovrebbero essere un singolo comando nella tua pipeline |
| Mantenuto | Controlla le release recenti, non solo le stelle |
Capgo per Cordova
@capgo/cordova-updater usa lo stesso API JavaScript di @capgo/capacitor-updater e lo stesso backend Cloud Capgo. Bundle, canali, statistiche e firma funzionano allo stesso modo per i client Cordova, Capacitor ed Electron.
Requisiti
- Cordova CLI 12+
- Cordova Android 13+ (schema
https://localhost/predefinito) - Cordova iOS 7+ (predefinito)
app://localhost/predefinito) cordova-plugin-ionic-webviewrimosso)
Controlla le tue piattaforme:
cordova platform ls
Aggiorna se necessario:
cordova platform rm android && cordova platform add android@latest
cordova platform rm ios && cordova platform add ios@latest
Installa
Crea l'app in Capgo (dashboard o CLI), poi aggiungi il plugin con il tuo app ID:
bunx @capgo/cli@latest login
bunx @capgo/cli@latest app add com.example.app --name "My Cordova App"
cordova plugin add @capgo/cordova-updater --variable APP_ID=com.example.app
cordova prepare android ios
Puoi impostare altre opzioni al momento dell'installazione. Si tratta di variabili del plugin, quindi esegui cordova prepare dopo averle modificate:
cordova plugin add @capgo/cordova-updater \
--variable APP_ID=com.example.app \
--variable DEFAULT_CHANNEL=production \
--variable AUTO_UPDATE=atBackground \
--variable APP_READY_TIMEOUT=10000
AUTO_UPDATE ha come default atBackground, che scarica gli aggiornamenti in background e li applica la prossima volta che l'app passa in background. Altre modalità includono atInstall, onLaunch e off per un controllo completamente manuale.
Indica al plugin che l'app è partita correttamente
Questa è la riga che non puoi saltare. Chiama notifyAppReady() a ogni avvio successivo deviceready. Se un nuovo bundle non lo chiama entro APP_READY_TIMEOUT millisecondi, il plugin lo segna come fallito e torna all'ultimo bundle funzionante.
document.addEventListener('deviceready', async () => {
const { Updater } = cordova.plugins;
await Updater.notifyAppReady();
}, false);
Chiamalo dopo che l'app ha effettivamente renderizzato, non all'inizio dello script, così da rilevare un bundle che va in crash all'avvio.
Flusso di aggiornamento manuale
Se imposti AUTO_UPDATE=off, controlli quando verificare, scaricare e applicare:
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,
});
// Applied on next background/restart
await Updater.next({ id: bundle.id });
}
});
I tipi TypeScript sono inclusi nel pacchetto:
import type { UpdaterPlugin } from '@capgo/cordova-updater';
declare const cordova: { plugins: { Updater: UpdaterPlugin } };
Pubblica un aggiornamento
Builda la tua www cartella e fai l'upload:
bun run build
bunx @capgo/cli@latest bundle upload com.example.app --path ./www --channel production
Inseriscilo nella CI dopo i test. La pagina live updates mostra i rollout dei canali, le statistiche e il rollback dalla dashboard.
Migrare da cordova-hot-code-push
- Rimuovi il vecchio plugin e la sua configurazione. Elimina
cordova-hot-code-push-plugin, ilchcpsezione inconfig.xml, e ilcordova-hcpCLI echcp.json/chcp.manifestgenerazione dalla tua build. - Rimuovi
cordova-plugin-ionic-webviewse presente, e verifica che l'app funzioni sulla WebView Cordova predefinita. - Aggiorna le piattaforme Cordova a Android 13+ e iOS 7+.
- Installa
@capgo/cordova-updatere aggiunginotifyAppReady(). - Pubblica un nuovo build per lo store. Le installazioni precedenti mantengono il vecchio plugin. Solo il nuovo binario contiene l'updater Capgo.
- Carica il tuo primo bundle su un canale di test, verificalo sui dispositivi, poi promuovilo in produzione.
Gli utenti che non aggiornano dallo store rimarranno sul vecchio meccanismo finché non lo faranno. Tieni online il vecchio server di update durante la transizione se ancora funzionante, oppure accetta che quegli utenti non ricevano aggiornamenti OTA finché non installano il nuovo binario.
Migrazione da CodePush per Cordova
- Sostituisci
codePush.sync()chiamate connotifyAppReady()e la modalità automatica o ilgetLatest/download/nextflusso. - Sostituisci le chiavi di deployment con i canali (
DEFAULT_CHANNEL). - Sostituisci
code-push release-cordovaconbunx @capgo/cli@latest bundle upload. - Rimuovi l'import
CodePushDeploymentKeypreferenze daconfig.xml.
Per una versione passo-passo pensata per gli utenti di App Center, consulta la guida alla migrazione da App Center.
Sicurezza e regole degli store
- Crittografia e firma. Imposta
PUBLIC_KEYal momento dell'installazione e usa le chiavi di crittografia di CLI, in modo che i dispositivi accettino solo i bundle firmati per la tua app. - Policy di Apple e Google. Entrambe permettono di aggiornare code interpretato, come JavaScript, via OTA, purché non si cambi la finalità dell'app o si aggiungano funzionalità che richiederebbero una nuova revisione. Per code nativi, nuovi plugin o modifiche ai permessi serve una release sugli store.
- Targeting della versione. Se un bundle richiede un plugin nativo presente solo in un binario più recente, punta a quella versione nativa. La documentazione Capgo su compatibilità live update spiega come fare.
Risoluzione problemi
Il bundle viene scaricato ma l'app mostra la vecchia versione. Stai ancora usando cordova-plugin-ionic-webview, o uno scheme custom. Rimuovilo e usa i valori di default.
L'app fa rollback dopo ogni aggiornamento. notifyAppReady() non viene chiamata, o viene chiamata dopo un errore. Controlla la console sul dispositivo e conferma che la chiamata venga eseguita a ogni avvio.
La build iOS fallisce dopo l'upgrade della piattaforma. Cordova iOS 7+ richiede un Xcode aggiornato. Gli upload su App Store richiedono Xcode 26. Puoi generare gli asset di firma con l' Generatore di certificati iOS. Una volta passato a Capacitor, Build Capgo puoi generare build iOS firmate nel cloud senza un Mac locale.
Gli update funzionano su Android ma non su iOS. Controlla che lo scheme iOS in config.xml sia lo scheme app predefinito con localhost hostname.
Meglio passare a Capacitor invece?
Non è necessario. Capgo per Cordova esiste proprio per permetterti di continuare a rilasciare aggiornamenti mentre decidi. Capacitor offre uno strato nativo mantenuto, Swift Package Manager su iOS e un ecosistema di plugin più vasto. Quando sarai pronto, potrai mantenere lo stesso Capgo app ID e gli stessi canali, cambiando solo il plugin client. La nostra Guida alla migrazione da Cordova a Capacitor lo spiega passo dopo passo.