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, saltando i tempi 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 dei bundle JavaScript. Se devi aggiornare il codice code nativo, come aggiungere o rimuovere un plugin o modificare la configurazione del progetto nativo, dovrai sottoporre un nuovo build binario tramite il consueto processo di distribuzione della piattaforma.

Modello Asset Pubblici

I bundle non criptati caricati su Capgo devono essere considerati asset di distribuzione pubblici. I canali determinano quali dispositivi ricevono un aggiornamento, ma la privacy del canale non rende riservato il bundle sottostante. La crittografia aggiunge protezione durante lo storage e il transito e impedisce a terzi di generare aggiornamenti criptati validi, ma non rende gli asset web impossibili da ispezionare, poiché l'app contiene la chiave pubblica necessaria per la decriptazione. Vedi la crittografia end-to-end per l'esatto threat model.

Come funzionano i Live Updates

Il sistema Live Update di Capgo ha due componenti chiave:

1. Il SDK Capgo, che installi nella tua app. Il SDK controlla la disponibilità di aggiornamenti e li scarica in background.

2. I channel, che ti permettono di indirizzare gli aggiornamenti a gruppi specifici di utenti. Puoi usare i channel per gestire diversi release track, come ad esempio Production, Staging, e Dev.

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

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

• Radiografia istantanea di ogni rollout: Le timeline per singolo dispositivo mostrano check, download, install, blocchi delle policy e rollback, così saprai esattamente cosa è successo, senza congetture o discussioni tipo "sul mio telefono funziona".
• Risposta agli incidenti più rapida: Codici simili ad alert (es. rate limit, checksum fail, mancanze di notifyAppReady) emergono prima che gli utenti inondino il supporto, permettendoti di rilasciare un fix o un rollback in pochi minuti.
• Policy dei canali garantita: I log confermano che i guardrail (blocco major, disabilitazione emulatori/dev build, limiti di piattaforma) proteggono attivamente la produzione.
• Protezione di ricavi e reputazione: Scopri 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.

Per iniziare

Per iniziare a usare Live Update, segui questi passaggi:

1. Completa il Quickstart di Capgo per configurare la tua app in Capgo e installare 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 update.

3. Crea il tuo JS bundle 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 la tua app per caricare il nuovo bundle.

Vedi la guida al deployment di Live Updates per maggiori dettagli.

Prossimi passi

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

Tipi di aggiornamento

Riferimento di tutti i tipi di update OTA: tempi 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 un cohort specifico, monitoralo e poi promuovilo o fai il rollback.

Rollback

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

Comportamento degli aggiornamenti

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

Workflow nativo + OTA

Canali Dev/production con --fail-on-incompatible, e come effettuare 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 inclusi nel bundle.

Aggiornamenti rapidi

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

Continua dalla panoramica

Se stai usando Panoramica per pianificare l'approvazione e la distribuzione negli 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 Utilizzo di @capgo/capacitor-native-market, e Aggiornamenti OTA Capacitor: Guida all'approvazione App Store per il contesto pratico in Aggiornamenti OTA Capacitor: Guida all'approvazione App Store.