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 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 avec 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écapitulatif du tutoriel et obtenir un aperçu rapide de ce que vous avez appris.

Conseil

Le fonctionnement de mise à jour par le réseau (OTA) est applicable uniquement aux 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 l'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 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 expédié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 Chiffrage des mises à jour en temps réel.

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 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'application

Android Google Play et iOS App Store ont des lignes directrices 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 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 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 web ou un navigateur).

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

App Store

Paragraphe 3.3.2puisqu'en 2015, l'accord de licence du programme Apple Developer permet pleinement d'effectuer des mises à jour en ligne sans fil de JavaScript et de 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 incompatibles avec l'objectif et l'annonce prévus 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.

L'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 recommandons aux applications distribuées par l'App Store de ne pas activer la Force update scénario, car dans la 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 à la fonctionnalité, au contenu ou à l'utilisation de l'application.

Il ne s'agit pas d'un problème pour le comportement par défaut de mise à jour en arrière-plan, car il ne forcerait 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.

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 👇

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 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 de l'Overview

Si vous utilisez Résumé pour planifier l'automatisation CI/CD, connectez-le avec Capgo CI/CD pour le flux de travail du produit dans Capgo CI/CD, Capgo Bâtiments natifs pour le flux de travail du produit dans Capgo Bâtiments 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.