Capgo utilise 2 variables principales pour gérer les versions dans votre application Capacitor:
- Version native
- Versions JavaScript
Toutes les options de version 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 or check Capgo update compatibility with the 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
Sur 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 ou MARKETING_VERSION Sous la clé MARKETING_VERSION si Info.plist était définie dans votre
fichier.
Android android/app/build.gradle Sur Android, la variable est définie dans votre projet ici defaultConfig.versionName
JavaScript ( Capgo bundle version )
In JavaScript, la variable peut être définie dans votre package.json sous la clé version
Sinon, vous devez la fournir dans la commande de téléchargement.
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 ».
- La version du bundle natif (1.2.3) est MAJOR inférieure à la version du bundle Capgo (2.2.3), Capgo envoie « pas besoin de mettre à jour ».
Autres paramètres
Désactiver la mise à niveau automatique sous native
Si vous modifiez cette configuration en faux, Capgo considérera toujours comme la source fiable de la version. Ensuite, le comportement devient :
- La version native (1.2.4) est supérieure à la version Capgo (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 est la version que vous envoyez lors de la mise en œuvre
Si vous n'avez pas utilisé l'option npx @capgo/cli@latest bundle upload --channel production
La version du bundle JavaScript est la version que vous envoyez lors de la mise en œuvre --bundle 1.2.3Capgo obtiendra la version du bundle à partir de votre package.json Le fichier (dans la clé de version).
Après que votre application Ionic ait installé une version de Capgo, c'est cette version qui sera comparée pour :
- Leur version de bundle JavaScript (1.2.3) est inférieure à la version de bundle de Capgo (1.2.4), Capgo envoie donc son bundle à l'utilisateur.
Avec certaines conditions de garde :
- Si la version de bundle native est supérieure à la version de Capgo, la
Disable auto downgrade under nativecondition est appliquée. - Si la version de bundle native est MAJOR inférieure à la version de Capgo, la
Disable auto upgrade above majorcondition est appliquée.
Mise à jour de l'App Store
Lorsque vous publiez votre application JS Capacitor sur l'App Store, ce qui se passe est simple.
Votre utilisateur obtiendra la nouvelle version depuis l'App Store et supprimera toutes les mises à jour locales dans leur application par défaut.
Si vous souhaitez modifier ce comportement, vous devez configurer la configuration resetWhenUpdate en savoir plus à ce sujet ici
Cela ne peut être modifié que côté application, et non depuis le cloud comme les autres paramètres.
Autres paramètres
Après cela, vous pouvez avoir au-dessus de cela certains paramètres spécifiques liés à l'ID du dispositif.
Dans Capgo, vous pouvez décider de contourner le comportement pour chaque ID du dispositif.
Vous pouvez lier un ID du dispositif à :
- une version de bundle spécifique
- un canal spécifique
Cela contournera tous les paramètres effectués ci-dessus.
En savoir plus à ce sujet dans l'article ci-dessous.
Continuez à partir de Comment fonctionnent les versions dans Capgo
Si vous utilisez Comment fonctionnent les versions dans 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 de plugins d'entreprise Ionic pour le flux de travail du produit dans Alternatives de plugins d'entreprise Ionic, et Capgo Bâtiments natifs pour le flux de travail du produit dans Capgo Bâtiments natifs.