Capgo utilizza 2 variabili principali per gestire le versioni nel tuo Capacitor app:
- Versione nativa
- Versioni JavaScript
Tutte le scelte delle versioni sono decise dal lato server da Capgo.
Sistema di versioning
Per gestire la versione Capgo utilizzare il sistema SemVer, leggi di più su questo qui.
Versioni
Dove Capgo trovare la versione da confrontare
Puoi sovrascrivere questo comportamento impostando la chiave versione nel
capacitor.config.jsonfile docs qui La versione nativa verrà ignorata per tutte le piattaforme.
IOS
In IOS la variabile viene impostata nel 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 è stato impostato nel tuo Info.plist file.
Android
In Android, la variabile è impostata nel tuo progetto qui android/app/build.gradle sotto la chiave defaultConfig.versionName
JavaScript ( Capgo versione del pacchetto )
In JavaScript, la variabile può essere impostata nel tuo package.json sotto la chiave version
Altrimenti, dovrai fornirlo nella riga di comando di caricamento.
Comportamento predefinito
Questa è la modalità in cui il canale Capgo si comporterà se non hai modificato alcun impostazione.
Questo comportamento sarà basato sul canale unico che hai impostato come predefinito.
Quando si effettua una installazione fresca dell'app Capacitor
Quando l'utente scarica per la prima volta la tua app Ionic e apre l'app, essa contatta il server Capgo.
Attualmente, possono accadere 4 esiti:
- 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 “non è necessario aggiornare”.
- La versione del pacchetto nativo (1.2.4) è superiore alla versione del pacchetto Capgo (1.2.3), Capgo invia “non è necessario aggiornare”.
- La versione del pacchetto nativo (1.2.3) è di un major inferiore alla versione del pacchetto Capgo (2.2.3), Capgo invia “non è necessario aggiornare”.
Altre impostazioni
Disabilita l'auto-abbassamento nativo
Se modifichi questo impostazione a falso, Capgo considererà sempre la fonte più affidabile della versione. Quindi il comportamento diventerà :
- La versione nativa (1.2.4) è superiore alla versione di Capgo (1.2.3)
Capgo invia la sua versione all'utente.
Disabilita la strategia di aggiornamento automatico
C'è una coppia di strategie che puoi scegliere. Puoi imparare di più su di esse 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 otterrà la versione del bundle dal tuo package.json file (nella chiave versione).
Dopo che l'app Ionic ha installato una versione da Capgo, questa sarà la versione che verrà confrontata per:
- La loro versione del bundle JavaScript (1.2.3) è inferiore alla versione del bundle Capgo (1.2.4), Capgo invia il suo bundle all'utente.
Con alcune condizioni di guardia:
- Se la versione del bundle nativo è superiore a Capgo versione, la
Disable auto downgrade under nativecondizione è applicata. - Se la versione del bundle nativo è di un ordine maggiore inferiore a Capgo versione, la
Disable auto upgrade above majorcondizione è applicata.
Aggiornamento dell'app store
Quando pubblichi l'app Capacitor JS sul tuo App Store, ciò che accade è semplice.
Il tuo utente riceverà la nuova versione dallo store e rimuoverà tutte le aggiornamenti locali nell'applicazione di default.
Se desideri cambiare questo comportamento, devi impostare la impostazione resetWhenUpdate leggi di più su di essa qui
Questa può essere modificata solo sul lato dell'app, non come altri impostazioni da cloud.
Altre impostazioni
Dopo tutto questo comportamento, potete avere sopra alcune specifiche impostazioni legate al deviceID.
In Capgo, potete decidere di sovrascrivere il comportamento per ogni deviceID.
Puoi collegare un deviceID a:
- una versione bundle specifica
- un canale specifico
Questo supererà tutte le impostazioni fatte sopra.
Scopri di più in questo articolo.
