Présentation

Le tutoriel de démarrage rapide vous guidera à travers les concepts clés de Capgo ! Des concepts qui seront explorés incluent :

1. Ajouter une application à votre compte Capgo

2. Intégrer Capgo à votre CI/CD

3. Déclencher l'envoi de la mise à jour du bundle sur Capgo en poussant des commits

4. Configurer et personnaliser la publication du bundle Capgo

5. Configurer votre application pour activer les mises à jour en direct via Capgo

6. Déployer les mises à jour en direct vers votre application à partir de Capgo

Suivez simplement le guide étape par étape, ou naviguez directement vers la documentation pour le composant qui vous intéresse.

Démarrer le Tutoriel

Suivez le tutoriel de démarrage rapide et vous mettrez en route avec Capgo en un rien de temps !

CLI Guide d'inscription

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

Envoyer des mises à jour

Envoyer des mises à jour à votre application depuis le tableau de bord Capgo.

Automatiser les mises à jour

Intégrer Capgo à votre CI/CD et déclencher les téléchargements de bundles sur Capgo en poussant des commits.

Résolution de problèmes

Problèmes courants et comment les résoudre.

Récapitulatif

Récapituler le tutoriel et obtenir un aperçu rapide de ce que vous avez appris.

Conseil

The mise à jour Over-the-Air (OTA) est applicable uniquement pour les modifications apportées aux fichiers HTML, CSS et JavaScript.

Si vous apportez des modifications à la couche native code, telles que des mises à jour des plugins Capacitor, il est obligatoire de ressoumettre l'application à l'app store pour approbation.

Confidentialité du Bundle

Traitez chaque bundle téléchargé sur Capgo comme un actif web public, à moins que vous activiez l'Capgo encryption. Les canaux privés contrôlent les appareils éligibles à recevoir une mise à jour, mais ils ne rendent pas le bundle téléchargé confidentiel. La cryptage protège le chemin de livraison et empêche les tiers de produire des mises à jour cryptées valides, mais les actifs web embarqués peuvent toujours être décompilés à partir de l'application avec suffisamment d'effort car la clé publique est distribuée dans le binaire. Voir Mise à jour en direct avec cryptage.

Rejoignez la Communauté Discord

Rejoignez le serveur Discord de Capgo !

Maintenance

Version du plugin	compatibilité Capacitor	Entretenu
v7.*.* (≥7.25.0)	v7.*.*	✅ Pleinement pris en charge
v6.*.* (≥6.25.0)	v6.*.*	✅ Pleinement pris en charge
v5.*.* (≥5.10.0)	v5.*.*	✅ Pleinement pris en charge
v5.*.* (<5.10.0)	v5.*.*	⚠️ Déprécié
v4.*.*	v4.*.*	❌ Plus supporté
v3.*.*	v3.*.*	❌ Plus supporté
>= 8	v4.*.*	⚠️ Déprécié en raison de problèmes de versionnement dans notre processus CI

Conformité aux lignes directrices de l'application Store

Les magasins Android Google Play et iOS ont des lignes directrices correspondantes qui comportent des règles auxquelles vous devez vous tenir avant d'intégrer la solution de mise à jour Capacitor dans votre application.

Google Play

Troisième paragraphe de Abus de dispositif et de réseau Ce paragraphe décrit que la mise à jour de la source code par tout moyen autre que le mécanisme de mise à jour de Google Play est restreint. Mais cette restriction ne s'applique pas à la mise à jour des ensembles de fichiers JavaScript.

Cette restriction ne s'applique pas à code qui fonctionne dans une machine virtuelle et a un accès limité aux API Android (comme JavaScript dans un navigateur web ou un navigateur).

Cela permet pleinement la mise à jour de Capacitor-updater car elle met à jour uniquement les ensembles de fichiers JavaScript et ne mettra pas à jour les code natifs.

Magasin d'App Store

Paragraphe 3.3.2Depuis 2015, cela Apple Developer Program License Agreement permet pleinement de mettre à jour par le biais de la connexion Internet les fichiers JavaScript et les ressources - et dans sa dernière version (20170605) téléchargeable ici ce jugement est même plus large :

Les code interprétés peuvent être téléchargés dans une Application mais uniquement dans la mesure où de telles code: (a) ne changent pas l'objectif principal de l'Application en fournissant des fonctionnalités ou des capacités qui sont incompatibles avec l'intention et l'annonce prévues de l'Application soumise sur l'App Store, (b) ne créent pas un magasin ou une vitrine pour d'autres code ou applications, et (c) ne contournent pas les fonctionnalités de signature, de sandbox ou de sécurité de l'OS.

L'Capacitor Updater vous permet de suivre ces règles dans une pleine conformité tant que l'actualisation que vous diffusez ne dévie pas significativement votre produit de son intention d'origine approuvée par l'App Store.

Pour rester davantage en conformité avec les lignes directrices d'Apple, nous vous recommandons que les applications distribuées par l'App Store ne permettent pas l' Force update scénario, car dans le Lignes directrices de la Revue d'App Store indiquent que :

Les applications ne doivent pas obliger les utilisateurs à évaluer l'application, à réviser l'application, à télécharger d'autres applications ou d'autres actions similaires pour accéder à des fonctionnalités, à du contenu ou à l'utilisation de l'application.

Ceci n'est pas un problème pour le comportement par défaut de mise à jour en arrière-plan, car il ne forcera pas l'utilisateur à appliquer la nouvelle version jusqu'à la prochaine fois qu'il fermera l'application, mais vous devriez au moins être conscient de ce rôle si vous décidez de le montrer.

Logiciel open source

Le plugin est sous licence LGPL-3.0 et l'arrière-plan est sous licence AGPL-3.0.

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

Licence ?

Essayez GPTS Capgo pour obtenir de l'aide au lieu de lire les documents

Vous pouvez l'inclure dans votre application sans vous soucier

Notes finales

Si vous hébergez vous-même et que vous trouvez cet outil utile, veuillez considérer le soutien de mon travail en devenant un GitHub sponsor.

J'ai fait un pari pour rendre tous les code que j'ai construits ici en logiciel open source au lieu de les mettre en paywall. En les ouvrant plutôt que de les combattre et de les cacher, je pense que nous pouvons rendre le monde un endroit meilleur.

To make this possible, it’s necessary for all of us to do our part, including you 🥹. If Capgo cloud doesn’t meet your needs, you can back a bootstrapped Maker Si votre fournisseur de nuage __CAPGO_KEEP_0__ ne répond pas à vos besoins, vous pouvez soutenir un créateur auto-suffisant ici

à vos propres conditions.

La section intitulée « Mathématiques élémentaires »