Cos'è l'Capacitor-aggiornatore?
L'Capacitor-aggiornatore, una tecnologia che aiuta nella consegna di aggiornamenti e miglioramenti dell'app per gli utenti finali istantaneamente.
Questo è specialmente grande se desideri fare riparazioni di bug critici e consegnare istantaneamente senza passare attraverso le recensioni dell'App Store.
Potresti pensare a esso come 'agilità web-like' della caricazione di aggiornamenti appena disponibili.
Inoltre, fornisce rollback se l'aggiornamento nuovo fa imploreggere l'app
Come funziona?
Capgo mantiene sincronizzato il bundle JavaScript dell'app con il server Capgo, e ogni volta che l'utente apre l'app, controlla con il server Capgo se è disponibile un aggiornamento nuovo per il bundle. E naturalmente, viene fornito con tonnellate di configurazioni incredibili che possono aiutarti a regolare l'esperienza dell'utente.
Utilizzo Capgo in tutti i miei progetti che costruisco. Ciò mi consente di dedicare meno tempo al processo di revisione dell'App Store.
Puoi leggere di più su di esso qui.
Capire la versione semantica con Capgo
Capgo utilizza la versione semantica (semver) per determinare quando e come gli aggiornamenti dovrebbero essere applicati all'app. Ciò assicura che gli utenti ricevano solo aggiornamenti compatibili e prevene le modifiche di rotture che vengono distribuite automaticamente.
La versione semantica segue il formato MAJOR.MINOR.PATCH:
- MAJOR: Modifiche di rotture che richiedono una rilascio nativo dell'app store
- MINOR: Funzionalità nuove che sono compatibili con il passato
- PATCH: Correzioni di bug compatibili con la versione precedente
Ad esempio, se il tuo app è alla versione 1.0.0 e desideri aggiornare a 1.0.1 (una patch), Capgo applicherà automaticamente questo aggiornamento. Tuttavia, se desideri aggiornare da 1.0.0 a 2.0.0 (una versione maggiore), ciò richiederebbe una rilascio di app nativa nel negozio, poiché indica cambiamenti di rottura.
Capgo’s impostazioni del canale consentono di configurare quali tipi di aggiornamenti vengono applicati automaticamente:
- : Consente tutti gli aggiornamenti (utilizzare con cautela): Consente solo gli aggiornamenti minori e di patch
- : Consente solo gli aggiornamenti di patchFor example, if your app is at version
- and you want to update to: Solo consente aggiornamenti patch
- Strategia di metadati: Richiede che i requisiti minimi di versione siano soddisfatti
Potete testare come funzionano le combinazioni di versione diverse con la logica di aggiornamento di Capgo utilizzando il nostro strumento di tester Semver Strumento di tester Semver. Questo strumento vi aiuta a capire esattamente quando gli aggiornamenti saranno applicati in base alla configurazione del canale.
Esistono delle limitazioni?
Come potrebbe sembrare, ci sono alcune cose che dobbiamo tenere in mente. La prima cosa è che gli aggiornamenti OTA. You may think that this isn’t really a big limitation because, in Capacitor JS, we write almost all code in JS CSS and HTML. While this may be true, there still are native modules that we install to our app. If a module changes your android or iOS directories, you can’t use OTA to update your app. That’s because these directories’ contents are used to compile Native binaries, which OTA can’t update. Even native app cannot update this part.
. Potreste pensare che questo non sia davvero un grande limite perché, in __CAPGO_KEEP_0__ JS, scriviamo quasi tutti i __CAPGO_KEEP_1__ in JS, CSS e HTML. Sebbene questo possa essere vero, ci sono ancora moduli nativi che installiamo nell'applicazione. Se un modulo modifica i vostri directory Android o iOS, non potete utilizzare gli OTA per aggiornare l'applicazione. Questo è perché i contenuti dei directory vengono utilizzati per compilare i binari nativi, che gli OTA non possono aggiornare. Anche l'applicazione nativa non può aggiornare questa parte. Ma potete configurare il vostro CI/CD per gestire questa parte, ho fatto un tutorial su come farlo qui per IOS.
Configurazione Auto Capgo
È arrivato il momento di iscriversi e ottenere la propria chiave API per caricare la prima versione! Inizia con iscrivendoti a un account Capgo.
Una volta che sei loggato in Capgo, avrai una pagina di onboarding

Segui i passaggi sulla pagina di onboarding per aggiungere la prima app.
Segui le indicazioni di CLI
Dal prompt dei comandi, direttamente nella radice della tua app Capacitor, esegui:
npx @capgo/cli@latest init
Per installare Capgo nella tua app Capacitor, CLI ti guiderà attraverso il processo di configurazione della tua app con Capgo.
Se desideri farlo manualmente, puoi seguire i passaggi di seguito.
Configurazione manuale Capgo
Installa il plugin
Dovresti finire con questo code aggiunto al tuo app :
npm i @capgo/capacitor-updater && npx cap sync
Per installare il plugin nel tuo Capacitor app.
E poi aggiungi al tuo app questo code per notificare il plugin nativo che il bundle JS è sano (se non lo fai, il plugin nativo si riporta alla versione precedente):
import { CapacitorUpdater } from '@capgo/capacitor-updater'
CapacitorUpdater.notifyAppReady()
Ciò dirà al plugin nativo che l'installazione è riuscita.
Poi fai un npm run build && npx cap copy per aggiornare il tuo app.
Accedi a Capgo CLOUD
In primo luogo, utilizza l' all apikey presente nel tuo account per accedere con il CLI:
npx @capgo/cli@latest login YOU_KEY
Aggiungi il tuo primo app
Iniziamo creando un app in Capgo Cloud con il CLI.
npx @capgo/cli@latest app add
Questo comando utilizzerà tutte le variabili definite nel file di configurazione Capacitor per creare l'applicazione.
Carica la tua prima versione
Esegui il comando per costruire il tuo code e inviarlo a Capgo con:
npx @capgo/cli@latest bundle upload
Di default, il nome della versione sarà quello presente nel tuo package.json file.
Verifica in Capgo se il build è presente.
Potresti anche testarlo con il mio applicazione sandbox mobile.
Definisci il canale predefinito
Dopo aver inviato il tuo app a Capgo, hai bisogno di definire il tuo canale default To lasciare che le app ricevano aggiornamenti da Capgo.
npx @capgo/cli@latest channel set production -s default
Ricevi un Aggiornamento in Tempo Reale su un Dispositivo
Perché il tuo'applicazione riceva un aggiornamento in tempo reale da Deploy, dovrai eseguire l'app sul dispositivo o su un emulatore. Il modo più facile per farlo è semplicemente utilizzare il seguente comando per avviare l'app locale in un emulatore o in un dispositivo collegato al tuo computer.
npx cap run [ios | android]
Apre l'app, mettila in background e aprila di nuovo, dovresti vedere nei log che l'app ha fatto l'aggiornamento.
Congratulazioni! 🎉 Hai avuto successo nel distribuire il tuo primo Aggiornamento in Tempo Reale. Questo è solo l'inizio di tutto ciò che puoi fare con gli Aggiornamenti in Tempo Reale. Per imparare di più, consulta la documentazione completa Documentazione degli Aggiornamenti in Tempo Reale.
Se hai bisogno di fermare di ricevere in locale l'aggiornamento esegui questo comando
npx @capgo/cli@latest channel set
Continua a procedere con l'aggiornamento dei tuoi Capacitor app in modo fluido utilizzando il Capacitor-aggiornatore
Se stai utilizzando Aggiorna le tue Capacitor app in modo fluido utilizzando il Capacitor-aggiornatore per pianificare la migrazione e le operazioni aziendali, connettilo con Capgo Enterprise per il workflow del prodotto in Capgo Enterprise, Alternative per l'plugin di Ionic Enterprise per il workflow del prodotto in Alternative per l'plugin di Ionic Enterprise, Alternative per Capgo per il workflow del prodotto in Alternative per Capgo, Consulting di Capgo per il workflow del prodotto in Consulting di Capgo e Supporto Premium di Capgo per il workflow del prodotto in Supporto Premium di Capgo.