Panoramica

Usa la funzione Live Updates di Capgo per aggiornare i bundle JavaScript della tua app da remoto e in tempo reale. Invia aggiornamenti JS direttamente ai tuoi utenti su iOS, Android ed Electron, senza passare dai cicli di revisione degli store, per correggere bug e rilasciare nuove feature più velocemente. Per la panoramica del prodotto e le FAQ, consulta Live Updates di Capacitor su capgo.app.

Nota

I Live Updates sono limitati alle modifiche ai bundle JavaScript. Se devi aggiornare il codice nativo di code, ad esempio aggiungendo o rimuovendo un plugin o modificando la configurazione del progetto nativo, dovrai pubblicare una nuova build binaria tramite il consueto processo di distribuzione della piattaforma.

Modello degli asset pubblici

I bundle non criptati caricati su Capgo vanno considerati asset di distribuzione pubblici. I channel determinano quali dispositivi ricevono un aggiornamento, ma la privacy del channel non rende riservato il bundle sottostante. La crittografia aggiunge protezione nello storage e nel transito e impedisce a terzi di generare aggiornamenti criptati validi, ma non rende gli asset web distribuiti impossibili da ispezionare, perché l'app contiene la chiave pubblica necessaria per la decrittazione. Vedi crittografia end-to-end per il modello di minaccia esatto.

Come funzionano i Live Updates

Il sistema Live Update di Capgo ha due componenti chiave:

1. Il SDK di Capgo, che installi nella tua app. Il SDK controlla gli aggiornamenti disponibili e li scarica in background.

2. I canali ti permettono di indirizzare gli aggiornamenti a gruppi specifici di utenti. Puoi usarli per gestire diversi track di rilascio, come ad esempio: Production, Staging, e Dev.

Quando carichi un nuovo bundle JS su Capgo e lo assegni a un canale, il Capgo SDK nelle app configurate per quel canale rileverà l'aggiornamento e lo scaricherà. Al prossimo riavvio dell'app, verrà caricato il nuovo bundle.

Perché i log di Capgo sono importanti (ottica marketing)

• Radiografia istantanea di ogni rollout: Le timeline per singolo dispositivo mostrano controlli, download, installazioni, blocchi delle policy e rollback, così sai esattamente cosa è successo, senza congetture o discussioni del tipo «sul mio telefono funziona».
• Risposta agli incidenti più rapida: Codici di tipo alert (es. rate limit, errori di checksum, notifyAppReady mancanti) emergono prima che gli utenti intasino il supporto, permettendoti di pubblicare un fix o un rollback in pochi minuti.
• Prova delle policy dei canali: I log confermano che i guardrail (blocco major, disabilitazione emulatori/dev build, limiti di piattaforma) proteggono attivamente la produzione.
• Protezione di ricavi e reputazione: Vedi quando gli update si bloccano su reti scarse o raggiungono i limiti del piano, così puoi intervenire prima che calino conversioni, sessioni o recensioni.
• Unica fonte di veritàProduct, QA e Support condividono lo stesso stream di log cloud: niente più ricerche in Xcode/Android Studio o messaggi agli ingegneri per i log nativi.

Guida rapida

Per iniziare a usare Live Updates, segui questi passaggi:

1. Completa il Quickstart Capgo per configurare la tua app in Capgo e installare il Capgo SDK.

2. Nella tua app code, chiama CapacitorUpdater.notifyAppReady() dopo che l'app ha terminato l'inizializzazione. Questo comunica al Capgo SDK che la tua app è pronta a ricevere gli aggiornamenti.

3. Genera il tuo bundle JS e caricalo su Capgo:

   npm run build
   npx @capgo/cli@latest bundle upload --channel=production

4. Apri la tua app e attendi il download dell'update. Puoi controllare lo stato con:

   npx @capgo/cli@latest app debug

5. Una volta scaricato l'update, chiudi e riapri l'app per caricare il nuovo bundle.

Vedi la Deploy di Live Update guida per maggiori dettagli.

Prossimi passi

Per usare un hostname personalizzato per le richieste di update, segui la guida alla configurazione del Custom Domain.

Tipi di update

Riferimento di tutti i tipi di update OTA: timing di applicazione, condizioni di delay, version blocking e delivery.

Canali

Scopri come usare i canali per gestire diversi release track e indirizzare gli update a utenti specifici.

Rollout progressivi

Distribuisci un bundle di prova a una cohort specifica, monitoralo e poi promuovilo o fai il rollback.

Rollback

Scopri come fare il rollback a una versione precedente del bundle JS se un aggiornamento causa problemi.

Comportamento degli update

Personalizza come e quando gli aggiornamenti vengono scaricati e applicati nella tua app.

Workflow native + OTA

Canali dev/production con --fail-on-incompatible, e come fare l'upload quando i code nativi cambiano intenzionalmente.

Testa i Native Build

Verifica un binario nativo senza che un live update scaricato nasconda i web asset del bundle.

Aggiornamenti rapidi

Scopri come usare i fast updates per velocizzare il processo di aggiornamento.

Continua dalla Panoramica

Se stai usando Panoramica per pianificare approvazione e distribuzione sullo store, collegalo a @capgo/capacitor-in-app-review per i dettagli di implementazione in @capgo/capacitor-in-app-review, Utilizzo di @capgo/capacitor-in-app-review per la funzionalità nativa in Utilizzo di @capgo/capacitor-in-app-review, @capgo/capacitor-native-market per i dettagli di implementazione in @capgo/capacitor-native-market, Utilizzo di @capgo/capacitor-native-market per la funzionalità nativa in Using @capgo/capacitor-native-market, e Capacitor OTA Updates: Guida all'approvazione App Store per il contesto pratico in Capacitor OTA Updates: Guida all'approvazione App Store.