Capgo utilise 2 variables principales pour gérer les versions dans votre application Capacitor:
- Versions natives
- Versions JavaScript
Toutes les versions sont décidées côté serveur par Capgo.
Système de versionnement
Pour gérer la version Capgo, utilisez le système SemVer. Lisez la Spécification SemVer ou vérifiez la compatibilité de mise à jour de Capgo avec le Testeur Semver.
Versions
Où Capgo trouver la version à comparer
Vous pouvez contourner ce comportement en définissant la clé de version dans
capacitor.config.jsonfichier docs ici La version native sera ignorée pour tous les plateformes.
IOS
Dans IOS, la variable est définie dans votre projet ici ios/App/App/Info.plist sous la cléCFBundleShortVersionString ou ios/App/App.xcodeproj/project.pbxproj sous la clé MARKETING_VERSION si MARKETING_VERSION était définie dans votre Info.plist fichier.
Android
Dans Android, la variable est définie dans votre projet ici android/app/build.gradle sous la clé defaultConfig.versionName
JavaScript ( Capgo version du bundle )
In JavaScript, la variable var peut être définie dans votre package.json sous la clé version
Sinon, vous devez la fournir dans la commande d'upload.
Comportement par défaut
C'est ainsi que le canal Capgo se comportera si vous n'avez pas modifié les paramètres.
Ce comportement sera basé sur le canal unique que vous avez défini par défaut.
Lors d'une installation fraîche de votre application Capacitor
Lorsque l'utilisateur télécharge votre application Ionic pour la première fois et ouvre l'application, elle contacte le serveur Capgo.
Actuellement, 4 résultats peuvent se produire :
- La version du bundle natif (1.2.3) est inférieure à la version du bundle Capgo (1.2.4), Capgo envoie le bundle à l'utilisateur.
- La version du bundle natif (1.2.3) est égale à la version du bundle Capgo (1.2.3), Capgo envoie « pas besoin de mettre à jour ».
- La version du bundle natif (1.2.4) est supérieure à la version du bundle Capgo (1.2.3), Capgo envoie « pas besoin de mettre à jour ».
- The version native bundle (1.2.3) is MAJOR lower than Capgo bundle version (2.2.3), Capgo send “no need to update”.
Autres paramètres
Désactiver la mise à niveau automatique sous native
Si vous modifiez cette configuration en faux, Capgo considérera toujours la source la plus fiable de la version. Ensuite, le comportement devient :
- La version native (1.2.4) est supérieure à Capgo version (1.2.3)
Capgo envoie sa version à l'utilisateur.
Désactiver la stratégie de mise à niveau automatique
Il existe plusieurs stratégies que vous pouvez choisir. Vous pouvez en savoir plus sur celles-ci ici
La version du bundle JavaScript
La version du bundle JavaScript est celle que vous envoyez lors de la réalisation de npx @capgo/cli@latest bundle upload --channel production
Si vous n'avez pas utilisé l'option --bundle 1.2.3Capgo obtiendra la version du bundle à partir de votre package.json Après l'installation d'une version de votre application Ionic, __CAPGO_KEEP_0__ est la version qui sera comparée pour :
La version de leur bundle JavaScript (1.2.3) est inférieure à la version de bundle de Capgo (1.2.4), __CAPGO_KEEP_1__ envoie leur bundle à l'utilisateur.
- Their JavaScript bundle version (1.2.3) is lower than Capgo bundle version (1.2.4), Capgo send his bundle to the user.
Si la version du bundle natif est supérieure à __CAPGO_KEEP_0__ version, la
- If native bundle version is higher than Capgo version, the
Disable auto downgrade under nativeSi la version du bundle natif est MAJOR inférieure à __CAPGO_KEEP_0__ version, la - If native bundle version is MAJOR lower than Capgo version, the
Disable auto upgrade above majorMise à jour de l'App Store
Lorsque vous publiez votre application __CAPGO_KEEP_0__ JS sur l'App Store, ce qui se passe est simple.
When you publish your Capacitor JS app on the App Store, what happens is simple.
__CAPGO_KEEP_1__
Si vous souhaitez modifier ce comportement, vous devez configurer la configuration resetWhenUpdate En savoir plus ici
Ce paramètre ne peut être modifié que côté application, et non depuis le cloud comme les autres paramètres.
Autres paramètres
Après avoir configuré ce comportement, vous pouvez avoir également des paramètres spécifiques liés à l'ID de l'appareil.
Dans Capgo, vous pouvez décider de contourner le comportement pour chaque ID de l'appareil.
Vous pouvez lier un ID de l'appareil à :
- une version de bundle spécifique
- un canal spécifique
Cela contournera tous les paramètres configurés ci-dessus.
En savoir plus sur cela dans l'article ci-dessous.
Continuez à partir de Comment fonctionne la version Capgo
Si vous utilisez Comment fonctionne la version Capgo pour planifier le travail de plugin natif, connectez-le à Capgo Répertoire de plugins pour le flux de travail du produit dans Capgo Répertoire de plugins, Capacitor Plugins par Capgo pour les détails d'implémentation dans Capacitor Plugins par Capgo, Ajouter ou Mettre à jour les plugins pour les détails d'implémentation dans Ajouter ou Mettre à jour les plugins, Alternatives aux plugins d'entreprise Ionic pour le flux de travail du produit dans Alternatives aux plugins d'entreprise Ionic, et Capgo Builds natifs pour le flux de travail du produit dans Capgo Builds natifs.
