Cos'è l'Capacitor-aggiornatore?
L'Capacitor-aggiornatore, una tecnologia che aiuta nella consegna di aggiornamenti e miglioramenti dell'applicazione agli utenti finali istantaneamente.
Questo è specialmente utile se desideri fare correzioni di bug critici e consegnare istantaneamente senza passare dalle recensioni di App Store.
Puoi pensare a questo come l'agilità “web-like” della carica di aggiornamenti laterali non appena sono disponibili.
Inoltre, fornisce il rollback se l'aggiornamento nuovo fa crashare 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ò assicura che gli utenti ricevano solo aggiornamenti compatibili e prevenire 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 cambiamenti dirompenti.
Capgo’s impostazioni del canale consentono di configurare quali tipi di aggiornamenti vengono applicati automaticamente:
- Strategia maggiore: Consente tutti gli aggiornamenti (utilizzare 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 con la logica di aggiornamento di Capgo utilizzando il nostro strumento 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 a mente. La prima cosa è che gli aggiornamenti OTA funzionano solo con bundle web. Potreste pensare che questo non sia davvero un grande limite perché, in code JS, scriviamo quasi tutti Capacitor in JS, CSS e HTML. Mentre questo potrebbe essere vero, ci sono ancora moduli nativi che installiamo nell'app. Se un modulo modifica i vostri directory Android o iOS, non potete utilizzare OTA per aggiornare l'app. Questo è perché i contenuti dei directory vengono utilizzati per compilare i binari nativi, che OTA non può aggiornare. Anche l'app nativa non può aggiornare questa parte.
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 tua API chiave per caricare la tua 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 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 il Capgo nella tua app Capacitor, il CLI ti guiderà attraverso il processo di configurazione della tua app con Capgo.
Se vuoi 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 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 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 per dispositivi mobili.
Stabilisci il canale predefinito
Dopo aver inviato il tuo app a Capgo, hai bisogno di stabilire 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'applicazione su un dispositivo o un emulatore. La cosa più facile da fare è semplicemente utilizzare il seguente comando per avviare l'app locale in un emulatore o 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 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 i documenti completi Gli 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 app Capacitor in modo fluido utilizzando l'Capacitor-aggiornatore
Se stai utilizzando Aggiorna i tuoi app Capacitor in modo fluido utilizzando l'Capacitor-aggiornatore per pianificare la migrazione e le operazioni aziendali, connettilo con Capgo Azienda per il workflow del prodotto in Capgo Azienda Alternative per plugin aziendali di Ionic per il workflow del prodotto in Alternative per plugin aziendali di Ionic Capgo Alternative per il workflow del prodotto in Capgo Alternative Capgo Consulenza per il workflow del prodotto in Capgo Consulenza, e Capgo Supporto Premium per il workflow del prodotto in Capgo Supporto Premium
