Saltare al contenuto 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.

Martin Donadieu

Martin Donadieu

Content Marketer

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

Cos'è Capacitor-aggiornatore?

Capacitor-aggiornatore, una tecnologia che aiuta nella consegna di aggiornamenti e miglioramenti dell'app per gli utenti finali istantaneamente.

Questo è specialmente grande se vuoi fare correzioni di bug critici e consegnare istantaneamente senza passare dalle recensioni dell'App Store.

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

Di conseguenza, fornisce il rollback se l'aggiornamento nuovo fa crollare l'app

Come funziona?

Capgo mantiene sincronizzato il pacchetto JavaScript dell'app con il Capgo server, e ogni volta che l'utente apre l'app, controlla con il Capgo server se è disponibile un nuovo aggiornamento per il pacchetto. E naturalmente, viene fornito con un sacco 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.

Leggi 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 debbano essere applicati all'app. 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 rotta che richiedono una rilascio nativo dell'app store
  • MINOR: Nuove funzionalità compatibili con versioni precedenti
  • PATCH: Correzioni di bug compatibili con versioni precedenti

Per esempio, se il tuo app è alla versione 1.0.0 e desideri aggiornare a 1.0.1 (Capgo), verrà applicato automaticamente questo aggiornamento. Tuttavia, se desideri aggiornare da 1.0.0 to 2.0.0 contexto: Pagina/Livello: Pagina prodotti di aggiornamenti in tempo reale. Ruolo: Etichetta breve o elemento di navigazione. Chiave di messaggio `live_update_dynamic_label_to` (Etichetta dinamica di aggiornamento in tempo reale To).

(Capgo), ciò richiederebbe una rilascio nativo della store di app poiché indica cambiamenti di versione.

  • __CAPGO_KEEP_0__’s impostazioni del canale consentono di configurare quali tipi di aggiornamenti vengono applicati automaticamente:Strategia maggiore
  • : Consente tutti gli aggiornamenti (utilizzare con cautela): Consente aggiornamenti minori e di patch solo
  • Strategia di patch: Consente solo aggiornamenti di patch
  • Strategia di metadati: Richiede che i requisiti di versione minima siano soddisfatti

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 vostra configurazione del canale.

Sono presenti 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. Potreste 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 vostri directory Android o iOS, non potete utilizzare gli OTA per aggiornare l'app. Questo è perché i contenuti dei directory vengono utilizzati per compilare i binari nativi, che gli OTA non possono aggiornare. Non anche gli app nativi possono aggiornare questa parte.

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

Configurazione Auto Capgo

E' arrivato il momento di iscriversi e ottenere la propria API chiave per caricare la prima versione! Inizia con iscriversi a un account Capgo.

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 della tua Capacitor app, esegui:

npx @capgo/cli@latest init Per installare il Capgo nella tua Capacitor app, il CLI ti guiderà attraverso il processo di configurazione della tua app con Capgo.

Se desideri farlo manualmente, puoi seguire i passaggi sotto.

Configurazione manuale Capgo

Installa il plugin

Avresti dovuto ottenere 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 ripiegherà sulla versione precedente):

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

CapacitorUpdater.notifyAppReady()

Questo ti dirà al plugin nativo che l'installazione è andata a buon fine.

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

Accedi a Capgo CLOUD

Prima, 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

Cominciamo 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 di Capacitor per creare l'app.

Carica la tua prima versione

Eseguisci 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.

Aggiorna il canale predefinito

Dopo aver inviato il tuo app a Capgo, devi fare in modo che 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, dovrai 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 di ricevere in locale l'aggiornamento esegui questo comando npx @capgo/cli@latest channel set

Continua a procedere dall'aggiornamento del tuo Capacitor app in modo fluido utilizzando Capacitor-aggiornatore

Se stai utilizzando Aggiorna i tuoi Capacitor app in modo fluido utilizzando 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 Capgo Alternative per il workflow del prodotto in Capgo Alternative Capgo Consultazione per il workflow del prodotto in Capgo Consultazione, e Capgo Supporto Premium per il workflow del prodotto in Capgo Supporto Premium.

Aggiornamenti in tempo reale per le tue Capacitor app

Quando un bug del 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.

Sostegno umano da parte di Martin

Inizia subito

Ultimi articoli dal nostro Blog

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