Capgo utilizza 2 variabili principali per gestire le versioni nel tuo Capacitor app:
- Versione nativa
- Versioni JavaScript
All le scelte delle versioni sono decise dal lato server da Capgo.
Sistema di versioning
Per gestire la versione Capgo utilizzare il sistema SemVer. Leggi la Specifiche SemVer or check Capgo update compatibility with the Tester Semver.
Versioni
Dove Capgo trovare la versione da confrontare
È possibile sovrascrivere questo comportamento impostando la chiave versione nel
capacitor.config.jsonfile documentazione qui La versione nativa verrà ignorata per tutte le piattaforme.
IOS
In IOS il var è impostato sul tuo progetto qui ios/App/App/Info.plist Sotto la chiaveCFBundleShortVersionString o ios/App/App.xcodeproj/project.pbxproj Sotto la chiave MARKETING_VERSION se MARKETING_VERSION era impostato sul tuo Info.plist file.
Android
In Android, il var è impostato sul tuo progetto qui android/app/build.gradle Sotto la chiave defaultConfig.versionName
JavaScript ( Capgo versione del pacchetto )
In JavaScript, il var può essere impostato nel tuo package.json Sotto la chiave version
Altrimenti, è necessario fornirlo nel comando di caricamento.
Comportamento predefinito
Questo è il comportamento che il tuo canale Capgo avrà se non hai modificato alcune impostazioni.
Questo comportamento sarà basato sul canale unico che hai impostato come predefinito.
Quando l'installazione fresca del tuo Capacitor app
Quando l'utente scarica la tua app Ionic per la prima volta e apre l'app, essa contatta il server Capgo.
Attualmente, 4 output possono accadere:
- La versione del pacchetto nativo (1.2.3) è inferiore alla versione del pacchetto Capgo (1.2.4), Capgo invia il pacchetto al utente.
- La versione del pacchetto nativo (1.2.3) è uguale alla versione del pacchetto Capgo (1.2.3), Capgo invia 'nessuna necessità di aggiornamento'.
- La versione del pacchetto nativo (1.2.4) è superiore alla versione del pacchetto Capgo (1.2.3), Capgo invia 'nessuna necessità di aggiornamento'.
- La versione del bundle nativo (1.2.3) è di MAJOR versione inferiore rispetto alla versione del bundle Capgo (2.2.3), Capgo invia “non è necessario eseguire l'aggiornamento”.
Altre impostazioni
Disabilita l'auto-abbassamento sotto il nativo
Se modifichi questa impostazione su false, Capgo considererà sempre la fonte più affidabile della versione. Quindi il comportamento diventa :
- La versione nativa (1.2.4) è superiore alla versione Capgo (1.2.3)
Capgo invia la sua versione all'utente.
Disabilita la strategia di aggiornamento automatico
Esistono una coppia di strategie che puoi scegliere. Puoi imparare di più su di esse qui
La versione del bundle JavaScript è quella che invii quando esegui
Se non hai utilizzato l'opzione npx @capgo/cli@latest bundle upload --channel production
La versione del bundle JavaScript è quella che invii quando esegui --bundle 1.2.3Capgo otterrà la versione del pacchetto dal tuo package.json file (nella chiave versione).
Dopo che la tua app Ionic ha installato una versione da Capgo, questa è la versione che verrà confrontata per:
- La loro versione del bundle JavaScript (1.2.3) è inferiore a Capgo versione del pacchetto (1.2.4), Capgo invia il suo pacchetto all'utente.
Con alcune condizioni di guardia:
- Se la versione del bundle nativo è superiore a Capgo versione, la
Disable auto downgrade under nativecondizione viene applicata. - Se la versione del bundle nativo è di un ordine maggiore inferiore a Capgo versione, la
Disable auto upgrade above majorcondizione viene applicata.
Aggiornamento dell'App Store
Quando pubblichi la tua app JS Capacitor sullo Store, ciò che accade è semplice.
Lo utente riceverà la nuova versione dallo store e rimuoverà tutte le aggiornamenti locali nell'applicazione di default.
Se desideri modificare quel comportamento, devi impostare la impostazione resetWhenUpdate Leggi di più su di esso Ecco
Questo può essere modificato solo sul lato dell'app, non come gli altri impostazioni.
Gli altri impostazioni
Dopo tutto questo comportamento, puoi avere sopra alcuni specifici come quello legato all'ID dispositivo.
In Capgo, puoi decidere di sovrascrivere il comportamento per ogni ID dispositivo.
Potresti collegare un ID dispositivo a:
- una versione di pacchetto specifica
- un canale specifico
Questo supererà tutte le impostazioni fatte sopra.
Scopri di più su di esso nell'articolo qui sotto.
Continua a lavorare da Come funziona la versione in Capgo
Se stai utilizzando Come funziona la versione in Capgo per pianificare il lavoro di plugin nativi, connettilo con Capgo Directory dei Plugin per il flusso di lavoro del prodotto in Capgo Directory dei Plugin, Capacitor Plugin da Capgo per i dettagli di implementazione in Capacitor Plugin da Capgo Aggiungere o Aggiornare Plugin per i dettagli di implementazione in Aggiungere o Aggiornare Plugin Alternative per Plugin Enterprise Ionic per il flusso di lavoro del prodotto in Alternative per Plugin Enterprise Ionic, e Capgo Native Builds for the product workflow in Capgo Native Builds.