Aperçu

Ce tutoriel de démarrage rapide vous fera découvrir les concepts clés de Capgo ! Les concepts explorés incluent :

1. Ajouter une application à votre compte Capgo

2. Intégrer Capgo à votre CI/CD

3. Déclencher l'upload du bundle sur Capgo via des commits

4. Configurer et personnaliser la publication du bundle Capgo

5. Configurer votre application pour activer les live updates via Capgo

6. Déployer des live updates sur votre application depuis Capgo

Suivez simplement ce guide étape par étape, ou accédez directement à la documentation du composant qui vous intéresse.

Lancer le tutoriel

Suivez le tutoriel de démarrage rapide et soyez opérationnel avec Capgo en un rien de temps !

Guide d'onboarding CLI

Guide complet étape par étape pour le processus d'onboarding interactif de CLI.

Déployer des mises à jour

Déployez des mises à jour sur votre application depuis le dashboard Capgo.

Automatiser les mises à jour

Intégrez Capgo à votre CI/CD et déclenchez l'upload de bundles sur Capgo en poussant vos commits.

Trouble Shooting

Problèmes courants et comment les résoudre.

Conclusion

Terminez le tutoriel avec un aperçu rapide de ce que vous avez appris.

Astuce

La fonctionnalité de mise à jour OTA s'applique uniquement aux modifications apportées aux fichiers HTML, CSS et JavaScript.

Si vous modifiez le code natif, comme la mise à jour de plugins Capacitor, vous devez impérativement soumettre l'application au store pour approbation.

Confidentialité des bundles

Considérez chaque bundle envoyé sur Capgo comme un asset web public, à moins d'activer le chiffrement Capgo. Les canaux privés contrôlent quels appareils sont éligibles pour recevoir une mise à jour, mais ils ne rendent pas le bundle envoyé confidentiel. Le chiffrement protège le chemin de livraison et empêche des tiers de produire des mises à jour chiffrées valides, mais les assets web livrés peuvent toujours être rétro-conçus à partir de l'app avec suffisamment d'efforts, car la clé publique est distribuée dans le binaire. Voir le chiffrement Live Update.

Rejoindre la communauté Discord

Rejoignez le serveur Discord de Capgo !

Maintenance

Version du plugin	Compatibilité Capacitor	Maintenu
v7.*.* (≥7.25.0)	v7.*.*	✅ Entièrement pris en charge
v6.*.* (≥6.25.0)	v6.*.*	✅ Entièrement pris en charge
v5.*.* (≥5.10.0)	v5.*.*	✅ Entièrement pris en charge
v5.*.* (<5.10.0)	v5.*.*	⚠️ Obsolète
v4.*.*	v4.*.*	❌ Plus supporté
v3.*.*	v3.*.*	❌ Plus supporté
>= 8	v4.*.*	⚠️ Obsolète en raison de problèmes de versionnage dans notre processus CI

Conformité aux directives des stores

Google Play sur Android et l'App Store sur iOS ont des directives spécifiques avec des règles dont vous devez avoir connaissance avant d'intégrer la solution Capacitor-updater dans votre application.

Google Play

Troisième paragraphe de Abus de l'appareil et du réseau le sujet indique que la mise à jour de la source code par tout autre moyen que le mécanisme de mise à jour de Google Play est restreinte. Cependant, cette restriction ne s'applique pas à la mise à jour des bundles JavaScript.

Cette restriction ne s'applique pas à code qui s'exécute dans une machine virtuelle et dispose d'un accès limité aux API Android (comme le JavaScript dans une webview ou un navigateur).

Cela permet pleinement l'utilisation de Capacitor-updater, car il ne met à jour que les bundles JS sans modifier le code natif.

App Store

Paragraphe 3.3.2, since back in 2015’s Contrat de licence Apple Developer Program autorise pleinement les mises à jour over-the-air de JavaScript et des assets - et dans sa dernière version (20170605) téléchargeable ici cette décision est encore plus large :

Le code interprété peut être téléchargé dans une application, mais uniquement tant que ce code : (a) ne modifie pas l'objectif principal de l'application en proposant des fonctionnalités incompatibles avec la finalité prévue et annoncée de l'application telle que soumise à l'App Store, (b) ne crée pas de store ni de vitrine pour d'autres code ou applications, et (c) ne contourne pas la signature, le sandbox ou d'autres fonctions de sécurité de l'OS.

Capacitor Updater vous permet de respecter pleinement ces règles, tant que la mise à jour que vous déployez n'éloigne pas significativement votre produit de sa finalité initiale approuvée par l'App Store.

Pour rester en conformité avec les directives d'Apple, nous suggérons que les apps distribuées sur l'App Store n'activent pas le Force update scénario, car dans le Directives de révision de l'App Store indiquent que :

Les apps ne doivent pas obliger les utilisateurs à noter l'app, à laisser un avis sur l'app, à télécharger d'autres apps ou à effectuer d'autres actions similaires pour accéder aux fonctionnalités ou au contenu de l'app, ou pour l'utiliser.

Cela ne pose pas de problème avec le comportement par défaut de la mise à jour en arrière-plan, car elle ne forcera pas l'utilisateur à appliquer la nouvelle version avant la prochaine fermeture de l'app, mais vous devez au moins garder ce rôl’en tête si vous décidez de l'afficher.

Open source

Le plugin est sous licence LGPL-3.0 et le back-end est sous licence AGPL-3.0.

💡 La licence LGPL-3.0 signifie que si quelqu'un modifie le code du plugin, il est obligatoire de le publier en open source avec la même licence. Si vous utilisez le code sans modification, cela ne vous concerne pas. Voir le ticket ci-dessous pour plus de détails via le lien 👇

Licence ?

Essayez GPTS Capgo pour obtenir de l'aide au lieu de lire la doc

Vous pouvez l'inclure dans votre app sans crainte

Notes finales

Si vous auto-hébergez cet outil et qu'il vous est utile, merci de soutenir mon travail en devenant un sponsor GitHub.

J'ai fait le pari de passer en open source tous les code que j'ai développés ici plutôt que de les mettre derrière un paywall. En ouvrant l'accès plutôt qu'en luttant ou en cachant, je pense que nous pouvons rendre le monde meilleur.

Pour rendre cela possible, il est nécessaire que nous fassions tous notre part, y compris vous 🥹. Si le cloud Capgo ne répond pas à vos besoins, vous pouvez soutenir un créateur en bootstrap sur GitHub Sponsors selon vos propres conditions.

Maths simples

Le prix du plan basic : 14 $ * 12 = 168 $ par an. Alors que le tarif moyen d'un dev/heure = 60 $. Cela signifie que 3 heures de temps de dev perdues sur du self-host permettent de payer une année entière ; si vous passez plus de 3 heures, vous perdez de l'argent ^^

Continuer depuis la vue d'ensemble

Si vous utilisez Aperçu pour planifier l'automatisation CI/CD, le relier à CI/CD Capgo pour le workflow produit dans le CI/CD de Capgo, Capgo Native Build pour le workflow produit dans les Capgo Native Builds, Intégrations Capgo pour le workflow produit dans les intégrations Capgo, Intégration CI/CD pour les détails d'implémentation de l'intégration CI/CD, et Intégration GitHub Actions pour les détails d'implémentation de l'intégration GitHub Actions.