Aperçu

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 temps réel via Capgo

6. Déployer les mises à jour en temps réel à 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 serez opérationnel avec Capgo en un rien de temps !

CLI Guide de mise en route

Guide étape par étape complet pour le processus de mise en route interactive de CLI

Envoyer des mises à jour

Envoyer des mises à jour à votre application à partir de la console de bord de Capgo

Automatiser les mises à jour

Intégrer Capgo à votre CI/CD et déclencher les téléchargements de paquets 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

Tip

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

Si vous apportez des modifications au code natif 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 expédiés peuvent toujours être décompilés à partir de l'application avec suffisamment d'efforts car la clé publique est distribuée dans le binaire. Voir Mise à jour en direct cryptage.

Rejoignez la Communauté Discord

Rejoignez le serveur Discord de Capgo !

Maintenance

Version du plugin	Capacitor compatible avec	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 soutenu
v3.*.*	v3.*.*	❌ Plus soutenu
>= 8	v4.*.*	⚠️ Déprécié en raison de problèmes de versionnement dans notre processus CI

Conformité aux lignes directrices de l'entrepôt

Les plateformes Android Google Play et iOS App Store ont des directives 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 Le sujet 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 bundles JavaScript.

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

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

App Store

Paragraphe 3.3.2Depuis 2015, l'accord de licence Apple Developer Program permet pleinement de mettre à jour JavaScript et des ressources par le biais de mises à jour en ligne - et dans sa dernière version (20170605) téléchargeable ici cette décision 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 fonctionnalités qui sont incohérentes avec l'intention et l'annonce prévue de l'Application soumise sur l'App Store, (b) ne créent pas un magasin ou un point de vente pour d'autres code ou applications, et (c) ne contournent pas la signature, le sandbox ou d'autres fonctionnalités de sécurité du système d'exploitation.

Le Capacitor Updater vous permet de suivre ces règles dans une pleine conformité dans la mesure où la mise à jour que vous envoyez 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 recommandons aux applications distribuées par l'App Store de ne pas activer le Force update scénario, puisque dans le Lignes directrices de revue de l'App Store il est indiqué 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.

This is not a problème for the default behavior of background update, since it won’t force the user to apply the new version until next time they close the app, but at least you should be aware of that role if you decide to show it.

Logiciel libre

Le plugin est sous la Licence LGPL-3.0 et le back-end est sous la 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 libre 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 👇

Les licences ?

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

Vous pouvez l'inclure dans votre application sans vous inquiéter

Notes finales

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

J'ai fait un pari pour rendre tous les code que j'ai construits ici publics au lieu de les mettre behind paywall. En les rendant accessibles au lieu de les combattre et de les cacher, je pense que nous pouvons rendre le monde un endroit meilleur.

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

Mathématiques simples

Le prix du plan de base : 14 $ * 12 = 168 $ par an. Tandis que le coût moyen par heure = 60 $. Cela signifie que 3 heures perdues de temps de développement sur l'hébergement vous permettent de payer pour un an entier, si vous avez passé plus de 3 heures, vous perdez de l'argent ^^

Continuez de l'Overview

Si vous utilisez Overview pour planifier l'automatisation CI/CD, connectez-le avec Capgo CI/CD pour le flux de travail du produit dans Capgo CI/CD, Capgo Builds natifs pour le flux de travail du produit dans Capgo Builds natifs, Capgo Intégrations pour le flux de travail du produit dans Capgo Intégrations, Intégration CI/CD pour le détail d'implémentation dans Intégration CI/CD, et GitHub Intégration d'actions pour le détail d'implémentation dans GitHub Intégration d'actions.