Overview

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éclenner l'envoi de l'archive sur Capgo en poussant des commits

4. Configurer et personnaliser la publication de l'archive 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 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 !

Guide d'Onboarding CLI

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

Envoyer des mises à jour

Envoyer des mises à jour à votre application à partir de la messagerie 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écapitulation

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

Conseil

La fonctionnalité d'actualisation en ligne (OTA) n'est applicable que pour les modifications apportées aux fichiers HTML, CSS et JavaScript.

Si vous apportez des modifications au native code, comme 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 Capgo l'encryption. Les canaux privés contrôlent lesquels appareils sont éligibles à recevoir une mise à jour, mais ils ne rendent pas le bundle téléchargé confidentiel. L'encryption protège le chemin de livraison et empêche les tiers de produire des mises à jour chiffrées valides, mais les actifs web embarqué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 L'encryption des mises à jour en direct.

Rejoignez la Communauté Discord

Rejoignez le serveur Discord de Capgo !

Maintenance

Version du plugin	Compatibilité de Capacitor	Maintenu
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 directives de magasin

Les magasins Android Google Play et iOS App Store ont des directives correspondantes qui comportent des règles auxquelles vous devriez 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 La section 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 restreinte. Mais cette restriction ne s'applique pas à la mise à jour des ensembles de scripts JavaScript.

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

Cela permet pleinement Capacitor-moteur de mise à jour car il met à jour uniquement les ensembles de scripts JavaScript et ne met pas à jour les code natifs.

App Store

Paragraphe 3.3.2Depuis 2015, l'accord de licence du programme Apple Developer permet pleinement d'effectuer des mises à jour en ligne sur les applications JavaScript et les ressources - 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 sur 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 à 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.

Capacitor Updater vous permet de suivre ces règles en toute conformité dans la mesure où la mise à jour 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 écran, puisque dans le Lignes directrices de la Revue de l'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 à la fonctionnalité, au 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, puisqu'il ne forcerait pas l'utilisateur à appliquer la nouvelle version avant 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.

Open source

Le plugin est sous licence LGPL-3.0 et le back-end 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 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 inquiéter

Notes finales

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

J'ai fait un pari pour rendre tous les code que j'ai construits ici en open-source au lieu de les mettre en paywall. En les ouvrant 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 de temps de développement perdues pour 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 depuis l'aperçu

Si vous utilisez Aperçu 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.