Vai al contenuto principale
Tutorial

Aggiorna i tuoi Capacitor app in modo trasparente utilizzando l'Capacitor-aggiornatore

Ciao Capacitor Community Ionic, oggi ti aiuterò a configurare l'Capacitor-aggiornatore nel tuo app. In modo che tu possa effettuare rilasci senza problemi.

Martin Donadieu

Martin Donadieu

Content Marketer

Aggiorna i tuoi Capacitor app in modo trasparente utilizzando l'Capacitor-aggiornatore

Cos'è l'aggiornamento Capacitor?

Capacitor-aggiornamento, una tecnologia che aiuta nella consegna di aggiornamenti e miglioramenti dell'applicazione agli utenti finali istantaneamente.

Questo è specialmente grande se desideri fare riparazioni di bug critici e consegnare istantaneamente senza passare attraverso le recensioni di App Store.

Puoi pensare a esso come 'agilità web-like' della caricazione di aggiornamenti non appena sono disponibili.

Inoltre, fornisce rollback se l'aggiornamento nuovo fa imploreggiare l'applicazione.

Come funziona?

Capgo mantiene il pacchetto JavaScript dell'applicazione in sincronia con il server Capgo, e ogni volta che l'utente apre l'applicazione, controlla con il server Capgo se è disponibile un nuovo aggiornamento per il pacchetto. E naturalmente, viene fornito con tonnellate di configurazioni incredibili che possono aiutarti a fine-tune l'esperienza dell'utente.

Utilizzo Capgo in tutti i miei progetti che costruisco. Ciò mi consente di mettere meno tempo nel processo di recensione di 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'applicazione. Ciò assicura che gli utenti ricevano solo aggiornamenti compatibili e prevenire cambiamenti di rotta da essere distribuiti automaticamente.

La versione semantica segue il formato MAJOR.MINOR.PATCH:

  • MAJOR: Cambiamenti di versione che richiedono una rilascio di un'applicazione nativa
  • MINOR: Funzionalità nuove che sono compatibili all'indietro
  • PATCH: Correzioni di bug che sono compatibili all'indietro

Ad esempio, se il tuo app è alla versione 1.0.0 e vuoi aggiornarla a 1.0.1 (una patch), Capgo applicherà automaticamente questo aggiornamento. Tuttavia, se vuoi aggiornare da 1.0.0 a 2.0.0 (una versione maggiore), ciò richiederebbe un rilascio di un'applicazione nativa poiché indica cambiamenti di versione che rompono la compatibilità.

Capgo’s impostazioni del canale consentono di configurare quali tipi di aggiornamenti vengono applicati automaticamente:

  • Tattica maggiore: Consente tutti gli aggiornamenti (utilizzare con cautela)
  • Tattica minore: Consente aggiornamenti minore e patch solo
  • Tattica patch: Consente solo gli aggiornamenti patch
  • Tattica metadata: Richiede che i requisiti di versione minima siano soddisfatti

Puoi testare come funzionano le combinazioni di versione diverse con Capgo’s logica di aggiornamento utilizzando il nostro Strumento di tester Semver. Questo strumento ti aiuta a capire esattamente quando gli aggiornamenti saranno applicati in base alla tua 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 i pacchetti web. Potresti pensare che questo non sia davvero un grande limite perché, in Capacitor JS, scriviamo quasi tutti i code in JS, CSS e HTML. Mentre questo potrebbe essere vero, ci sono ancora moduli nativi che installiamo nell'app. Se un modulo modifica i tuoi directory Android o iOS, non puoi utilizzare OTA per aggiornare l'app. Ciò perché i contenuti di questi directory vengono utilizzati per compilare i binari nativi, che OTA non può aggiornare. Anche l'app nativa non può aggiornare questa parte.

Ma puoi configurare il tuo CI/CD per gestire questa parte, ho fatto un tutorial su come farlo qui per IOS.

Configurazione di Auto Capgo

È ora di iscriversi e ottenere la tua API chiave per caricare la tua prima versione! Inizia con l'iscrizione a un Capgo account.

Una volta che sei loggato in Capgo, avrai una pagina di onboarding

Pagina di onboarding

Segui i passaggi sulla pagina di onboarding per aggiungere la tua prima app.

Segui le CLI linee guida

Dalla riga di comando, direttamente nella radice del tuo Capacitor progetto, esegui:

npx @capgo/cli@latest init Per installare il Capgo nel tuo Capacitor progetto, il CLI ti guiderà attraverso il processo di configurazione del tuo progetto con Capgo.

Se desideri farlo manualmente, puoi seguire i passaggi sotto.

Configurazione manuale del Capgo

Installa il plugin

Devi finire con questo code aggiunto al tuo progetto:

npm i @capgo/capacitor-updater && npx cap sync Per installare il plugin nel tuo Capacitor progetto.

E poi aggiungi al tuo progetto questo code per notificare al plugin nativo che il bundle JS è sano (se non lo fai, il plugin nativo si rollbackerà alla versione precedente):

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

CapacitorUpdater.notifyAppReady()

Questo ti dirà al plugin nativo che l'installazione è riuscita.

Poi fai un npm run build && npx cap copy per aggiornare il tuo progetto.

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

Iniziamo creando la 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 di 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.

Verifica il check-in Capgo se il build è presente.

Puoi anche testarlo con il mio applicazione mobile sandbox.

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'applicazione su un dispositivo o un emulatore. La cosa più facile da fare è semplicemente utilizzare il seguente comando per avviare la tua app locale in un emulatore o un dispositivo collegato al tuo computer.

npx cap run [ios | android]

Apri 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 degli Aggiornamenti in Tempo Reale.

Se hai bisogno di fermare la ricezione di aggiornamenti locali, esegui questo comando npx @capgo/cli@latest channel set

Continua senza interruzioni con l'aggiornamento dei tuoi Capacitor applicazioni utilizzando l'Capacitor-aggiornatore

Se stai utilizzando Continua senza interruzioni con l'aggiornamento dei tuoi Capacitor applicazioni utilizzando l'Capacitor-aggiornatore per pianificare la migrazione e le operazioni aziendali, connettilo con Capgo Enterprise per il workflow del prodotto in Capgo Enterprise, Alternativi per Plugin Enterprise di Ionic per il workflow del prodotto in Alternativi per Plugin Enterprise di Ionic, Alternativi per Capgo per il workflow del prodotto in Alternativi per Capgo, Alternativi per Capgo Consulting per il workflow del prodotto in Capgo Consulting, e Capgo Supporto Premium per il workflow del prodotto in Capgo Supporto Premium.

Aggiornamenti in tempo reale per le app Capacitor

Quando un bug nel layer web è attivo, invia la correzione attraverso Capgo invece di attendere giorni per l'approvazione della store. Gli utenti ricevono l'aggiornamento in background mentre le modifiche native rimangono nel normale percorso di revisione.

Inizia subito

Ultimi articoli dal nostro Blog

Capgo ti offre le migliori informazioni che ti servono per creare un'app mobile davvero professionale.