Funzionalità

Questa pagina offre una panoramica completa di tutte le funzionalità disponibili in Capgo Live Updates. Ogni feature include una breve descrizione e link alla documentazione dettagliata.

Sistema di Update Core

Aggiornamenti Over-the-Air (OTA)

Distribuisci aggiornamenti JavaScript, HTML, CSS e asset direttamente agli utenti senza approvazione dagli store. Gli aggiornamenti vengono scaricati in background e applicati al prossimo riavvio dell'app.

Funzionalità principali:

• Download in background
• Installazione automatica
• Nessuna interruzione per l'utente
• Supporto cross-platform (iOS, Android, Electron)

Scopri di più sul comportamento degli update →

---

Delta Updates (Aggiornamenti Differenziali)

Scarica solo i file modificati tra una versione e l'altra, riducendo il consumo di banda fino al 95% e velocizzando la distribuzione degli update.

Funzionalità principali:

• Diffing automatico a livello di file
• Verifica basata su checksum
• Confronto file delta
• Fallback intelligente agli update completi

Scopri di più sugli update delta →

---

Rollback automatico

Se un update non viene caricato o causa crash, il sistema torna automaticamente all'ultima versione funzionante.

Funzionalità principali:

• Rilevamento crash
• Rilevamento timeout
• Ripristino automatico
• Nessun intervento dell'utente richiesto

Scopri di più sui rollback →

---

Validazione checksum & fallback

Verifica l'integrità del bundle tramite checksum e torna automaticamente all'ultima versione funzionante se viene rilevata una corruzione.

Funzionalità principali:

• Validazione checksum al download
• Rilevamento delle corruzioni
• Fallback automatico all'ultimo bundle funzionante
• Strumenti di ripristino manuale disponibili

---

Rilevamento degli update breaking

Impedisce l'applicazione di aggiornamenti incompatibili su dispositivi con versioni code native precedenti.

Funzionalità principali:

• Controllo compatibilità versione nativa
• Validazione dipendenze plugin
• Blocco automatico aggiornamenti incompatibili
• Messaggi di errore chiari

Scopri di più sul targeting delle versioni →

---

Controllo del Deployment

Sistema di canali

Organizza e gestisci gli update su diversi ambienti e segmenti di utenti con configurazioni di canale flessibili.

Funzionalità principali:

• Canali personalizzati illimitati (production, staging, beta, ecc.)
• Assegnazione bundle per singolo canale
• Regole di targeting specifiche per canale
• Self-assignment del dispositivo
• Override del canale per dispositivo

Scopri di più sui canali →

---

Targeting dei dispositivi

Targetizza dispositivi, versioni o segmenti di utenti specifici per rollout graduali e deployment controllati.

Funzionalità principali:

• Targeting basato sulla versione
• Override specifici per dispositivo
• Filtro per piattaforma (iOS, Android, Electron)
• Filtro per metadati personalizzati
• Blocco build emulatori/dev

---

Politiche dei canali

Configura regole e restrizioni per la distribuzione degli update su ogni channel.

Funzionalità principali:

• Disabilita auto-update
• Blocca update di major version
• Disabilita update sugli emulatori
• Disabilita gli update nei build di sviluppo
• Policy specifiche per piattaforma (solo iOS, solo Android, solo Electron)

Scopri di più sulle policy dei channel →

---

Strumenti per sviluppatori

Anteprima Bundle

Anteprima i bundle in un ambiente web live prima di distribuirli sui dispositivi, tramite la dashboard web.

Percorso: Web Dashboard → App → Bundle → tab Preview

---

Live Debugging

Monitoraggio in tempo reale degli eventi di CLI per dispositivi specifici, con dettagli su check, download, install e errori.

Utilizzo:

npx @capgo/cli app debug [appId]

Mostra:

• Controlli aggiornamenti
• Progresso del download
• Stato dell'installazione
• Messaggi di errore
• Blocchi delle policy

---

Visualizzatore file Bundle Delta

Ispeziona i file delta di ogni bundle, inclusi l'elenco dei file, i checksum e i metadati.

Percorso: Web Dashboard → App → Bundle → tab Delta files

Mostra:

• Elenco file con checksum
• Metadati del bundle
• Compatibilità con la versione nativa
• Dipendenze dei plugin

---

Dipendenze dei plugin nativi

Visualizza tutti i plugin nativi Capacitor inclusi in ogni bundle per monitorare le modifiche alle dipendenze tra le versioni.

Percorso: Web Dashboard → App → Bundle → tab Dependencies

Mostra:

• Nomi e versioni dei plugin
• Aggiunta/rimozione di dipendenze
• Avvisi di compatibilità

---

Integrazione CLI

Interfaccia CLI completa per deployment automatizzati e integrazione CI/CD.

Comandi principali:

• bundle upload - Upload di nuovi bundle
• bundle list - Lista tutti i bundle
• bundle delete - Elimina bundle
• bundle cleanup - Pulizia dei bundle obsoleti
• channel set - Configurazione dei canali
• app debug - Debugging in tempo reale

Vedi la documentazione completa di CLI →

---

Crittografia dei bundle

Crittografia end-to-end dei bundle tramite AES-256, per proteggere i tuoi code sia in transito che a riposo.

Funzionalità principali:

• Generazione della coppia di chiavi RSA
• Crittografia bundle AES-256
• Verifica della firma Code
• Gestione delle chiavi di crittografia

Scopri di più sulla crittografia →

---

Pulizia e retention dei bundle

Pulisci automaticamente i vecchi bundle in base alle politiche di retention per gestire lo storage.

Funzionalità principali:

• Conteggio retention configurabile
• Pulizia automatica tramite CLI
• Job di pulizia pianificati
• Monitoraggio dello storage

Utilizzo:

npx @capgo/cli bundle cleanup --keep=10

---

Analytics & Monitoring

Statistiche degli Update

Monitora i tassi di adozione, il successo e l'avanzamento dei deployment tra i tuoi utenti.

Metriche disponibili:

• Tasso di successo del download
• Tasso di successo dell'installazione
• Tasso di errore per tipologia
• Adozione degli update nel tempo
• Distribuzione delle versioni

Percorso: Web Dashboard → App → Statistiche

---

Log dei dispositivi

Log degli eventi per singolo dispositivo che mostrano l'intero ciclo di vita dell'update, dal controllo all'installazione.

Tipi di eventi:

• Controlli aggiornamenti
• Download: inizio/completato/fallito
• Installazione: inizio/completata/fallita
• Eventi di rollback
• Blocchi delle policy

Percorso:

• Web Dashboard → App → Dispositivo → Log
• Web Dashboard → App → Logs (tutti i dispositivi)

Scopri di più sui log →

---

Analytics sull'uso dei bundle

Analytics dettagliate su quali bundle sono attivi, conteggio download e utilizzo dello storage.

Metriche:

• Installazioni attive per bundle
• Conteggio download
• Utilizzo dello storage per bundle
• Utilizzo della banda

---

Statistiche del Channel

Monitora le metriche di performance e adozione per canale.

Metriche:

• Dispositivi per canale
• Tassi di successo degli update per canale
• Cronologia deployment
• Tassi di errore per canale

Percorso: Dashboard web → App → Canale → Statistiche

---

Cronologia deployment

Registro completo di tutti i deployment dei bundle, assegnazioni dei canali e modifiche alla configurazione.

Eventi tracciati:

• Upload dei bundle
• Assegnazione dei channel
• Modifiche alle policy
• Override dei dispositivi

Percorso: Dashboard Web → App → Channel → Cronologia

---

Security & Compliance

Crittografia end-to-end

Crittografia dei bundle a riposo e in transito con standard AES-256.

Scopri di più sulla crittografia →

---

Firma Code

Verifica l'integrità del bundle con firme crittografiche per prevenire manomissioni.

---

Conformità SOC 2 Type II

Infrastruttura e processi certificati secondo gli standard SOC 2 Type II per la sicurezza enterprise.

---

Conformità App Store

Pienamente conforme alle policy di Apple App Store e Google Play Store per gli aggiornamenti OTA.

Scopri di più sulla conformità →

---

Obbligo 2FA (livello Organization)

Richiedi l'autenticazione a due fattori per tutti i membri dell'organizzazione per accedere alla dashboard e API.

Percorso: Web Dashboard → Organizzazione → Sicurezza

Scopri di più sul 2FA →

---

Obbligo bundle crittografati

Richiedi che tutti i bundle siano crittografati a livello di organizzazione.

Percorso: Web Dashboard → Organizzazione → Sicurezza

---

Collaborazione nel team

Controllo accessi basato su ruoli (RBAC)

Permessi granulari per il controllo degli accessi a livello di organizzazione e app.

Ruoli dell'organizzazione:

• org_super_admin - Controllo completo dell'organizzazione
• org_admin - Amministrazione dell'organizzazione (senza fatturazione/eliminazione)
• org_billing_admin - Accesso solo alla fatturazione
• org_member - Accesso in sola lettura all'organizzazione

Ruoli dell'app:

• app_admin - Controllo completo di un'app
• app_developer - Upload bundle, gestione dispositivi
• app_uploader - Solo upload bundle
• app_reader - Accesso in sola lettura

Percorso:

• Dashboard Web → Organizzazione → Membri
• Dashboard Web → App → Accesso

Scopri di più su RBAC →

---

Log di audit

Tracciamento completo di tutte le attività dell'organizzazione e dell'app per compliance e sicurezza.

Eventi registrati:

• Azioni utente (login, logout, modifiche permessi)
• Operazioni sui bundle (upload, delete, assign)
• Operazioni sui channel (create, update, delete)
• Modifiche all'organizzazione (settings, members)

Percorso: Web Dashboard → Organizzazione → Audit Logs

---

Webhook

Ricevi notifiche in tempo reale sugli eventi delle tue app tramite HTTP webhook.

Eventi supportati:

• apps - App creata/aggiornata/eliminata
• app_versions - Bundle caricato/eliminato
• channels - Channel creato/aggiornato/eliminato
• org_users - Membro aggiunto/rimosso
• orgs - Organization aggiornata

Funzionalità:

• URL webhook personalizzati
• Filtraggio degli eventi
• Log di consegna
• Meccanismo di retry
• Funzionalità di test

Percorso: Dashboard Web → Organizzazione → Webhook

---

Collaborazione multi-utente

Invita i membri del team nella tua organization con ruoli e permessi specifici.

Funzionalità:

• Inviti via email
• Assegnazione dei ruoli
• Gestione dei membri
• Revoca degli accessi

Percorso: Web Dashboard → Organizzazione → Membri

---

Gestione chiavi API

Crea, gestisci e revoca le chiavi API con scadenze opzionali e storage hashato.

Funzionalità principali:

• Chiavi per singola app o organizzazione
• Scadenze opzionali
• Storage hashato (irreversibile)
• Supporto per la rotazione delle chiavi

Percorso: Web Dashboard → Chiavi API

Scopri di più sulle chiavi API →

---

Policy delle password

Requisiti password a livello di organizzazione per garantire standard di sicurezza.

Policy configurabili:

• Lunghezza minima
• Richiedi maiuscole
• Richiedi numeri
• Richiedi caratteri speciali

Percorso: Dashboard Web → Organizzazione → Sicurezza

---

Piattaforme supportate

Supporto multipiattaforma

Supporto per app iOS, Android ed Electron con un unico SDK.

Piattaforme supportate:

• iOS (Capacitor 5, 6, 7, 8)
• Android (Capacitor 5, 6, 7, 8)
• Electron (NOVITÀ 2025)

---

Supporto a lungo termine

Supporto continuo per le versioni precedenti di Capacitor per garantire la compatibilità con le app legacy.

Attualmente supportate:

• Capacitor 8 (ultima versione)
• Capacitor 7
• Capacitor 6
• Capacitor 5

---

Backend di storage personalizzati

Usa la tua infrastruttura di storage (S3, R2, ecc.) invece dello storage predefinito di Capgo.

Scopri di più sullo storage custom →

---

Configurazione per la Cina

Configurazione speciale per le app distribuite nella Cina continentale per rispettare le normative locali.

Scopri di più sulla configurazione Cina →

---

Funzionalità avanzate

Comportamento di aggiornamento personalizzato

Configura quando e come vengono controllati e applicati gli update tramite SDK.

Opzioni configurabili:

• Intervallo di controllo (periodCheckDelay - minimo 600 secondi)
• Policy di auto-update (autoUpdate - off, atBackground, atInstall, onLaunch, always, onlyDownload)
• Requisiti di rete (solo Android - tramite WorkManager)

Scopri di più sul comportamento degli update →

---

Tipi di aggiornamento

Diversi tipi di update per vari casi d'uso, dagli aggiornamenti istantanei a quelli gestiti dall'utente.

Tipi disponibili:

• Aggiornamenti in background (predefinito)
• Aggiornamenti immediati
• Aggiornamenti su richiesta dell'utente
• Aggiornamenti condizionali

Scopri di più sui tipi di update →

---

Sistema a crediti

Fatturazione a consumo con crediti per banda, storage e altre risorse.

Funzionalità:

• Monitoraggio dell'utilizzo dei crediti
• Alert di consumo
• Ricarica tramite Stripe
• Registro dei crediti

Percorso: Dashboard web → Organizzazione → Crediti

---

Per iniziare

Pronto a usare queste feature? Segui la nostra Guida Quickstart per configurare la tua prima app con Capgo Live Updates.

Serve aiuto?

• Unisciti al nostro Discord per il supporto della community
• Consulta le FAQ per le domande più comuni
• Sfoglia la documentazione API per l'integrazione con API
• Contatta il supporto per assistenza enterprise

Continua dalle funzionalità

Se stai usando Funzionalità per pianificare monitoraggio e analytics, collegalo a Statistiche per i dettagli di implementazione in Statistics, Log per i dettagli di implementazione in Logs, @capgo/capacitor-appinsights per i dettagli di implementazione in @capgo/capacitor-appinsights, Utilizzo di @capgo/capacitor-appinsights per la funzionalità nativa in Using @capgo/capacitor-appinsights, e @capgo/capacitor-firebase-analytics per il dettaglio di implementazione in @capgo/capacitor-firebase-analytics.