Ciao comunità __CAPGO_KEEP_0__ Ionic, oggi ti aiuterò a configurare l'aggiornatore __CAPGO_KEEP_1__ nel tuo app. In modo che tu possa fare rilasci senza problemi.
Tutorial

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

Ciao Capacitor Community Ionic, oggi ti aiuterò a configurare 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 Capacitor-aggiornatore

What is Capacitor-aggiornatore?

Capacitor-aggiornatore, 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' di caricamento di aggiornamenti appena 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-tuning 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'app nativa
  • MINOR: Nuove funzionalità compatibili all'indietro
  • PATCH: Correzioni di bug compatibili all'indietro

Ad esempio, se il tuo app è alla versione 1.0.0 e vuoi aggiornare 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'app nativa poiché indica cambiamenti di versione.

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

  • Schema maggiore: Consente tutti gli aggiornamenti (utilizzare con cautela)
  • Schema minore: Consente aggiornamenti minore e di patch solo
  • Schema di patch: Consente solo gli aggiornamenti di patch
  • Schema di metadati: 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.

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 bundle 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 tuoi 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. Neppure l'app nativa 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 propria API chiave per caricare la prima versione! Inizia con l'iscrizione 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 prima app.

Segui le CLI linee guida

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

npx @capgo/cli@latest init Per installare il Capgo nel tuo Capacitor app, il CLI ti guiderà attraverso il processo di configurazione del tuo app 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 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 rollback 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 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

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 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'app sul dispositivo o su un emulatore. Il modo più facile per farlo è 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]

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 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 app utilizzando l'Capacitor-aggiornatore

Se stai utilizzando Aggiorna i tuoi Capacitor app senza interruzioni utilizzando l'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 Plugin Enterprise di Ionic per il flusso di lavoro del prodotto in Alternativi per Plugin Enterprise di Ionic, Capgo Alternativi per il flusso di lavoro del prodotto in Capgo Alternativi, 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 tue 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.

Inizia subito

Ultimi articoli dal nostro Blog

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