Salta al contenuto principale
Aggiornamenti diretti

Mostra l'ultima versione quando gli utenti aprono la tua app

Di default, un live update esegue una sessione dopo il download. Le modalità di aggiornamento diretto lo applicano all'avvio, dietro la splash screen, in modo che la prima schermata che gli utenti vedono sia già la nuova versione.

autoUpdate: atInstall, onLaunch, o sempre
Splash screen mantenuta finché l'update non è pronto
I download delta mantengono breve l'attesa

Il problema

Gli aggiornamenti in background arrivano una sessione dopo

Cosa succede in modalità predefinita

1

L'utente apre l'app

L'app si avvia con il bundle già presente. L'updater controlla se ce n'è uno nuovo e lo scarica in background.

2

La sessione esegue la versione corrente

Per il resto di quella sessione, l'utente utilizza il code installato prima della tua correzione.

3

L'update si applica al prossimo resume

Quando l'utente chiude l'app, l'updater installa il nuovo bundle. Lo vedrà la prossima volta che aprirà l'app.

Per la maggior parte dei rilasci, è il compromesso giusto. Quando la sessione che inizia dopo il tuo upload deve eseguire il nuovo code, usa la modalità di aggiornamento diretto.

Quando la prima sessione conta

Un flusso di pagamento o login rotto

Gli utenti che aprono l'app non dovrebbero passare di nuovo dallo schermo rotto prima che la correzione venga applicata.

Una patch di sicurezza lato web

Vuoi che il JavaScript patchato sia attivo fin dal lancio, non dalla sessione successiva.

Una modifica datata

Termini, avvisi o contenuti di eventi che devono essere attuali nella prima schermata che l'utente vede.

La soluzione

Cosa cambia con la modalità direct update

L'updater controlla al lancio mentre la splash screen resta visibile. Se è disponibile un nuovo bundle, lo scarica e lo applica prima che la splash screen scompaia.

Modalità predefinita (atBackground)

1
L'utente apre l'app
2
L'app mostra la versione attuale
3
L'update viene scaricato in background
4
L'update si applica al prossimo resume

Nessuna attesa all'avvio. Gli utenti vedono l'aggiornamento alla sessione successiva.

Modalità diretta (onLaunch)

1
L'utente apre l'app e la splash screen resta visibile
2
L'updater controlla e scarica i file modificati
3
L'aggiornamento viene applicato, la splash scompare e appare la nuova versione

Gli utenti vedono la nuova versione fin dalla prima schermata. Aspettano sulla splash screen durante il download.

Docs comportamento aggiornamenti

Come funziona

Come configurare gli aggiornamenti diretti

La modalità diretta è configurazione nativa, quindi arriva prima con un build pubblicato sugli store. Dopo, ogni live update la segue. I comandi sono presi dalla documentazione di Capgo.

  1. Aggiungi il plugin splash screen e scegli una modalità

    Installa @capacitor/splash-screen, poi imposta autoUpdate, autoSplashscreen e launchAutoHide in capacitor.config.ts.

    npm install @capacitor/splash-screen
    npx cap sync
    
    // capacitor.config.ts
    plugins: {
      CapacitorUpdater: {
        autoUpdate: 'onLaunch', // or 'atInstall' / 'always'
        autoSplashscreen: true,
        keepUrlPathAfterReload: true,
      },
      SplashScreen: { launchAutoHide: false },
    }
    Gestione splash screen
  2. Includi la configurazione nel build dello store

    capacitor.config viene compilato nell'app nativa, quindi la nuova modalità raggiunge gli utenti con il tuo prossimo rilascio sullo store. Capgo Build può generarlo nel cloud.

    npx @capgo/cli@latest build request --platform ios
    npx @capgo/cli@latest build request --platform android
    Capgo Documentazione build
  3. Carica i bundle come delta

    Gli utenti aspettano il download all'avvio, quindi invia solo i file modificati. CLI rileva le modalità di applicazione istantanea e suggerisce un upload delta.

    npx @capgo/cli@latest bundle upload --channel production --delta
    Documentazione delta updates
  4. Mantieni attivo il rollback automatico

    Chiama notifyAppReady() una volta che la tua app è avviata. Se un nuovo bundle non riesce ad avviarsi, il dispositivo torna all'ultimo funzionante.

    import { CapacitorUpdater } from '@capgo/capacitor-updater'
    
    await CapacitorUpdater.notifyAppReady()
    Docs di notifyAppReady()

Scegli la modalità adatta alla tua app

Le direct updates sono un compromesso: una breve attesa all'avvio in cambio della nuova versione già alla prima schermata.

Tre modalità di applicazione istantanea

Imposta autoUpdate in capacitor.config.ts. Ogni modalità decide quando un update può essere applicato mentre l'utente attende.

  • atInstall: solo subito dopo una nuova installazione o un aggiornamento store dell'app nativa
  • onLaunch: quando l'app si avvia dopo essere stata terminata (cold start)
  • sempre: a ogni controllo in foreground, anche con l'app aperta
Impostazioni updater

3

Modalità di applicazione immediata in autoUpdate

Gestione splash screen

Le modalità dirette richiedono @capacitor/splash-screen con launchAutoHide impostato su false e autoSplashscreen su true. L'updater nasconde lo splash screen una volta applicato l'update o quando rileva che non serve alcun aggiornamento.

  • Nessuna chiamata manuale a SplashScreen.hide() necessaria
  • keepUrlPathAfterReload mantiene l'utente sulla stessa rotta dopo il reload
  • Ascolta appReady se devi eseguire operazioni extra dopo la chiusura dello splash
Gestione splash screen

autoSplashscreen

Obbligatorio per ogni modalità diretta

Trade-off da pianificare

Gli utenti aspettano il download all'avvio e, con un aggiornamento sempre disponibile, possono ricaricare l'app mentre è in uso. Prevedi entrambi gli scenari.

  • Upload con --delta: scarica solo i file modificati
  • Salva e ripristina lo stato dell'app in modo che un reload non perda i progressi dell'utente
  • Mantieni la modalità predefinita quando una sessione di ritardo va bene
Documentazione delta updates

--delta

Consigliato per ogni upload di direct update

Quando usare le direct updates

Usa la modalità direct quando la sessione corrente deve eseguire il nuovo code. Mantieni la predefinita per tutto il resto.

Bug fix critici

Bug di pagamento, login o dati in cui far girare il vecchio code per un'altra sessione è troppo.

Onboarding al primo avvio

atInstall applica l'ultimo bundle subito dopo una nuova installazione o un aggiornamento dallo store, così i nuovi utenti partono con il tuo onboarding attuale.

Contenuti con date

Pagine di eventi, avvisi o termini che devono essere aggiornati quando gli utenti aprono l'app.

Patch di sicurezza

Fix di sicurezza del web-layer da eseguire al lancio. Le correzioni nel native code richiedono comunque un rilascio sullo store.

Rilasci di routine

Ritocchi di stile e funzionalità minori raramente giustificano un'attesa all'avvio. La modalità predefinita le applica alla sessione successiva.

App che restano aperte per ore

Con always, i controlli periodici (ogni 10 minuti di default) possono applicare un aggiornamento mentre l'app è aperta. Salva lo stato prima di fare affidamento su questo.

Mantenere breve l'attesa all'avvio

L'attesa all'avvio è data dal controllo aggiornamenti più il download. Gli aggiornamenti delta limitano il download ai soli file modificati.

~50ms

Latenza tipica di API

Delta

Vengono scaricati solo i file modificati

1 mld+

Update consegnati al mese

App buildate con Capacitor

Le app di informazione pubblica richiedono fix urgenti

Le app per emergenze, sanità e servizi civici non possono aspettare giorni per correggere una checklist non funzionante, un link a una risorsa o un avviso specifico per località. I direct updates permettono al web layer di aggiornarsi non appena il fix è approvato.

Icona app FEMA METEO

FEMA

Indicazioni di emergenza in cui piccoli errori nei contenuti possono diventare urgenti.

Installazioni Google Play
1,6M
Valutazione store
4.0
Icona dell'app Conecte SUS MEDICINA

Connetti SUS

Cartelle cliniche e app di guida che richiedono una distribuzione rapida delle modifiche al codice approvate.

Installazioni Google Play
27,7M
Valutazione store
4.6
Icona dell'app e-Título SOCIAL

e-Título

Workflow di identità civica in cui indicazioni sicure per versione contano su ogni device.

Installazioni Google Play
54,9M
Valutazione store
4.8

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

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 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.”

Ritratto di Luis Dominguez

Luis Dominguez

Chi paga, Anirol

“Da quando uso Capgo tutto è più veloce, e posso dare ai miei utenti il tempo che meritano senza trascurare la mia vita quotidiana.”

FAQ

Domande sulle direct updates

Quando usarle, come configurarle e quanto costano al lancio.

Dobbiamo usare le direct updates o la modalità background predefinita?

Usa la modalità predefinita per la maggior parte dei rilasci: non c'è attesa al lancio e gli utenti ricevono l'aggiornamento alla sessione successiva. Usa una modalità direct quando la sessione che parte dopo il tuo upload deve eseguire il nuovo code, ad esempio un checkout rotto o un fix di sicurezza del web layer.

Docs comportamento aggiornamenti

Qual è la differenza tra atInstall, onLaunch e always?

atInstall applica subito un aggiornamento solo dopo un'installazione da zero o un aggiornamento dell'app nativa dallo store, poi si comporta come la modalità predefinita. onLaunch applica subito quando l'app parte dopo essere stata terminata. always controlla a ogni ritorno in primo piano e applica non appena il download termina, anche mentre l'utente è nell'app.

Impostazioni updater

Perché serve il plugin splash screen?

Le modalità direct applicano l'aggiornamento mentre l'utente aspetta. Senza @capacitor/splash-screen, autoSplashscreen: true e launchAutoHide: false, gli utenti possono vedere un flicker o la vecchia UI prima del reload. Con queste impostazioni, lo splash resta visibile finché l'aggiornamento non viene applicato o l'updater rileva che non ce n'è bisogno.

Gestione splash screen

Possiamo attivare le direct updates con un live update?

No. autoUpdate si trova in capacitor.config, che viene letto nell'app nativa al momento del build. Includi la nuova impostazione in una release sullo store. Da quel momento, ogni live update segue la nuova modalità.

Docs sulla compatibilità nativa

Il nostro config usa directUpdate. È ancora supportato?

directUpdate è deprecato ma viene ancora rilevato. I suoi valori corrispondono alle modalità autoUpdate atInstall, onLaunch e always. Sposta l'impostazione su autoUpdate nella tua prossima release nativa.

Impostazioni updater

Metti la tua prossima fix sulla prima schermata

Prova una modalità di direct update su una build di test durante il trial e misura l'attesa all'avvio sulla tua app.

Prova gratuita di 14 giorni. Nessuna carta di credito richiesta.