Saltare al contenuto principale
Tutorial

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

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

Martin Donadieu

Martin Donadieu

Content Marketer

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

Cos'è l'Capacitor-aggiornatore?

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

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

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

Inoltre, fornisce rollback se l'aggiornamento nuovo fa imploreggere 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 aggiornamento nuovo 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 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'app. Ciò assicura che gli utenti ricevano solo aggiornamenti compatibili e prevene le modifiche di rotture che vengono distribuite automaticamente.

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

  • MAJOR: Modifiche di rotture che richiedono una rilascio nativo dell'app store
  • MINOR: Funzionalità nuove che sono compatibili con il passato
  • PATCH: Correzioni di bug compatibili con la versione precedente

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

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

  • : Consente tutti gli aggiornamenti (utilizzare con cautela): Consente solo gli aggiornamenti minori e di patch
  • : Consente solo gli aggiornamenti di patchFor example, if your app is at version
  • and you want to update to: Solo consente aggiornamenti patch
  • Strategia di metadati: Richiede che i requisiti minimi di versione siano soddisfatti

Potete testare come funzionano le combinazioni di versione diverse con la logica di aggiornamento di Capgo utilizzando il nostro strumento di tester Semver 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 in mente. La prima cosa è che gli aggiornamenti OTA. You may think that this isn’t really a big limitation because, in Capacitor JS, we write almost all code in JS CSS and HTML. While this may be true, there still are native modules that we install to our app. If a module changes your android or iOS directories, you can’t use OTA to update your app. That’s because these directories’ contents are used to compile Native binaries, which OTA can’t update. Even native app cannot update this part.

. Potreste pensare che questo non sia davvero un grande limite perché, in __CAPGO_KEEP_0__ JS, scriviamo quasi tutti i __CAPGO_KEEP_1__ in JS, CSS e HTML. Sebbene questo possa essere vero, ci sono ancora moduli nativi che installiamo nell'applicazione. Se un modulo modifica i vostri directory Android o iOS, non potete utilizzare gli OTA per aggiornare l'applicazione. Questo è perché i contenuti dei directory vengono utilizzati per compilare i binari nativi, che gli OTA non possono aggiornare. Anche l'applicazione nativa non può aggiornare questa parte. Ma potete configurare il vostro CI/CD per gestire questa parte, ho fatto un tutorial su come farlo qui per IOS.

Configurazione Auto Capgo

È arrivato il momento di iscriversi e ottenere la propria chiave API per caricare la prima versione! Inizia con iscrivendoti 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 indicazioni di CLI

Dal prompt dei comandi, direttamente nella radice della tua app Capacitor, esegui:

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

Se desideri farlo manualmente, puoi seguire i passaggi di seguito.

Configurazione 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 il tuo primo app

Iniziamo 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 Capacitor per creare l'applicazione.

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 in Capgo se il build è presente.

Potresti anche testarlo con il mio applicazione sandbox mobile.

Definisci il canale predefinito

Dopo aver inviato il tuo app a Capgo, hai bisogno di definire il tuo canale default To lasciare che le app ricevano 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'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]

Apre l'app, mettila in background e aprila di nuovo, 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 Documentazione 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 con l'aggiornamento dei tuoi Capacitor app in modo fluido utilizzando il Capacitor-aggiornatore

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

Gli aggiornamenti in tempo reale per le 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.

Inizia subito

Ultimi articoli dal nostro Blog

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