Come mantenere gli aggiornamenti di Capgo sottili e veloci

La migliore aggiornamento in tempo reale è quello che i tuoi utenti notano appena.

Di solito ciò significa tre cose:

1. La download è piccola.
2. La distribuzione è controllata.
3. La ripresa è istantanea se qualcosa va storto.

The same “keep OTA lean” advice that works in React Native land also applies to Capgo. The difference is that Capgo gives Capacitor teams a few extra levers: Aggiornamenti delta, context: Pagina/Area: Pagina prodotti/prezzi aziendale. Ruolo: Etichetta breve UI o elemento di navigazione. Visto in: pagina enterprise.astro. Chiave messaggio `enterprise_delta_updates` (Aggiornamenti Delta Aziendale)., canali, rollback automaticotargeting versione , e opzionale.

Se li utilizzate insieme, si ottengono carichi più piccoli, installazioni più veloci e molto meno disordine operativo.

La leggerezza conta anche quando il MAU rimane lo stesso.

Un utile dettaglio specifico di Capgo: il MAU di Capgo è effettivamente il numero di dispositivi attivi mensili che hanno contattato il servizio di aggiornamento negli ultimi 30 giorni.

Ridurre un bundle non è principalmente un trucco per ridurre il conteggio del MAU. Importa perché migliora le parti che gli utenti e le squadre sentono effettivamente:

• Scarichi più veloci su cellulare o Wi-Fi debole
• Miglior esperienza con aggiornamenti diretti
• Minore spreco di banda su rilasci falliti o annullati
• Raggio di azione più piccolo quando si testa o si staga un rilascio

Aggiornamenti leggeri sono realmente sulla velocità, la sicurezza e la disciplina operativa.

1. Impostare le aggiornamenti Delta come default

Se fai solo una cosa, fai questo.

Capgo’s Aggiornamenti Delta inviano solo i file che sono stati modificati tra le versioni anziché scaricare nuovamente l'intero pacchetto web. È il più grande vantaggio singolo per le prestazioni OTA routine.

bun run build
bunx @capgo/cli@latest bundle upload --channel staging --delta

Quando la tua passata di QA è completata:

bunx @capgo/cli@latest bundle upload --channel production --delta

Se desideri che il CI rimanga rigoroso, utilizza --delta-only così che nessuno cade accidentalmente nuovamente alle upload di pacchetti completi:

bunx @capgo/cli@latest bundle upload --channel production --delta-only

Sfrutta --delta-only se il tuo parco di produzione supporta gli aggiornamenti Delta. In caso di plugin misti, i dispositivi più vecchi che non supportano la consegna basata sul manifesto degli aggiornamenti Delta non potranno scaricare quel pacchetto.

Questo conta ancora di più se utilizzi directUpdateperché il tempo tra “aggiornamento trovato” e “app riavviata” diventa visibile all'utente.

2. Tratta gli asset come asset, non come bagaglio JavaScript

Gli asset grandi sono dove i pacchetti OTA quietamente si gonfiano.

Regole pratiche:

• Non incolonnare immagini o media grandi all'interno di JavaScript quando un file di asset normale farà al caso.
• Tieni il contenuto che cambia frequentemente sul tuo CDN o API se non deve vivere all'interno del pacchetto di distribuzione dell'applicazione.
• Sii cauto con le immagini di marketing, i video di onboarding e gli asset di campagna uno a uno che vengono sostituiti ogni rilascio.
• Lascia gli asset stabili stabili. Con gli aggiornamenti Delta, i file invariati vengono riutilizzati al posto di essere scaricati nuovamente.

Questo è uno dei modi più facili per mantenere Capgo veloce mentre l'app cresce. Il peggior modello è un piccolo aggiustamento di UI che costringe gli utenti a scaricare un mucchio di media non correlati.

3. Mantieni i rilasci nativi per le vere modifiche native

Capgo aggiorna il layer web: HTML, CSS, JavaScript e asset caricati in esecuzione.

Non è il canale giusto per:

• nuovi plugin nativi
• modifiche dei permessi
• capacitor.config.ts modifiche
• qualsiasi cosa che modifica lo stato del progetto nativo iOS o Android.

Quella riga conta anche per le prestazioni. Se continuate a spingere cambiamenti strutturali importanti nella strada dell'aggiornamento OTA, la vostra strategia di aggiornamento diventa più pesante e rischiosa nel tempo.

Usate due corsie di rilascio di proposito:

Corsia nativa

Per modifiche dei plugin, modifiche delle autorizzazioni e configurazione nativa:

bun run build
bunx cap sync

Poi rilasciate una versione normale della store.

Corsia Capgo

Per iterazioni sicure del layer web:

bun run build
bunx @capgo/cli@latest bundle upload --channel production --delta

Rinfrescate anche la vostra linea di base nativa regolarmente se avete aggiunto di recente molti asset a lunga durata. Un nuovo build della store incorpora quella nuova linea di base, che mantiene le differenze future Capgo più piccole.

4. Usate i canali per mantenere la dimensione del rilascio piccola

Un 'aggiornamento sottile' non riguarda solo i megabyte. Si tratta anche di quanti dispositivi ricevono l'aggiornamento prima di sapere che è buono.

Capgo's il sistema dei canali è il modo più pulito per controllare questo:

• staging per QA
• beta per i tester invitati
• production per tutti
• hotfix per il ripristino di emergenza

Un flusso semplice assomiglia a questo:

1. Carica su staging.
2. Verifica su dispositivi reali.
3. Rilascia gradualmente, sia attraverso i canali controllati o la distribuzione basata sulle percentuali.
4. Ritorna immediatamente se la salute diminuisce.

Se la tua app ha più basi native multiple in circolazione, associa i canali con versione di destinazione. Ciò tiene lontani i pacchetti incompatibili o troppo pesanti dai binari più vecchi.

Per le squadre che desiderano anche cicli di revisione più stretti, Capgo funziona bene anche per anteprime dei PR. Ciò consente ai prodotti, QA e stakeholder di testare le modifiche solo in JavaScript senza dover attendere nuove versioni di TestFlight o Play.

5. Se abiliti gli aggiornamenti diretti, ottimizza la fase di avvio

Più velocemente desideri che un aggiornamento venga applicato, più disciplinata deve essere la tua via di avvio.

Capgo’s comportamento di aggiornamento i documenti raccomandano esplicitamente di associare directUpdate con gli aggiornamenti Delta. Ciò è la scelta predefinita giusta.

Il secondo guardrail è notifyAppReady().

import { CapacitorUpdater } from '@capgo/capacitor-updater'

CapacitorUpdater.notifyAppReady()

Se il tuo app non segnala pronto entro il tempo di attesa predefinito di 10 secondi notifyAppReady() o entro il tempo che hai impostato nella tua __CAPGO_KEEP_0__ configurazione, __CAPGO_KEEP_1__ può segnalare che bundle come invalido e ripristinare la versione precedente buona. Questo comportamento di rollback è quello che desideri in produzione, ma significa anche che dovresti mantenere il caricamento pulito: appReadyTimeout you set in your Capacitor config, Capgo can mark that bundle invalid and restore the previous good version. That rollback behavior is what you want in production, but it also means you should keep startup clean:

• evitare il lavoro di caricamento lento nella via critica notifyAppReady() Salva e ripristina lo stato dell'app con cura se si ricarica immediatamente
• Testa i casi di scenario di rete lenta e dispositivi di bassa gamma prima di una distribuzione ampia
• Se non l'hai rivisto di recente, la guida
• notificaAppReady

è degna di essere riletta. 6. Utilizza i canali di aggiornamento interni al posto di rebuild native non necessari Se il tuo app non segnala pronto entro il tempo di attesa predefinito di 10 secondi

o entro il tempo che hai impostato nella tua configurazione __CAPGO_KEEP_0__ , __CAPGO_KEEP_1__ può segnalare che bundle come invalido e ripristinare la versione precedente buona. Questo comportamento di rollback è quello che desideri in produzione, ma significa anche che dovresti mantenere il caricamento pulito:

Molte squadre mobili perdono tempo a costruire binari per modifiche che sono chiaramente web-only.

Se la modifica è:

• copia
• polish UI
• flusso di onboarding
• logica della schermata di prezzo
• cablaggio degli analytics
• flag di feature
• rendering di risposta o API promozionale

allora un Capgo aggiornamento è spesso l'artifact di revisione più veloce.

Quindi meno rebuild nativi, meno churn di TestFlight e un ciclo di feedback più stretto per la squadra. È uno dei benefici più sottovalutati di Capgo: puoi spostare più lavoro di revisione e QA nella corsia OTA senza infrangere il confine nativo/web.

La nostra guida su staging con un ID di app mobile copre un modo pratico per mantenere questo pulito nel tempo.

7. Mantieni lean separato da segreto

Le piccole raccolte e le raccolte sicure risolvono problemi diversi.

I canali controllano l'accesso. Non rendono una raccolta confidenziale da sole.

Se hai bisogno di garanzie di consegna più forti:

• abilita la crittografia degli aggiornamenti in tempo reale,
• usa un archivio personalizzato o una consegna auto-hosted,
• mantieni le chiavi private solo nei flussi di lavoro di CI o operatori sicurati.

Questo non rende irrilevante la dimensione degli aggiornamenti. Significa solo che dovresti ottimizzare per entrambe le dimensioni:

• per velocità
• crittografato per il controllo della consegna
• canali per il controllo della distribuzione
• rollback per la ripristino.

Un flusso di lavoro pratico “lean Capgo”

Se desideri un modello operativo di default semplice, utilizza questo:

1. Tenere separate le linee di rilascio native e OTA.
2. Caricare modifiche JS con --delta di default.
3. Usare staging e beta canali prima production.
4. Guarda Aggiorna le statistiche e i log, non solo prima della distribuzione, ma anche dopo. Trasforma i PR in anteprime installabili quando non è necessario un build nativo.
5. Tieni fuori dal bundle i grandi file multimediali che cambiano frequentemente, se possibile.
6. Aggiorna il baseline nativo dopo un aumento significativo degli asset o delle modifiche native.
7. Tratta
8. e il comportamento di rollback come parte dell'ingegneria di rilascio, non come trivia di configurazione. notifyAppReady() Quella combinazione rimane veloce molto più a lungo dell'approccio comune 'carica solo le modifiche'.

Pensiero finale

Per le __CAPGO_KEEP_0__ squadre, 'lean e veloce' non è solo un problema di dimensione del bundle.

For Capgo teams, “lean and fast” is not just a bundle-size problem.

Rilascio

Utilizza gli aggiornamenti Delta per il dimensione del payload, i canali per la dimensione del rollout e i rollback per la dimensione degli errori. Una volta che pensi all'aggiornamento OTA in questo modo, le tue aggiornamenti rimangono veloci anche quando l'app, il team e la base utenti crescono di dimensioni.

Continua da Come mantenere gli aggiornamenti di Capgo sottili e veloci

Se stai utilizzando Come mantenere gli aggiornamenti di Capgo sottili e veloci per pianificare la routing dei canali e il rollout a fasi, connettilo con Canali context Capgo feature name for release channels. Page/area: Capgo solutions marketing page. Role: Short UI label or navigation item. Seen in: page solutions/white-label.astro. Message key `solutions_white_label_visual_cell2_value` (Solutions White Label Visual Cell2 Value). per i dettagli di implementazione in Canali, Canali context Capgo feature name for release channels. Page/area: Capgo solutions marketing page. Role: Short UI label or navigation item. Seen in: page solutions/white-label.astro. Message key `solutions_white_label_visual_cell2_value` (Solutions White Label Visual Cell2 Value). per il workflow del prodotto nella Soluzione di Test di Beta, e Soluzione di Targeting della Versione per il workflow del prodotto nella Soluzione di Targeting della Versione.