Salta al contenuto principale

Alternativa a Cordova Hot Code Push nel 2026

cordova-hot-code-push e CodePush per Cordova sono morti. Ecco un'alternativa mantenuta per l'hot code push di Cordova, con setup, passaggi di migrazione e rollback.

Illustrazione del logo Cordova per una guida alternativa a Cordova hot code push

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-webview rimosso)

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

  1. Rimuovi il vecchio plugin e la sua configurazione. Elimina cordova-hot-code-push-plugin, il chcp sezione in config.xml, e il cordova-hcp CLI e chcp.json / chcp.manifest generazione dalla tua build.
  2. Rimuovi cordova-plugin-ionic-webview se presente, e verifica che l'app funzioni sulla WebView Cordova predefinita.
  3. Aggiorna le piattaforme Cordova a Android 13+ e iOS 7+.
  4. Installa @capgo/cordova-updater e aggiungi notifyAppReady().
  5. Pubblica un nuovo build per lo store. Le installazioni precedenti mantengono il vecchio plugin. Solo il nuovo binario contiene l'updater Capgo.
  6. 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 con notifyAppReady() e la modalità automatica o il getLatest / download / next flusso.
  • Sostituisci le chiavi di deployment con i canali (DEFAULT_CHANNEL).
  • Sostituisci code-push release-cordova con bunx @capgo/cli@latest bundle upload.
  • Rimuovi l'import CodePushDeploymentKey preferenze da config.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_KEY al 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.

Live updates per le app Capacitor

Quando un bug nel web-layer è live, rilascia la fix tramite Capgo invece di aspettare giorni l'approvazione degli store. Gli utenti ricevono l'update in background, mentre le modifiche native restano nel normale processo di review.

Ultimi articoli dal blog

Capgo ti offre gli insight migliori che ti servono per creare un'app mobile davvero professionale.