Aperçu

Ce tutoriel de démarrage rapide vous fera découvrir les concepts clés de Capgo ! Les concepts abordé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 en poussant 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 le guide étape par étape, ou accédez directement à la documentation du composant qui vous intéresse.

Commencer le tutoriel

Suivez le tutoriel de démarrage rapide et mettez Capgo en place en un rien de temps !

Guide d'onboarding CLI

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

Publier des mises à jour

Déployez des mises à jour de 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, par exemple en mettant à jour des plugins Capacitor, vous devez impérativement soumettre à nouveau l'application au store pour validation.

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 déterminent quels appareils peuvent recevoir une mise à jour, mais ils ne rendent pas le bundle envoyé confidentiel. Le chiffrement protège le canal de livraison et empêche des tiers de produire des mises à jour chiffrées valides, mais les assets web livrés peuvent toujours être reverse-engineerés depuis l'app avec suffisamment d'efforts, car la clé publique est distribuée dans le binaire. Voir 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.*.*	❌ N'est plus pris en charge
v3.*.*	v3.*.*	❌ N'est plus pris en charge
>= 8	v4.*.*	⚠️ Obsolète à cause de problèmes de versionnage dans notre pipeline CI

Conformité aux directives des stores

Google Play sur Android et l'App Store sur iOS ont leurs propres directives, dont les règles sont à connaître avant d'intégrer la solution Capacitor-updater dans votre application.

Google Play

Troisième paragraphe de Abus liés à l'appareil et au réseau le sujet précise que la mise à jour de la source code par un autre moyen que le mécanisme de mise à jour de Google Play est restreinte. En revanche, 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 l’objectif prévu et annoncé de l’application telle que soumise à l’App Store, (b) ne crée pas de store ni de storefront pour d’autres code ou applications, et (c) ne contourne pas la signature, le sandbox ou d’autres mécanismes de sécurité du système d’exploitation.

Capacitor Updater vous permet de respecter pleinement ces règles, à condition que la mise à jour que vous publiez ne s'écarte pas significativement de l'intention d'origine approuvée par l'App Store.

Pour rester en conformité avec les directives d'Apple, nous recommandons que les applications distribuées via l'App Store n'activent pas le Force update scénario, car dans l' Directives d'examen de l'App Store état :

Apps must not force users to rate the app, review the app, download other apps, or other similar actions in order to access functionality, content, or use of the app.

Ce n'est pas un problème pour le comportement par défaut de la mise à jour en arrière-plan, car elle n'obligera pas l'utilisateur à appliquer la nouvelle version avant la prochaine fermeture de l'application, mais vous devez au moins en être conscient si vous décidez de l'afficher.

Open source

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

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

Licence ?

Essayez GPTS Capgo pour obtenir de l’aide plutôt que de lire la doc

Vous pouvez l’intégrer à votre application sans crainte

Notes finales

Si vous auto-hébergez et que cet outil vous est utile, pensez à soutenir mon travail en devenant sponsor GitHub.

J'ai fait le pari de passer en open source tout le code que j'ai construit ici plutôt que de le mettre derrière un paywall. En ouvrant au lieu de me battre et de cacher, je crois qu'on peut rendre le monde meilleur.

Pour rendre cela possible, il faut que nous fassions tous notre part, y compris vous 🥹. Si le cloud Capgo ne répond pas à vos besoins, vous pouvez soutenir un maker bootstrappé sur GitHub Sponsors à vos conditions.

Calcul simple

Le prix du plan de base : 14 $ × 12 = 168 $ par an. Sachant qu'une heure de dev coûte en moyenne 60 $. 3 heures de dev perdues sur du self-host suffisent donc à payer une année entière ; au-delà, vous perdez de l'argent ^^

Continuer depuis l'aperçu

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