Capire l'aggiornamento in tempo reale in Capgo

Gli aggiornamenti in tempo reale sono una delle funzionalità più potenti negli app Capacitor, consentendo aggiornamenti in tempo reale senza la necessità di sottoporre l'app alla store. Lasciamo che ci addentriamo nel funzionamento di Capgo di questa funzionalità.

Concetti Fondamentali

Un'app Capacitor consiste in due layer principali:

1. Layer Web: Contiene file HTML, CSS e JavaScript caricati nel WebView
2. Layer Nativo: Contiene code specifiche della piattaforma (Java/Kotlin per Android, Swift per iOS)

Capgo's sistema di aggiornamento in tempo reale funziona sostituendo il layer web in esecuzione, poiché questi file non sono compilati nel binario dell'app.

Implementazione Tecnica

Percorsi del Server in Capacitor

Capgo gestisce due percorsi critici:

• Percorso Server Attuale: Si riferisce a file attualmente caricati in WebView
• Percorso Server Successivo: Si riferisce a file che caricheranno alla prossima riavvio dell'app

Esecuzione su Android

Sul sistema operativo Android, Capgo gestisce percorsi attraverso:

// Store next server path
private void setNextCapacitorServerPath(String path) {
    SharedPreferences prefs = context.getSharedPreferences("CapWebViewSettings", Activity.MODE_PRIVATE);
    SharedPreferences.Editor editor = prefs.edit();
    editor.putString("serverBasePath", path);
    editor.apply();
}

// Update current path and reload
private void setCurrentCapacitorServerPath(String path) {
    bridge.setServerBasePath(path);
    bridge.reload();
}

Esecuzione su iOS

Sui dispositivi iOS, i percorsi sono gestiti attraverso:

// Store next server path
private func setNextCapacitorServerPath(path: String) {
    KeyValueStore.standard["serverBasePath"] = path
}

// Update current path
private func setCurrentCapacitorServerPath(path: String) {
    bridge.viewController.setServerBasePath(path: path)
}

Misure di Sicurezza

Capgo implementa misure di sicurezza di grado militare attraverso l'encryption end-to-end, garantendo che gli aggiornamenti dell'app rimangano completamente sicuri dallo sviluppo alla distribuzione. Il nostro sistema di encryption va oltre la firma tradizionale code per fornire una vera sicurezza zero-knowledge.

Architettura di Crittografia End-to-End

1. Crittografia End-to-End (E2EE): Ogni bundle di aggiornamento viene crittografato utilizzando l'algoritmo AES-256-GCM prima di lasciare il tuo ambiente di sviluppo. Questa crittografia di livello militare assicura che gli aggiornamenti del tuo'applicazione rimangano completamente privati e sicuri per tutto il processo di consegna.

2. Architettura di Zero-Knowledge: Unlike other OTA update solutions that only sign updates, Capgo employs true zero-knowledge encryption. This means:

   • I contenuti degli aggiornamenti sono crittografati prima dell'upload
   • Capgo servers only store encrypted data
   • La decrittografia avviene solo sulle dispositivi degli utenti finali
   • Nessun intermediario può accedere ai contenuti degli aggiornamenti

3. Gestione delle Chiavi Sicure:

   • Le chiavi di crittografia vengono generate e archiviate in modo sicuro nel tuo ambiente CI/CD
   • Private keys never touch Capgo’s servers
   • Ogni versione dell'applicazione può utilizzare chiavi di crittografia uniche
   • Supporto per la rotazione delle chiavi per una maggiore sicurezza

Scopri di più sul nostro sistema di crittografia nella nostra guida dettagliata: Crittografia End-to-End in Capgo Aggiornamenti in tempo reale

Procedura di Aggiornamento della Sicurezza

1. Crittografia Pre-Upload:

   • Gli aggiornamenti sono crittografati nella tua pipeline CI/CD
   • Ogni file è crittografato individualmente
   • La metadata è anche crittografata per una completa privacy

2. Archiviazione Sicura:

   • I pacchetti crittografati sono archiviati sul CDN globale di Capgo
   • Nessun dato in testo puro tocca mai i nostri server
   • Anche nel caso di violazione del server, i dati rimangono sicuri

3. Consegna Sicura:

   • Le aggiornamenti vengono consegnati attraverso canali crittografati
   • Ogni istanza dell'applicaazione verifica l'integrità della crittografia
   • I meccanismi di riprova automatici per la decrittografia fallita

4. Sicurezza Client-Side:

   • Le aggiornamenti vengono verificati prima dell'installazione
   • La decrittografia fallita attiva il rollback automatico
   • Il storage delle chiavi sicure all'interno dello storage protetto dell'app

Questa approccio di sicurezza complessivo garantisce che gli aggiornamenti delle tue app rimangano protetti contro:

• Attacchi man-in-the-middle
• Violazioni del server
• Modifiche non autorizzate
• Attacchi di replay
• Manipolazione del contenuto

Ciclo di aggiornamento

Capgo’s processo di aggiornamento è progettato per essere automatico di default. Ecco come funziona il processo automatico:

1. Controllo automatico dell'aggiornamento

Il plugin controlla automaticamente gli aggiornamenti nelle seguenti situazioni:

• Quando l'applicazione si avvia

Questo comportamento è controllato dalla autoUpdate impostazione:

// capacitor.config.json
{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": true // Enable automatic updates
    }
  }
}

Potete anche controllare manualmente con getLatest()

2. Download automatico

When un nuovo versione viene rilevata, se autoUpdate è abilitato:

1. La download inizia automaticamente
2. La progressione viene tracciata internamente
3. I download falliti si riprovano automaticamente all'apertura dell'app
4. I download riusciti vengono memorizzati nella memoria dell'app

Potete monitorare questo processo attraverso gli eventi:

CapacitorUpdater.addListener('download', (info: DownloadEvent) => {
  console.log('Auto-download progress:', info.percent);
});

CapacitorUpdater.addListener('downloadComplete', (info: DownloadCompleteEvent) => {
  console.log('Auto-download complete:', info.bundle);
});

3. Installazione automatica

La tempistica dell'installazione dipende dalla vostra configurazione:

// capacitor.config.json
{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": true,
      "directUpdate": false // install update on app backgrounding
      "resetWhenUpdate": true, // reset live updates on native update (true by default)
      "autoDeleteFailed": true, // Auto cleanup failed updates (true by default)
      "autoDeletePrevious": true // Auto cleanup old versions (true by default)
    }
  }
}

L'installazione avviene:

• Subito se directUpdate è vero
• Se l'app è in background il prossimo directUpdate è falso
• Se l'installazione fallisce il plugin esegue un rollback automatico:

Il plugin gestisce anche la memoria:

• Rimuove gli aggiornamenti falliti se autoDeleteFailed è vero
• Pulisci le vecchie versioni se autoDeletePrevious è vero

Sospensione degli Aggiornamenti

Puoi controllare quando gli aggiornamenti vengono installati utilizzando le condizioni di sospensione:

// Delay until app goes to background
await CapacitorUpdater.setDelay({
  kind: 'background'
});

// Delay until specific date
await CapacitorUpdater.setDelay({
  kind: 'date',
  value: '2024-03-20T10:00:00.000Z'
});

// Delay until next native version
await CapacitorUpdater.setDelay({
  kind: 'nativeVersion'
});

// Multiple conditions
await CapacitorUpdater.setMultiDelay({
  delayConditions: [
    {
      kind: 'background'
    },
    {
      kind: 'date',
      value: '2024-03-20T10:00:00.000Z'
    }
  ]
});

Condizioni di sospensione disponibili:

• background: Installare quando l'app va in background
• : Installa dopo data/ora specifica: Installa dopo l'aggiornamento nativo successivo
• : Installa dopo che l'app è stata uccisaQuesto è utile per:
• Programmare gli aggiornamenti durante le ore di bassa attivitàCoordinare gli aggiornamenti con l'attività dell'utente

Assicurare un'esperienza di aggiornamento liscia

• Prevenire interruzioni durante compiti critici
• __CAPGO_KEEP_0__
• __CAPGO_KEEP_0__
• __CAPGO_KEEP_0__

Stati di Aggiornamento

Durante il processo automatico, i pacchetti passano attraverso questi stati:

1. scaricamento: Scaricamento in corso
2. in attesa: Scaricamento completato, in attesa di installazione
3. riconosciuto: Aggiornamento installato e attivo
4. errore: Aggiornamento fallito (attiva l'auto-rollback)

Conformità del Negozio

Apple App Store

Aggiornamenti in tempo reale sono pienamente conformi alle politiche dell'App Store di Apple. Come stabilito nel Contratto di licenza del programma di sviluppatore di Apple:

“Il code interpretato può essere scaricato in un'applicazione, ma solo a condizione che tale code: (a) non cambi lo scopo principale dell'applicazione fornendo funzionalità o caratteristiche che sono in contrasto con lo scopo e l'annuncio pubblicizzato dell'applicazione come presentata sullo Store, (b) non crei un negozio o un negozio per altre code o applicazioni, e (c) non bypassi la firma, il sandbox o altre funzionalità di sicurezza del sistema operativo.”

Aggiornamenti Capgo modificano solo la layer web, rispettando tutti i confini di sicurezza della piattaforma.

Google Play Store ✅

Gli Aggiornamenti in tempo reale sono conformi alle politiche di Google Play. La politica di abuso di dispositivi e rete specifica stabilisce:

“Questa restrizione non si applica ai code che eseguono in una macchina virtuale o un interprete dove uno dei due fornisce un accesso indiretto alle API di Android (ad esempio JavaScript in un webview o browser).”

Poiché Capgo aggiorna solo il contenuto di WebView, rientra in queste linee guida consentite.

Pratiche consigliate

1. Rollout fasi: Esegui gli aggiornamenti gradualmente
2. Controllo delle versioni: Traccia tutte le versioni distribuite
3. Supporto di Rollback: Ripristino rapido da problemi
4. Aggiornamenti Delta: Scarica solo i file modificati

Quando utilizzare gli Aggiornamenti in Tempo Reale

Adatto per:

• Correzioni di bug
• Miglioramenti dell'interfaccia utente
• Aggiornamenti del contenuto
• Impostazioni di toggle per le funzionalità

Non adatto per:

• Modifiche native code
• Aggiornamenti di versione principale
• Patch di sicurezza che richiedono modifiche native

Continua da Come funzionano le Aggiornamenti in tempo reale in Capgo

Se stai utilizzando Come funzionano le Aggiornamenti in tempo reale in Capgo per pianificare il lavoro sui plugin nativi, connettilo con Capgo Directory dei Plugin per il flusso di lavoro del prodotto in Capgo Directory dei Plugin, Capacitor Plugin da Capgo per i dettagli di implementazione in Capacitor Plugin da Capgo, Aggiunta o Aggiornamento dei Plugin per i dettagli di implementazione in Aggiunta o Aggiornamento dei Plugin, Alternativi per Plugin Enterprise di Ionic per il flusso di lavoro del prodotto in Alternativi per Plugin Enterprise di Ionic, e Capgo Costruzione Nativa per il flusso di lavoro del prodotto in Capgo Costruzione Nativa.