What is Capacitor-updater?
Capacitor-updater, a technology that helps in the delivery of app updates and improvements to the end users instantly.
Martin Donadieu
Content Marketer
Inoltre, fornisce rollback se l'aggiornamento nuovo fa impattare 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 nuovo aggiornamento 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 questo qui.
Capire la versione semantica con Capgo
Capgo utilizza la versione semantica (semver) per determinare quando e come gli aggiornamenti debbano essere applicati all'app. Ciò garantisce che gli utenti ricevano solo aggiornamenti compatibili e impedisce che i cambiamenti di rotta vengano distribuiti automaticamente.
La versione semantica segue il formato MAJOR.MINOR.PATCH:
- MAJOR: Cambiamenti di rotta che richiedono una rilascio nativo dell'app store
- MINOR: Nuove funzionalità compatibili con versioni precedenti
- PATCH: Correzioni di bug compatibili con versioni precedenti
Ad esempio, se il tuo app è alla versione 1.0.0 e desideri aggiornarla 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 nativo dell'app store poiché indica modifiche dirottanti.
Capgo’s impostazioni del canale consentono di configurare quali tipi di aggiornamenti vengono applicati automaticamente:
- Strategia maggiore: Consente tutti gli aggiornamenti (utilizzarla con cautela)
- Strategia minore: Consente aggiornamenti minori e di patch solo
- Strategia di patch: Consente solo aggiornamenti di patch
- Strategia di metadati: Richiede che vengano soddisfatte le esigenze di versione minima
Potete testare come funzionano le combinazioni di versione diverse utilizzando la logica di aggiornamento di Capgo con 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.
Ma puoi impostare il tuo CI/CD per gestire questa parte, ho fatto un tutorial su come farlo qui per IOS.
Configurazione Auto Capgo
È ora di iscriversi e ottenere la propria API chiave per caricare la prima versione! Inizia con iscrivendoti a un account Capgo.
Una volta acceduto a Capgo, avrai una pagina di onboarding
Segui i passaggi sulla pagina di onboarding per aggiungere la tua prima app.
Segui le CLI istruzioni
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 del 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 al 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 la tua prima app
Inizia creando la tua prima 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'app.
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.
Controlla in Capgo se il build è presente.
Puoi anche testarlo con il mio app di sandbox mobile Puoi anche testarlo con il mio app di sandbox mobile.
Imposta il canale predefinito
Dopo aver inviato il tuo app a Capgo, hai bisogno di impostare il tuo canale default per consentire agli app di ricevere 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, avrai bisogno di eseguire l'app sul dispositivo o su un emulatore. La cosa più facile da fare è 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 nuovamente, dovresti vedere nei log che l'app ha eseguito 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 i documenti completi Gli Aggiornamenti in Tempo Reale.
Se hai bisogno di fermare di ricevere in locale gli aggiornamenti, esegui questo comando
npx @capgo/cli@latest channel set
