Salta al contenuto principale
Tutorial

Come funzionano le versioni in Capgo

Capisci come Capgo gestisce le versioni nella tua app Capacitor e sfruttalo al meglio. Scopri il significato di major, minor e patch.

Come funziona la versioning in Capgo Capgo illustrazione del blog

Capgo usa 2 variabili principali per gestire le versioni nella tua app Capacitor:

  • Versione native
  • Versioni JavaScript
Sistema di update di Capacitor

Tutte le scelte relative alle versioni vengono decise lato server da Capgo.

Sistema di versionamento

Per gestire le versioni, Capgo utilizza il sistema SemVer. Leggi la specificazione SemVer o verifica la compatibilità degli aggiornamenti di Capgo con il Semver Tester.

Versioni

Dove Capgo trova la versione da confrontare

Puoi sovrascrivere questo comportamento impostando la chiave version in capacitor.config.json file docs qui La versione nativa verrà ignorata per tutte le piattaforme.

iOS

Su iOS la variabile è impostata nel tuo progetto qui ios/App/App/Info.plist sotto la chiaveCFBundleShortVersionString oppure ios/App/App.xcodeproj/project.pbxproj sotto la chiave MARKETING_VERSION se MARKETING_VERSION era impostata nel tuo Info.plist file.

Android

In Android, la variabile viene impostata qui nel progetto android/app/build.gradle sotto la chiave defaultConfig.versionName

JavaScript ( versione bundle Capgo )

In JavaScript, la variabile può essere impostata nel tuo package.json sotto la chiave version Altrimenti, devi fornirla nel comando di upload.

Comportamento predefinito

Ecco come si comporterà il canale Capgo se non hai modificato alcuna impostazione.

Questo comportamento si baserà sul canale unico che hai impostato come predefinito.

In caso di nuova installazione della tua app Capacitor

Quando l'utente scarica la tua app Ionic per la prima volta e la apre, questa contatta il server di Capgo.

Attualmente possono verificarsi 4 scenari:

  • La versione del bundle nativo (1.2.3) è inferiore alla versione del bundle di Capgo (1.2.4), Capgo invia il proprio bundle all'utente.
  • La versione del bundle nativo (1.2.3) è uguale alla versione del bundle di Capgo (1.2.3), Capgo risponde "nessun aggiornamento necessario".
  • La versione del bundle nativo (1.2.4) è superiore alla versione del bundle di Capgo (1.2.3), Capgo risponde "nessun aggiornamento necessario".
  • La versione del bundle nativo (1.2.3) ha una MAJOR inferiore alla versione del bundle di Capgo (2.2.3), Capgo risponde "nessun aggiornamento necessario".

Altre impostazioni

Disabilita auto-downgrade lato native

Se imposti questa opzione su false, Capgo considererà sempre quella come la fonte attendibile della versione.\nIl comportamento diventerà quindi:

  • La versione nativa (1.2.4) è superiore alla versione di Capgo (1.2.3)

Capgo invia la propria versione all'utente.

Disabilita la strategia di auto-upgrade

Ci sono alcune strategie tra cui scegliere. Puoi saperne di più qui

Versione del bundle JavaScript

La versione del bundle JavaScript è quella che invii quando esegui npx @capgo/cli@latest bundle upload --channel production

Se non hai utilizzato l'opzione --bundle 1.2.3, Capgo recupererà la versione del bundle dal tuo package.json file (nella chiave version).

Dopo che la tua app Ionic ha installato una versione da Capgo, è questa la versione che verrà confrontata per:

  • La versione del loro bundle JavaScript (1.2.3) è inferiore alla versione del bundle di Capgo (1.2.4), Capgo invia il proprio bundle all'utente.

Con alcune condizioni di controllo:

  • Se la versione del bundle nativo è superiore alla versione di Capgo, la Disable auto downgrade under native condizione viene applicata.
  • Se la versione del bundle Native Build è MAJORmente inferiore alla versione Capgo, il Disable auto upgrade above major condizione viene applicata.

aggiornamento dell'App Store

Quando pubblichi la tua app JS con Capacitor sull'App Store, quello che succede è semplice.

L'utente riceverà la nuova versione dallo store e, per impostazione predefinita, rimuoverà tutti gli update locali nell'app.

Se vuoi modificare quel comportamento, devi impostare la configurazione resetWhenUpdate ne leggi di più qui

Questo può essere modificato solo lato app, non dal cloud come altre impostazioni.

Altre impostazioni

Dopo tutto questo comportamento, è possibile avere sopra di esso uno specifico legato al deviceID.

In Capgo, puoi decidere di sovrascrivere il comportamento per ogni deviceID.

Puoi collegare un deviceID a:

  • una versione di bundle specifica
  • un canale specifico

Questo bypasserà tutte le impostazioni configurate sopra.

Scopri di più nell'articolo qui sotto.

Continua da Come funzionano le versioni in Capgo

Se stai usando Come funzionano le versioni in Capgo per pianificare il lavoro sui plugin nativi, collegalo a Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Capacitor Plugins di Capgo, Aggiunta o aggiornamento dei plugin per i dettagli sull'implementazione in Adding or Updating Plugins, Alternative ai plugin Ionic Enterprise per il workflow del prodotto in Ionic Enterprise Plugin Alternatives, e Capgo Native Build per il workflow di prodotto in Capgo Native Builds.

Live updates per le app Capacitor

Quando un bug nel web-layer è live, rilascia la fix tramite Capgo invece di aspettare giorni l'approvazione degli store. Gli utenti ricevono l'update in background, mentre le modifiche native restano nel normale processo di review.

Ultimi articoli dal blog

Capgo ti offre gli insight migliori che ti servono per creare un'app mobile davvero professionale.