Capgo usa 2 variabili principali per gestire le versioni nella tua app Capacitor:
- Versione native
- Versioni JavaScript
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.jsonfile 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 nativecondizione viene applicata. - Se la versione del bundle Native Build è MAJORmente inferiore alla versione Capgo, il
Disable auto upgrade above majorcondizione 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.