Capgo ti permette di aggiornare le tue Capacitor app istantaneamente, senza attendere l'approvazione degli store. Offre aggiornamenti over-the-air (OTA) veloci, sicuri e conformi. Ecco tutto quello che devi sapere:
- Aggiornamenti rapidi: Il 95% degli utenti riceve gli aggiornamenti entro 24 ore, con bundle da 5MB consegnati in 114ms.
- Setup rapido: Installa il plugin con
npm install @capgo/capacitor-updater, sincronizza il progetto e configura gli update in pochi minuti. - Sicuro e conforme: Crittografia end-to-end e piena conformità alle linee guida Apple e Google.
- Rollout flessibili: Assegna gli update a gruppi specifici (es. beta, produzione) per rilasci controllati.
- Gestione errori: Monitoraggio in tempo reale, opzioni di rollback e update parziali per garantire la stabilità.
Capgo è progettato per un deployment leggero e fluido, così puoi concentrarti sul migliorare la tua app mentre gli update avvengono in background.
Guida rapida a Capgo

Configura Capgo nei tuoi progetti progetto Capacitor è semplicissimo. Richiede solo una rapida installazione e una configurazione di base.
Requisiti di sistema
Prima di iniziare, assicurati che il tuo ambiente di sviluppo soddisfi questi requisiti minimi:
| Componente | Requisito minimo |
|---|---|
| Node.js | Ultima versione LTS |
| Capacitor | Versione 3.0 o superiore |
| Strumenti della piattaforma | Xcode (per iOS) o Android Studio |
Dovrai anche avere installati gli strumenti necessari per lo sviluppo con Capacitor, come Xcode per iOS o Android Studio per Android.
Passaggi per l'installazione del plugin
Ecco come installare e configurare Capgo:
-
Passaggio 1: Installa il plugin Capgo
Esegui il seguente comando per installare il plugin updater di Capgo:
npm install @capgo/capacitor-updater -
Passaggio 2: Sincronizza il progetto
Dopo aver installato il plugin, sincronizzalo con il tuo progetto Capacitor:
npx cap sync -
Passaggio 3: Configura Live Updates
Per abilitare i Live Updates, installa Capgo CLI e inizializzalo:
npm install @capgo/cli npx @capgo/cli init
Una volta completata la configurazione, puoi passare a configurare il tuo progetto per aggiornamenti senza complicazioni.
Configurazione base
Per configurare Capgo nel tuo progetto Capacitor, aggiorna il capacitor.config.ts file con le seguenti impostazioni:
{
plugins: {
CapacitorUpdater: {
autoUpdate: true,
updateUrl: 'https://api.capgo.app/updates'
}
}
}
Puoi personalizzare queste impostazioni in base alle esigenze del tuo progetto. Ecco una panoramica delle opzioni disponibili:
| Impostazioni | Scopo | Valore consigliato |
|---|---|---|
| autoUpdate | Abilita gli update automatici | true |
| updateUrl | L'oggetto endpoint per gli update | https://api.capgo.app/updates |
Con queste configurazioni, il tuo progetto è pronto a gestire gli update in modo efficiente.
Gestire gli OTA Update
Configurare l'automazione degli update
Usare Capgo per automatizzare gli update semplifica il deployment. Inizia autenticando l'accesso a CLI con questo comando:
npx @capgo/cli@latest init API_KEY
Successivamente, crea un bundle di aggiornamento dal tuo code attuale eseguendo:
npx @capgo/cli app update
Una volta configurato, Capgo controlla automaticamente gli aggiornamenti all'avvio dell'app, li installa in background e applica le modifiche al successivo riavvio.
| Tipo di update | Tempistiche | Impatto sull'utente |
|---|---|---|
| Controllo in background | Avvio dell'app | Nessuna interruzione |
| Trigger manuale | On-demand | Disruption minima |
| Notifica Push | Basato su eventi | User-controlled |
Dopo aver automatizzato gli aggiornamenti, puoi usare Capgo’s sistema di canali per personalizzare il rollout per diversi gruppi di utenti.
Controllo Distribuzione Update
Capgo ti permette di assegnare versioni specifiche a diversi canali, offrendo flessibilità nel deployment. Ecco un esempio di configurazione:
{
"channels": {
"beta": "v2.0.0-beta",
"production": "v1.9.5",
"enterprise": "v1.9.5-ent"
}
}
Questa configurazione garantisce deployment organizzati, come descritto di seguito:
| Canale | Scopo | Frequenza Update |
|---|---|---|
| Beta | Test precoce delle feature | Settimanale |
| Produzione | Release stabili | Bisettimanale |
| Enterprise | Clienti business | Mensile |
| Power User | Update di performance | Al bisogno |
Assegnando gli update a canali specifici, puoi testare nuove feature con piccoli gruppi prima del rollout a tutti gli utenti.
Gestione degli errori di aggiornamento
Una volta configurati e distribuiti gli aggiornamenti, le funzionalità di gestione degli errori di Capgo aiutano a mantenere la stabilità dell'app. Queste includono:
- Monitoraggio in tempo reale: Monitora il progresso degli update su tutti i dispositivi.
- Sicurezza robusta: Ensure updates are safe and tamper-proof.
- Rollback con un click: Torna rapidamente a una versione stabile se necessario.
- Aggiornamenti parziali: Invia solo i file modificati per ottimizzare le performance.
Per gestire gli errori in modo efficace, considera l'uso di questi strumenti:
| Funzionalità | Funzione | Implementazione |
|---|---|---|
| Retry automatici | Risolve problemi di rete | Funzionalità Capgo integrata |
| Controllo di versione | Traccia le sorgenti degli update | Integrazione Git |
| Registrazione errori | Monitora i problemi di update | Analytics della dashboard |
| Sistema di Rollback | Ripristina versioni stabili | Reversione con un solo comando |
L'uso del sistema a canali per i rollout graduali riduce i rischi e garantisce la stabilità della tua app, anche in caso di problemi con gli update.
Sicurezza e regole App Store
Sistema di crittografia degli update
Capgo protegge i propri pacchetti di update utilizzando crittografia end-to-end, dando priorità alle funzioni di sicurezza critiche per proteggere i dati. Ecco come funziona:
| Funzionalità di sicurezza | Implementazione | Vantaggio |
|---|---|---|
| Crittografia end-to-end | Metodi sicuri | Blocca accessi non autorizzati |
| Gestione delle chiavi | Storage hardware | Protegge le chiavi di cifratura |
| Controlli di accesso | Permessi basati sui ruoli | Limita l'accesso alla distribuzione degli update |
Queste misure, unite al rispetto delle linee guida di sicurezza delle piattaforme, hanno garantito un tasso di successo globale dell'82% su oltre 750 app in produzione [2].
Linee guida delle piattaforme
Capgo garantisce la piena conformità ai requisiti degli app store di iOS e Android, rispettando le loro regole specifiche per operazioni sicure e trasparenti.
Per Per le applicazioni iOS, gli sviluppatori devono:
- Offrire opzioni chiare per l'eliminazione dell'account in-app.
- Mantenere pratiche di raccolta dati trasparenti.
- Usa l'API REST di Apple per la revoca dei token quando implementi “Sign in with Apple”.
Sul lato Android, Google Play richiede:
- Cancella notifiche per gli aggiornamenti in sospeso.
- Crittografia end-to-end per tutti i pacchetti di aggiornamento.
- Dettagliato controllo versione per una maggiore trasparenza.
Seguendo queste linee guida, Capgo ha facilitato 23,5 milioni di aggiornamenti riusciti mantenendo la conformità [2]. Inoltre, la piattaforma monitora attivamente le performance degli aggiornamenti per un miglioramento continuo.
Sistema di tracciamento aggiornamenti
Per integrare la consegna sicura degli aggiornamenti, il sistema di tracciamento di Capgo offre monitoraggio in tempo reale per ottimizzare le performance e rilevare potenziali problemi. Ecco i dettagli:
| Componente di monitoraggio | Scopo | Metriche di Successo |
|---|---|---|
| Analytics in tempo reale | Monitora il tasso di successo degli update | Adozione al 95% entro 24 ore |
| Monitoraggio Performance | Ottimizza le velocità di download | Migliora i tempi di risposta |
| Rilevamento errori | Identifica i problemi velocemente | Monitora le velocità di download |
| Gestione delle versioni | Controlla la distribuzione degli update | Traccia i tassi di successo totali |
Questo robusto sistema di tracciamento garantisce update sicuri ed efficienti, confermando l'impegno di Capgo per una distribuzione degli update affidabile e senza interruzioni.
Consigli sulle performance degli update
Garantisci update fluidi e senza interruzioni concentrandoti sull'ottimizzazione delle performance.
Ridurre la dimensione degli update
Capgo utilizza gli update delta, il che significa che vengono inviate solo le modifiche tra le versioni. Per ridurre ulteriormente la dimensione degli update, considera queste strategie:
| Tecnica di ottimizzazione | Impatto | Implementazione |
|---|---|---|
| Minificazione Code | Riduce la dimensione di code | Comprime file JavaScript, CSS e HTML |
| Formato immagine WebP | Riduce il peso dei file immagine | Converti le immagini statiche in WebP |
| Grafica vettoriale | Dimensioni ridotte e scalabilità | Usa per icone e loghi invece delle immagini raster |
| Pulizia delle risorse | Elimina gli asset inutili | Rimuovi file e risorse non utilizzati |
Per risultati ottimali, concentrati su:
- Converti le immagini in WebP per ridurre il peso dei file.
- Sostituisci le immagini raster con grafica vettoriale ove possibile.
- Abilita tool per comprimere e minificare il tuo code.
- Pulisci regolarmente risorse e debug symbols inutilizzati.
Caricamento Update in background
Assicurati che gli aggiornamenti siano fluidi caricandoli in background. Ecco alcuni modi per migliorare l'efficienza:
- Usa API del Filesystem di Capacitor per caching e storage locale.
- Gestisci i file in modo più efficiente usando i blob invece delle stringhe base64.
- Implementa il lazy loading per ridurre i tempi di caricamento iniziali.
Questo approccio garantisce un'esperienza senza interruzioni mentre gli aggiornamenti vengono applicati in background.
Gestione dimensione update
Gestire la dimensione complessiva degli update è importante quanto la velocità di caricamento. Mantenere il pacchetto sotto controllo garantisce che l'app rimanga reattiva ed efficiente. Ecco come fare:
- Effettua audit regolari e rimuovi le risorse inutilizzate.
- Applica tecniche di app thinning su iOS per ridurre il bundle size.
- Ottimizza i database locali per gestire i dati in modo più efficiente.
- Comprimi le immagini per risparmiare spazio.
- Riutilizza le risorse dinamicamente tramite la personalizzazione a runtime.
Conclusione
Capgo si distingue come una soluzione affidabile per il deployment app Capacitor, supportata da un track record impressionante di oltre 1,7 trilioni di update su più di 2.000 app in produzione [1]. Questo livello di performance dimostra la capacità di gestire deployment su larga scala con estrema facilità.
La piattaforma semplifica il processo di deployment con funzionalità come:
- Crittografia end-to-end per la consegna sicura degli update
- Update differenziali per ridurre al minimo il consumo di banda
- Integrazione CI/CD fluida con le piattaforme più diffuse
- Conformità agli App store per iOS e Android
- Rollback con un click per un controllo rapido delle versioni
Capgo combina efficienza, sicurezza e conformità, rendendolo la scelta ideale per i team che cercano una soluzione di deployment leggera ed efficace. La sua piattaforma ricca di funzionalità affronta le sfide del deployment moderno rispettando i requisiti delle piattaforme.
Vuoi semplificare il deployment della tua app? Inizia subito a usare Capgo per ottimizzare gli aggiornamenti e migliorare le performance della tua app.
FAQ
::: faq
Come fa Capgo a rispettare le linee guida di Apple e Google offrendo aggiornamenti over-the-air?
Come Capgo garantisce la conformità alle linee guida dell'App Store
Capgo assicura la conformità a tutte le linee guida di Apple e Google seguendo rigorosamente le loro policy di aggiornamento. Per Apple, gli update sono limitati a contenuti non eseguibili, mentre Google offre maggiore flessibilità ma richiede misure di sicurezza stringenti. Capgo risponde a questi requisiti tramite crittografia end-to-end, ottenendo il consenso degli utenti per gli update e allineandosi alle regole specifiche di ogni piattaforma.
Per mantenere tutto in regola, Capgo effettua audit regolari dei propri sistemi di aggiornamento e monitora i cambiamenti nelle policy. Questi sforzi garantiscono che aggiornamenti over-the-air rimangono sicuri, fluidi e pienamente conformi, offrendo a sviluppatori e utenti massima fiducia nel processo. :::
::: faq
Quali sono i vantaggi del sistema di canali di Capgo per gestire gli aggiornamenti delle app e come migliora l'affidabilità?
Il sistema di canali di Capgo consente distribuzione mirata degli aggiornamenti, offrendo agli sviluppatori la flessibilità di rilasciare update a gruppi specifici di utenti. Questo approccio è ideale per rollout graduali, beta testing o esperimenti controllati. Partendo da gruppi ristretti, gli sviluppatori possono identificare e risolvere i bug precocemente, migliorando l'affidabilità dell'app.
Un altro vantaggio del sistema è il supporto per rollback rapidi, consentendo agli utenti di tornare a una versione stabile in caso di problemi. Insieme agli aggiornamenti in tempo reale, Capgo assicura che fix e nuove feature raggiungano gli utenti istantaneamente — saltando i tempi di approvazione degli app store — garantendo un'app fluida e utenti soddisfatti. :::
::: faq
Come possono gli sviluppatori migliorare le performance e ridurre la dimensione degli aggiornamenti usando Capgo con le loro app Capacitor?
Per rendere gli aggiornamenti più veloci e mantenere dimensioni contenute con Capgo, gli sviluppatori possono adottare alcune tecniche pratiche:
- Sfrutta gli aggiornamenti differenziali: Invece di inviare nuovamente l'intera app, invia solo le parti che sono cambiate. Questo approccio riduce drasticamente il update size.
- Usa una compressione efficace: Implementa metodi di compressione come ZSTD per ridurre ulteriormente i file di update.
- Struttura bene il tuo code: Dividi il tuo code in moduli più piccoli per velocizzare e ottimizzare il processo di update.
Oltre a queste pratiche, monitora le performance della tua app con strumenti come Firebase può evidenziare le aree di miglioramento. Questo assicura che gli update non siano solo più piccoli, ma migliorino anche l'esperienza utente. Insieme, questi passaggi permettono agli sviluppatori di fornire update fluidi e in tempo reale, mantenendo l'app affidabile ed efficiente. :::
Continua con Capgo Plugin: Deployment leggero per app Capacitor
Se stai usando Capgo Plugin: Deployment leggero per app Capacitor per pianificare sicurezza e compliance, collegalo a Crittografia per i dettagli di implementazione in Encryption, Conformità per i dettagli di implementazione in Compliance, Scanner di sicurezza Capgo per il workflow di Capgo Security Scanner, Sicurezza Capgo per il workflow di Capgo Security, e Trust Center di Capgo per il workflow di Capgo Trust Center.