Vai alla sezione principale
Guida

Aggiorna i tuoi Capacitor app in modo senza intoppi utilizzando Capacitor-aggiornatore

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

Crediti dell'articolo

Martin Donadieu

Autore

Valeria

Recensore

Jordan

Curatore

Aggiorna i tuoi Capacitor app in modo senza intoppi utilizzando Capacitor-aggiornatore

Cosa è l'aggiornamento di Capacitor?

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

Questo è particolarmente utile se desiderate eseguire riparazioni di bug critici e consegnare istantaneamente senza dover passare attraverso le recensioni dell'App Store.

Potete pensare a questo come l'agilità "web-like" della caricazione di aggiornamenti appena disponibili.

Inoltre, fornisce rollback se l'aggiornamento nuovo fa impattare 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 aiutarvi a fine-tune l'esperienza dell'utente.

Utilizzo Capgo in tutti i miei progetti che costruisco. Ciò mi consente di dedicare meno tempo al processo di recensione dell'App Store.

Potete 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 dovrebbero essere applicati all'applicazione. Ciò assicura che gli utenti ricevano solo aggiornamenti compatibili e prevenire i cambiamenti di rotta da essere distribuiti automaticamente.

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

  • MAJOR: Cambiamenti di versione che richiedono una rilascio dell'applicazione nativa
  • MINOR: Funzionalità nuove compatibili con la retrocompatibilità
  • PATCH: Correzioni di bug compatibili con la retrocompatibilità

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 un rilascio dell'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:

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

Puoi testare come funzionano le combinazioni di versione diverse con la logica di aggiornamento di Capgo 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.

Ci sono delle limitazioni?

Come sembra buono, 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 una grande limitazione 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 nostri directory Android o iOS, non puoi utilizzare OTA per aggiornare l'app. Questo 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 Auto Capgo

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

Una volta che sei connesso a 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 esegui un npm run build && npx cap copy per aggiornare il tuo progetto.

Accedi a Capgo CLOUD

Prima, utilizza il all apikey presente nel tuo account per accedere con il CLI:

npx @capgo/cli@latest login YOU_KEY

Aggiungi la tua prima app

Cominciamo creando la prima app in Capgo Cloud con il CLI.

npx @capgo/cli@latest app add

Questo comando utilizza 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 package.json file.

Verifica nel Capgo se il build è presente

Potresti anche testarlo con il mio applicazione mobile di sandbox.

Stabilisci il canale predefinito

Dopo aver inviato il tuo app a Capgo, devi 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 la tua 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 la documentazione completa degli Aggiornamenti in Tempo Reale.

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

Continua con l'aggiornamento dei tuoi Capacitor applicazioni in modo fluido utilizzando il Capacitor-aggiornatore

Se stai utilizzando Aggiorna i tuoi Capacitor applicazioni in modo fluido utilizzando il Capacitor-aggiornatore per pianificare la migrazione e le operazioni aziendali, connettilo con Capgo Enterprise per il flusso di lavoro del prodotto in Capgo Enterprise, Alternativi per il plugin di Ionic Enterprise per il flusso di lavoro del prodotto in Alternativi per il plugin di Ionic Enterprise, Capgo Alternativi per il flusso di lavoro del prodotto in Capgo Alternativi, Capgo Consulting per il flusso di lavoro del prodotto in Capgo Consulting, e Capgo Supporto Premium per il flusso di lavoro del prodotto in Capgo Supporto Premium.

Aggiornamenti in tempo reale per le Capacitor app

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

Supporto umano da Martin

Inizia subito

Ultimi articoli dal nostro Blog

Capgo ti dà le migliori informazioni che ti servono per creare un'app mobile veramente professionale.