Salta al contenuto principale
Update in produzione

Porta ogni utente all'ultima fix

Fai l'upload di un nuovo web bundle da CLI o dalla CI. I dispositivi lo scaricano in background e lo eseguono la prossima volta che l'app torna in foreground. Fai il rollout per percentuale, monitoralo con Observe e fai il rollback se dà problemi.

Nessuna carta di credito richiesta
Rollback automatico integrato
Solo aggiornamenti del layer web

Il problema

A store release is a slow way to ship a small fix

Il percorso di correzione solo tramite store

1

Trova il bug

Il monitoring o il supporto segnala una schermata rotta. La correzione richiede poche righe di JavaScript o CSS.

2

Compila un nuovo binario

Aggiorni la versione, compili per iOS e Android e prepari due invii agli store.

3

In attesa di revisione

La revisione dello store richiede spesso 24–48 ore, a volte molto di più. Un rifiuto fa ripartire l'attesa.

4

Aspetta che gli utenti aggiornino

Dopo l'approvazione, ogni utente deve comunque installare la nuova versione. Fino ad allora, esegue il vecchio code.

Ogni passaggio aggiunge tempo tra la correzione pronta e la sua esecuzione sui dispositivi dei tuoi utenti.

Why store fixes reach users slowly

24–48h+

Tempo tipico di revisione store

Apple e Google revisionano ogni nuovo binario. La revisione dura spesso 24–48 ore, a volte molto di più, e un rifiuto significa inviare di nuovo.

Per utente

Store updates depend on each device

Un aggiornamento store raggiunge un dispositivo solo quando l'utente, o la sua impostazione di aggiornamento automatico, lo installa. Alcuni dispositivi restano su vecchie build per molto tempo.

2 store

Due submission per ogni fix

Lo stesso fix web deve passare separatamente per App Store e Google Play, ognuno con la propria revisione e rilascio.

La soluzione

Come un live update raggiunge i tuoi utenti

Questo è il comportamento predefinito di Capgo. Nessun prompt di aggiornamento, nessun riavvio forzato e nessuna sottomissione agli store per le modifiche al web-layer.

Flusso di aggiornamento predefinito

  1. L'app verifica gli aggiornamenti

    Quando l'app torna in primo piano e ogni 10 minuti mentre resta aperta, l'updater chiede a Capgo l'ultimo bundle del canale.

    In primo piano

  2. Scarica in background

    Il nuovo bundle viene scaricato mentre l'utente continua a usare la versione corrente. Con gli aggiornamenti delta, vengono scaricati solo i file modificati.

    Nessuna interruzione

  3. Cambia al prossimo riavvio

    Quando l'utente chiude l'app, l'updater installa il bundle. Alla riapertura, viene eseguita la nuova versione.

    Prossimo primo piano

Vuoi che gli utenti vedano la nuova versione appena aprono l'app? Le modalità di aggiornamento diretto la applicano all'avvio, mentre è mostrata la splash screen.

Vedi aggiornamenti diretti

Docs comportamento aggiornamenti

Come funziona

Come i team di produzione rilasciano una fix con Capgo

Un rilascio tipico per un'app Capacitor già presente negli store. Ogni comando qui sotto proviene dalla documentazione di Capgo CLI.

  1. Configura l'updater una sola volta

    Esegui il setup wizard, poi assicurati che l'app chiami notifyAppReady() dopo l'avvio. Un bundle che non fa mai quella chiamata esegue il rollback da solo.

    npx @capgo/cli@latest init
    # in your app start-up code
    await CapacitorUpdater.notifyAppReady()
    Docs di notifyAppReady()
  2. Carica la fix su una parte della produzione

    Usa --delta in modo che i dispositivi scarichino solo i file modificati, e --rollout per iniziare con una piccola percentuale di dispositivi. Tutti gli altri restano sul bundle stabile.

    npx @capgo/cli@latest bundle upload --channel production --delta --rollout 5
    Docs sui rollout progressivi
  3. Lascia che Capgo fermi un rollout problematico

    Attiva l'auto-pause con una soglia sul tasso di errore (500 punti base equivalgono al 5%). Se gli errori superano la soglia, Capgo annulla il rollout. Controlla la nuova versione in Observe mentre è in corso.

    npx @capgo/cli@latest channel set production \
      --auto-pause-enabled \
      --auto-pause-failure-rate-bps 500 \
      --auto-pause-action rollback
    Documentazione di Observe
  4. Promuovi a tutti

    Quando i numeri sono buoni, promuovi il bundle a tutti i dispositivi del canale. Altrimenti, riporta il gruppo di rollout alla versione stabile.

    npx @capgo/cli@latest channel set production --rollout-promote
    # or, if something looks wrong
    npx @capgo/cli@latest channel set production --rollout-rollback
    Docs sui rollback

Pensato per i rilasci in produzione

I controlli che i team di produzione usano per rilasciare spesso senza sorprendere gli utenti.

Aggiornamenti delta

Carica con --delta e i dispositivi scaricano solo i file modificati rispetto al bundle attuale. Gli asset pesanti che cambiano raramente vengono scaricati una sola volta.

  • Download più leggeri per utenti con reti lente o a consumo
  • In modalità predefinita, gli update si applicano tra una sessione e l'altra, non durante l'uso
Documentazione delta updates

--delta

Vengono scaricati solo i file modificati

Rollout progressivo con auto-pausa

Invia un nuovo bundle a una quota casuale e persistente di un canale, mentre tutti gli altri restano sul bundle stabile. Aumenta la percentuale, promuovilo o fai il rollback da CLI o dalla console.

  • L'auto-pause può sospendere o ripristinare un rollout quando il tasso di errore supera la tua soglia
  • Observe confronta la nuova versione con la precedente prima di aumentare l'esposizione
Docs sui rollout progressivi

1–5%

Un tipico primo step di rollout

Rollback automatico

Ogni aggiornamento deve dimostrare di avviarsi. Se un nuovo bundle non chiama notifyAppReady() in tempo, il dispositivo torna all'ultimo bundle funzionante e segna il nuovo come fallito.

  • Il rollback scatta se notifyAppReady() non viene chiamato entro appReadyTimeout (10 secondi di default)
  • Riporta un intero channel a qualsiasi bundle precedente dalla sua cronologia
Docs di notifyAppReady()

10s

appReadyTimeout di default prima del rollback automatico

Distribuzione consapevole delle revisioni degli store

Capgo distribuisce lo strato web Capacitor: JavaScript, CSS e asset. Non modifica il binario nativo, i plugin, i permessi, gli entitlements o i metadati dell'app store. La revisione dello store è specifica per ogni app, quindi la conformità alle policy e l'approvazione restano di tua responsabilità.

  • Usa un rilascio nativo sullo store quando cambiano funzionalità native, plugin, permessi o metadati dell'app store
  • Fornisci ai revisori note chiare sulla funzionalità dell'app e sul percorso di aggiornamento del web-layer
  • Controlla le policy attuali di Apple e Google prima di ogni submission

Come lo usano i team di produzione

Gestione quotidiana dei rilasci con i live update attivi. Ogni card rimanda alla documentazione.

Bug fix critici

Se un checkout o una schermata di login si rompono, basta un fix a livello web. Caricalo e i dispositivi lo riceveranno al prossimo controllo degli update.

Docs comportamento aggiornamenti

Modifiche a testi e contenuti

Correggi il wording, aggiorna i testi di aiuto o sostituisci immagini e altri asset senza dover generare un nuovo Native Build.

Docs sulla compatibilità nativa

Stato delle release in Observe

Confronta un nuovo bundle con il precedente: tasso di errori, tempi di avvio e WebView e marker di deployment per versione.

Documentazione di Observe

Adozione più rapida con le notifiche di update

Dopo aver cambiato il bundle di un channel, invia una notifica di aggiornamento silenziosa così i dispositivi controllano subito, invece di aspettare il prossimo passaggio in foreground.

Invia notifica di aggiornamento

Proteggi le build native più vecchie

Blocca gli update major su un channel, così un bundle che richiede nuovi code nativi non raggiungerà mai un binario più vecchio.

Documentazione sul version targeting

Rollback dalla cronologia del canale

Seleziona qualsiasi bundle precedente nella scheda History del canale per renderlo di nuovo attivo su tutti i dispositivi di quel canale.

Docs sui rollback

Infrastruttura che già serve app in produzione

Capgo fornisce live update alle app in produzione dal 2021.

Aggiornamenti al mese
1 mld+
Dispositivi raggiunti
90M+
App che usano Capgo
4,7K+
Latenza tipica di API
~50ms

App buildate con Capacitor

Le app ad alto traffico richiedono modifiche UI affidabili in produzione

Le app meteo, sanità pubblica e telecom si affidano a interfacce, avvisi e navigazione accurati. Gli aggiornamenti in produzione aiutano a rilasciare correzioni approvate all'interfaccia monitorando l'adozione prima di espandere ulteriormente.

Icona dell'app Windy.com - Previsioni meteo METEO

Windy.com - Previsioni Meteo

App meteo in cui mappe, avvisi e correzioni di navigazione richiedono un'attenta distribuzione in produzione.

Installazioni Google Play
32,9M
Valutazione store
4.7
Icona dell'app Conecte SUS MEDICINA

Connetti SUS

App di sanità pubblica che richiede aggiornamenti rapidi e affidabili per linee guida e servizi.

Installazioni Google Play
27,7M
Valutazione store
4.6
Icona dell'app Mi Orange STRUMENTI

Il mio Orange

App dell'account Telecom in cui avvisi e schermate dell'account cambiano spesso.

Installazioni Google Play
9,3M
Valutazione store
4.2

Cosa dicono i clienti

Cosa dicono i team che rilasciano con Capgo

5.0/5 valutato dai team di sviluppatori 9,400+ team Leggi le recensioni
Ritratto di Sergiu S

Sergiu S

Lead Developer, drivolino GmbH

“Il plugin Capgo Capacitor Updater ha rivoluzionato il nostro modo di rilasciare gli aggiornamenti. Quello che prima richiedeva giorni, ora si fa in pochi minuti.”

Kapil

Fondatore, NuTriQ

“Poter rilasciare aggiornamenti OTA in produzione all'istante, senza attendere i cicli completi di revisione dell'App Store, è stato un enorme vantaggio operativo.”

Ritratto di Michael Haberler

Michael Haberler

nethead emeritors

“Ottimo lavoro sul plugin updater. Per me funziona alla perfezione e i live update sono un super acceleratore per velocizzare i test.”

FAQ

Domande dei team di produzione

Come arrivano gli aggiornamenti ai dispositivi e cosa fare se qualcosa va storto.

Quando gli utenti ricevono un live update?

Di default, l'app verifica gli aggiornamenti quando torna in primo piano e ogni 10 minuti mentre resta aperta. Scarica il nuovo bundle in background, lo installa quando l'utente esce dall'app e lo esegue alla prossima apertura. L'impostazione autoUpdate modifica questo comportamento.

Docs comportamento aggiornamenti

Can devices pick up an urgent fix faster?

Sì. Dopo aver modificato il bundle di un canale, invia una notifica di aggiornamento dalla console o aggiungi --send-update-notification a bundle upload. I dispositivi ricevono una push silenziosa e verificano subito. Serve Capgo Notifications con le credenziali push per iOS e Android. La consegna è best effort: un'app offline o chiusa forzatamente verifica al prossimo avvio.

Invia notifica di aggiornamento

Cosa succede se un aggiornamento rompe l'app?

Se un nuovo bundle non chiama notifyAppReady() entro 10 secondi (il valore predefinito di appReadyTimeout), il dispositivo torna all'ultimo bundle funzionante e segna il nuovo come fallito. Per bug che non impediscono l'avvio dell'app, fai rollback del rollout progressivo o scegli un bundle precedente dalla cronologia del canale.

Docs sui rollback

Come possiamo rilasciare prima a pochi utenti?

Carica con --rollout per inviare il bundle a una quota casuale e persistente del canale, mentre tutti gli altri restano su stable. Aumenta la percentuale, promuovi o fai il rollback da CLI o dalla console. L'auto-pause può fermare l'esposizione quando il tasso di errore supera una soglia.

Docs sui rollout progressivi

Cosa non può cambiare un live update?

I Live Update sostituiscono il web layer: JavaScript, HTML, CSS e asset. Plugin nativi, upgrade di Capacitor, modifiche a capacitor.config e i file di progetto iOS o Android richiedono un rilascio sugli store. Capgo controlla la compatibilità nativa dei bundle durante l'upload, e i canali possono bloccare gli update sui binari più vecchi.

Docs sulla compatibilità nativa

Rilascia il tuo prossimo fix come live update

Prova il flusso completo sulla tua app durante il periodo di prova: carica un bundle, distribuiscilo su pochi dispositivi e fai il rollback.