FAQ
Copiez un prompt de configuration avec les étapes d'installation et la guide markdown complète pour ce plugin.
Si vous avez des questions non répondues ici, veuillez demander ! Les deux, ouvrir un problème ou demander sur Discord travail.
Qu'est-ce que « code push » ?
Section intitulée “Qu’est-ce que “code push”?””Code push, également appelé « mises à jour en ligne » (OTA), est un service cloud qui permet aux développeurs de Capacitor de déployer des mises à jour dans leur application en production. Capgo fonctionne actuellement sur Android, iOS et Electron.
“Code Push” fait référence au nom d'une fonction de déploiement utilisée par la communauté React Native depuis Microsoft et Exponi l'un ni l'autre ne supportent Capacitor.
Doivent-ils les majors Capgo CLI correspondre à ma plugin ou Capacitor version?
Section intitulée “Doivent-ils les majors Capgo CLI correspondre à ma plugin ou Capacitor version?””Non. Utilisez toujours la dernière version de Capgo CLI (npx @capgo/cli@latestLe CLI et Capgo Console suivent leur propre versionnement et restent compatibles avec tout plugin de mise à jour majeur pris en charge. Les plugins Capgo suivent les majors Capacitor ; voir Capgo versioning pour les balises LTS telles que @lts-v7.
Quelle est la différence entre un bundle et une mise à jour ?
Section intitulée « Quelle est la différence entre un bundle et une mise à jour ? »Nous utilisons le terme « mise à jour » pour désigner la préparation d'un fichier binaire pour les magasins d'applications. Pour générer un bundle Capgo doit connaître le fichier binaire exact qui a été envoyé aux magasins d'applications.
Nous utilisons le terme « bundle » pour désigner une mise à jour qui peut être appliquée à une mise à jour pour la mettre à jour vers de nouvelles code. Le npx @capgo/cli@latest bundle upload La commande est utilisée pour générer un bundle à partir de votre nouveau code local qui est ensuite envoyé à vos utilisateurs.
Y a-t-il des limitations de chemins de fichiers pour les mises à jour Delta ?
Section intitulée « Y a-t-il des limitations de chemins de fichiers pour les mises à jour Delta ? »Oui :
- Fichiers de taille zéro : Les CLI journaux
Ignoring empty file...et exclut les fichiers vides du manifeste Delta. Il ne fait pas fail l'envoi, donc un fichier vide peut modifier le paquet résultant sans arrêter votre déploiement. N'incluez pas les fichiers de zéro octets dans les chemins de paquet Delta. - Chemins avec des espaces : Les téléchargements Delta échouent tôt avec un erreur claire lorsqu'un chemin de paquet contient un espace. Renommez les fichiers ou les dossiers pour supprimer les espaces avant de télécharger une mise à jour Delta.
Voir les mises à jour Delta pour les détails de configuration.
Quel est le plan de développement ?
Section intitulée « Quel est le plan de développement ? »Nos tableaux de bord de projet sont également publics et se trouvent à : https://github.com/orgs/Cap-go/projects
Notre équipe travaille également dans le public, vous pouvez donc voir ce que nous faisons en tout temps. Nous sommes heureux de répondre à toutes vos questions sur notre feuille de route ou nos priorités via les Github problèmes ou Discord.
Puis-je utiliser Capgo avec mon équipe?
Section titled “Can I use Capgo with my team?”Voir
Équipes pour plus d'informations. Le __CAPGO_KEEP_0__ stocke mes sources __CAPGO_KEEP_1__?
Lien direct vers Le Capgo stocke mes sources code?
Section titled “Does Capgo store my source code?”No. Les serveurs Capgo ne voient jamais votre source code. Lorsque vous exécutez npx @capgo/cli@latest bundle upload, Capgo stocke un fichier zip du code minifié/compilé - le même code que celui que recevrait un navigateur, et non votre source code.
Pour une sécurité supplémentaire, vous avez deux options :
- Chiffrement de bout en bout: Chiffrez votre bundle avant de l'envoyer pour le protéger en stockage et en transit et empêcher les tiers de générer des mises à jour chiffrées valides sans votre clé privée. Cela ne rend pas les actifs web déployés impossibles à décompiler car la clé publique est présente dans l'application distribuée.
- Chargement de l'URL externe: Stockez le bundle sur votre propre serveur et fournissez uniquement à Capgo le lien de téléchargement avec l'option
--external <url>
Voir également notre politique de confidentialité : https://capgo.app/privacy
Sont les fichiers de bundle des données privées ?
Section intitulée « Sont les fichiers de bundle des données privées ? »No. Les fichiers de bundle sont des actifs web publics destinés à être téléchargés par vos utilisateurs d'applications. N'importe qui qui connaît l'URL du bundle peut récupérer ces fichiers, et Capgo informe les utilisateurs de cela lors de la configuration et dans la documentation.
Accès aux fichiers de bundle n'est pas considéré comme une violation de données. N'insérez pas de secrets, de données de connexion, de données personnelles ou de données réglementées dans votre bundle d'applications. Si vous avez besoin d'une confidentialité plus forte pour des cas d'utilisation à haut niveau de sécurité, utilisez la cryptage de bout en bout, mais traitez toujours les applications et les actifs code expédiés comme publics d'un point de vue de la sécurité des rapports.
Peut-on utiliser Capgo à partir de notre système CI ?
Section intitulée « Peut-on utiliser Capgo à partir de notre système CI ? »Oui. Capgo est destiné à être utilisé à partir de systèmes CI. Nous avons publié un guide pour Android et Github Actions et contextiOS , et pourGitLab
N'hésitez pas à nous contacter si vous rencontrez des problèmes avec GitHub ou Discord.
Comment cela se rapporte-t-il à Firebase Remote Config ou Launch Darkly ?
Section intitulée « Comment cela se rapporte-t-il à Firebase Remote Config ou Launch Darkly ? »Code permet d'ajouter de nouveaux code / de remplacer code sur le dispositif. Firebase Remote Config et Launch Darkly sont tous deux des systèmes de configuration. Ils permettent de modifier la configuration de votre application sans avoir à envoyer une nouvelle version. Ils ne sont pas destinés à remplacer code.
Quel est l'empreinte de dépendance que cela ajoute ?
Section intitulée « Quel est l'empreinte de dépendance que cela ajoute ? »Je n'ai pas mesuré récemment, mais je pense que la bibliothèque de push code ajoute moins d'un mégabyte aux applications Capacitor. Nous connaissons des moyens de rendre cela plus petit lorsque cela devient une priorité. Si la taille constitue un obstacle pour vous, veuillez nous en informer !
Does Capgo work on the iOS 18.4 Simulator?
Section titled “Does Capgo work on the iOS 18.4 Simulator?”No. En raison d'un problème upstream affectant le simulateur iOS 18.4, Capgo ne fonctionne pas de manière fiable là-bas. Veuillez tester sur un appareil réel ou utiliser une version différente du simulateur iOS.
Voir les détails dans l'incident React Native : facebook/react-native#50510
Le code push fonctionne-t-il avec de grandes applications ?
Titre de la section « Le code push fonctionne-t-il avec de grandes applications ? »Oui. Il n'y a pas de limite de taille pour l'application qui peut être mise à jour avec le code push. Comme indiqué ci-dessous, le Capgo peut modifier n'importe quel code JS dans votre application, quel que soit la taille.
À noter : une taille plus grande rend-il plus difficile aux utilisateurs de télécharger les mises à jour. Nous recommandons de garder votre application aussi petite que possible.
Qu'est-ce que je peux utiliser le Capgo code push pour ?
Section intitulée « Qu'est-ce que je peux utiliser Capgo code pour envoyer ? »Nous avons vu diverses utilisations, notamment :
- Les corrections d'urgence pour les applications en production.
- La livraison de correctifs de bogues aux utilisateurs sur des versions plus anciennes de votre application.
- La livraison constante (par exemple, toutes les heures).
Notez que la plupart des magasins d'applications interdisent la livraison de code qui modifie le comportement de l'application d'une manière significative. Voir ci-dessous pour plus d'informations. Qu'est-ce qui compte comme un « MUA » pour __CAPGO_KEEP_0__ ?
Lien direct vers Qu'est-ce qui compte comme un « MUA » pour Capgo ?
Un MUA est un appareil actif mensuel. Un appareil distinct qui contacterait Capgo au cours d'une période de 30 jours roulante compte comme un MUA pour cette ID d'application native. Le même appareil physique utilisé avec deux ID d'application native distincts compte une fois pour chaque ID d'application ; il n'est pas dédupliqué entre eux.Section titled “Qu'est-ce que je peux utiliser Capgo __CAPGO_KEEP_1__ pour envoyer ?”
If vos saveurs diffèrent uniquement par leur couche web ou la mise à jour de routage, utilisez une ID d'application native unique avec canaux. Cela garde les saveurs sous une seule application Capgo et simplifie les publications. Utilisez des ID d'application natives séparés lorsque une saveur nécessite un ID de paquet distinct, une identité de signature, un ensemble d'entitlements ou une liste de magasin.
Sur iOS, v7.25.0+ garde l'ID de dispositif aléatoire, scoping de l'application, à travers les réinstallations normales en utilisant Keychain. Sur Android, utilisez v7.50.1+ ou v5.50.1+ et v6.50.1+ sur ces lignes de version); l'ID est restauré uniquement lorsque Android Backup/Restore retient les préférences de l'application. Désactiver la sauvegarde, exclure ces préférences ou effacer les données de l'application génère un nouvel ID de dispositif. Mettre à jour l'application ne crée pas un nouvel ID de dispositif.
Pour les builds de test et de développement, désactivez la livraison de développement et de l'émulateur sur les canaux de production. Cela contrôle la livraison, pas le MAU : un appareil peut toujours compter lorsqu'il contacte Capgo. Pour l'empêcher d'être utilisé en production, désactivez les mises à jour en direct et n'appellez pas les points de terminaison de production Capgo. Testez les builds natifs sans mises à jour en direct Voir les paramètres exacts.
Quoi que nous ne puissions pas utiliser Capgo code push pour ?
Section intitulée « Quoi que nous ne puissions pas utiliser Capgo code push pour ? »Capgo ne peut pas modifier les code natifs comme Java, Kotlin, Objective-C, Swift, les plugins natifs ou la configuration native. Ces changements nécessitent une nouvelle mise à jour de l'application native. Pour l'étendue de la revue de l'application, voir Politiques de l'App Store et de Google Play.
Puis-je mettre à jour capacitor.config.ts via Capgo ?
Section intitulée « Puis-je mettre à jour capacitor.config.ts via Capgo ? »Non. Règle courte : Capgo peut envoyer le dossier de build web généré, y compris HTML, CSS, JavaScript, actifs et modifications de packages pure-JavaScript bundlées dans cet output. Les changements à capacitor.config.tsconfiguration native plugin, installation ou mise à jour de package natif, et tout ce qui doit mettre à jour le projet iOS ou Android par le biais de npx cap sync ou npx cap copy ou bien il faut mettre à jour la configuration native, ou mettre à jour le package natif, ou mettre à jour le projet iOS ou Android par le biais de
The Capacitor configuration file is read at native build time and compiled into the native app binary. If you need to change your Capacitor configuration, you must:
- Le fichier de configuration __CAPGO_KEEP_0__ est lu à temps de construction native et compilé dans le fichier binaire de l'application native. Si vous avez besoin de changer votre __CAPGO_KEEP_1__ configuration, vous devez :
capacitor.config.tsMettre à jour - localement
npx cap syncReconstruire votre application native ( - suivi d'une construction native)
Does Capgo submit to the stores for me?
Lien direct vers Capgo soumet-il aux magasins pour moi ?Capgo Build peut compiler et signer un projet natif iOS ou Android préparé et, lorsqu'il est configuré, soumettre le résultat signé à App Store Connect ou Google Play. Vous pouvez conserver votre CI existant pour les dépendances privées, les builds web, Capacitor synchronisation, et la préparation native personnalisée ; Capgo reçoit le projet natif préparé pour l'étape de build natif.
Voir Capgo Build et la référence de la configuration de build pour les options de flux de travail et de soumission de magasin. Qu'est-ce que __CAPGO_KEEP_0__ stocke sur le disque dur et où ?
Lien direct vers Qu'est-ce que Capgo stocke sur le disque dur et où ?
L'actualiseur Capgo (inclus dans votre application lors de la construction de votre application) met en cache le dernier bundle téléchargé dans le seul répertoire qui __CAPGO_KEEP_1__ autorise à charger __CAPGO_KEEP_2__. Sur Android, cela se trouve dansThe Capgo updater (included in your application when you build your app) caches the latest downloaded bundle in the only directory that capacitor allow to load code. On Android, this is located in /data/user/0/com.example.app/code_cache/capgo_updater Les outils de ligne de commande __CAPGO_KEEP_0__ (par exemple, Library/Application Support/capgo.
Capgo npx @capgo/cli@latest bundle uploadLes fichiers sont stockés sur le disque en caches npm, vos identifiants de connexion sont stockés dans votre répertoire personnel dans ~/.capgo.
Comment cela se rapporte-t-il à la mise à niveau chaude Capacitor?
Sous-section intitulée « Comment cela se rapporte-t-il à la mise à niveau chaude Capacitor ? »La mise à niveau chaude de Capacitor est une fonctionnalité réservée au temps de développement. La mise à niveau Code est pour la production.
La mise à niveau chaude est une fonctionnalité de Capacitor qui vous permet de modifier code sur le périphérique pendant le développement. Cela nécessite la construction de l'application Capacitor avec un proxy pour se connecter à votre machine locale.
La mise à niveau Code est une fonctionnalité qui vous permet de modifier code sur le périphérique en production. Nous utiliserons une variété de techniques différentes pour rendre cela possible en fonction du système d'exploitation.
Quels types de modifications la mise à niveau Capgo code supporte-t-elle?
Sous-section intitulée « Quels types de modifications la mise à niveau Capgo code supporte-t-elle ? »Capgo can change any JS code in your application. This includes app code and generated code. You can also update dependencies in package.json tant qu'elles ne nécessitent pas de modifications natives code.
Nous n'avons pas l'intention de soutenir la modification de la code native (par exemple Java/Kotlin sur Android ou Objective-C/Swift sur iOS), et l'outil vous avertira si il détecte que vous avez modifié la code native car elle ne sera pas incluse dans le bundle.
Le support Web est-il disponible ?
Sous-titre « Le support Web est-il disponible ? »Code push n'est pas nécessaire pour le Web car le Web fonctionne déjà de cette manière. Lorsqu'un utilisateur ouvre une application Web, il télécharge la dernière version du serveur si nécessaire.
Si vous avez un cas d'utilisation pour code push avec le Web, nous aimerions en savoir plus !
Le support fonctionnera-t-il sur iOS, Android, Mac, Windows, Linux, etc.?
Sous-titre « Le support fonctionnera-t-il sur iOS, Android, Mac, Windows, Linux, etc.? »Oui.
Jusqu'à présent, nous nous sommes concentrés sur le support Android, iOS et Electron, et code push est prêt pour la production sur les trois.
Quels versions d'OS est-ce que Capgo supporte ?
Section intitulée « Quels versions d'OS Capgo supporte-t-elle ? »Capgo prend en charge les mêmes versions d'Android que Capacitor.
Capacitor prend actuellement en charge Android API niveau 22+ et iOS 13.0+ : https://capacitorjs.com/docs/main/reference/support-policy
Quelles versions de Capacitor supporte Capgo?
Section intitulée « Quelles versions de Capacitor supporte Capgo ? »Capgo prend actuellement en charge uniquement les versions de Capacitor les plus récentes et stables. Nous pourrions également prendre en charge des versions plus anciennes de Capacitor, mais nous n'avons pas encore mis en place l'infrastructure nécessaire pour maintenir cela à long terme. Nous comptons prendre en charge davantage de versions de Capacitor à l'avenir, y compris toute version pour nos clients entreprises. https://github.com/Cap-go/capgo/issues/1100
Capgo suit les versions stables de Capacitor et met à jour généralement dans les quelques heures qui suivent toute mise à jour stable. Notre système pour effectuer ces mises à jour est automatisé et prend quelques minutes à exécuter. Nous effectuons ensuite une vérification manuelle supplémentaire avant de publier sur nos serveurs.
Comment cela se rapporte-t-il au processus ou aux politiques de revue de l'App/Play Store ?
Section intitulée « Comment cela se rapporte-t-il au processus ou aux politiques de la boutique App/Play Store ? »Capgo ne transmet des modifications que vers la couche web Capacitor : le HTML, le CSS, le JavaScript et les actifs déjà exécutés dans la vue WebView de l'application. Il ne modifie pas le code natif, les plugins natifs, les permissions, les droits, la signature ou les métadonnées de la boutique.
Utilisez une mise à jour native pour chaque changement natif et pour les modifications matérielles qui pourraient affecter la finalité ou la fonctionnalité de l'application soumise et divulguée aux utilisateurs.
Le Capgo garantit-t-il une approbation de la boutique App Store ou Google Play ?
Section intitulée « Le Capgo garantit-t-il une approbation de la boutique App Store ou Google Play ? »Non. Apple et Google examinent chaque application et chaque mise à jour sur leurs propres faits, et le Capgo ne garantit pas une approbation individuelle ou un résultat de revue. Votre équipe reste responsable du contenu de l'application, des déclarations, de la portée des mises à jour et de la conformité aux politiques actuelles de la boutique.
Pour la planification de la revue et de la mise à jour, lisez les politiques officielles directement : Politiques de revue de la boutique App Store Apple et Politique de Google Play sur l'abus de dispositif et de réseau.
Puis-je utiliser Capgo dans mon pays?
Section intitulée “Puis-je utiliser Capgo dans mon pays?”Nous n'avons pas tenté de restreindre l'accès à Capgo à partir de tout pays.
Nous reconnaissons que certains pays ont des restrictions sur les URLs qui peuvent être accédées à partir du pays. Capgo utilise actuellement Cloud Cloudflare pour l'hébergement, y compris R2 Storage et les travailleurs Cloudflare.
Les URLs suivantes sont utilisées par Capgo:
- https://api.capgo.app — utilisé par les outils de ligne de commande pour interagir avec les serveurs __CAPGO_KEEP_0__ ainsi que l'actualiseur __CAPGO_KEEP_1__ sur les appareils des utilisateurs pour vérifier les mises à jour.
npx @capgo/clicommand line tools to interact with the Capgo servers as well as the Capgo updater on users’ devices to check for updates. - — utilisé par l'outil de ligne de commande pour télécharger et télécharger le paquet command line tools
npx @capgo/clicommand line tool
Si toutes ces adresses URL sont accessibles depuis votre pays, alors Capgo devrait fonctionner.
Si votre région nécessite de bloquer l'accès à l'une de ces adresses URL, veuillez nous le faire savoir et nous pouvons travailler avec vous pour trouver une solution. Les serveurs proxy sont une option.
Puis-je héberger moi-même Capgo ?
Section intitulée “Puis-je héberger moi-même Capgo ?”Oui. Enterprise prend en charge les déploiements auto-hébergés de Capgo sous licence lorsque vous devez exécuter l'arrière-plan de mise à jour dans votre propre infrastructure. Voir Mise à jour auto-hébergée pour le modèle de déploiement et les points de terminaison.
code nécessite-t-il l'internet pour fonctionner ?
Section intitulée “code nécessite-t-il l'internet pour fonctionner ?”Oui. On pourrait imaginer exécuter un serveur pour distribuer les mises à jour séparément de l'internet général, mais une certaine connectivité réseau est requise pour transporter les mises à jour vers les appareils.
How is Capgo affected by lack of network connectivity?
Section titled “How is Capgo affected by lack of network connectivity?”Capgo mise à jour (inclus dans votre application lorsque vous construisez votre application avec Capgo) est conçue pour être résistante aux problèmes de connectivité réseau.
Dans le comportement de mise à jour par défaut, lorsque l'application est lancée, elle alerte la mise à jour Capgo, qui démarre un thread séparé pour effectuer une requête réseau vers les serveurs de Capgo et demander une mise à jour. Nous utilisons intentionnellement un thread séparé pour éviter d'affecter tout autre chose que l'application puisse faire. Si la requête réseau échoue ou expire, la mise à jour essaiera simplement de vérifier à nouveau la prochaine fois que l'application est lancée.
Capgo outils de ligne de commande (par exemple, npx @capgo/cli@latest bundle upload) nécessitent une connectivité réseau pour fonctionner. Si vous utilisez Capgo pour distribuer votre application, vous devriez vous assurer que votre système CI a une connectivité réseau.
Qu'est-ce qui se passe si un utilisateur ne met pas à jour pendant longtemps et manque une mise à jour ?
Section intitulée “Qu'est-ce qui se passe si un utilisateur ne met pas à jour pendant longtemps et manque une mise à jour ?”Notre mise en œuvre envoie toujours une mise à jour spécifiquement conçue pour le dispositif qui la demande, mettant à jour le demandeur toujours à la dernière version disponible. Ainsi, si un utilisateur ne met pas à jour pendant un moment, il manquera les mises à jour intermédiaires.
Le serveur d'actualisation pourrait être modifié pour supporter la réponse avec la version incrémentale suivante ou la version la plus récente en fonction de vos besoins d'application. Veuillez nous faire savoir si les comportements d'actualisation alternatifs sont importants pour vous.
Comment Capgo se rapporte-t-il à Capacitor?
Section intitulée « Comment Capgo se rapporte-t-il à Capacitor ? »Capgo est un plugin pour Capacitor qui ajoute code de mise à jour. Capgo n'est pas une remplacement pour Capacitor. Vous pouvez continuer à utiliser les outils de Capacitor que vous connaissez et aimez.
Nous suivons la dernière version stable de Capacitor et mettons à jour notre plugin de mise à jour code pour qu'il fonctionne avec elle.
Quand se produisent les mises à jour?
Section intitulée « Quand se produisent les mises à jour ? »Par défaut, l'actualiseur Capgo vérifie les mises à jour lors du démarrage de l'application. Il fonctionne sur un thread de fond et ne bloque pas le thread de l'interface utilisateur. Les mises à jour seront installées pendant que l'utilisateur utilise l'application et seront appliquées la prochaine fois que l'application sera redémarrée.
Ce n'est pas également possible de lancer l'actualiseur Capgo manuellement à l'aide du @capgo/capacitor-updater package, à travers lequel il est possible de déclencher des mises à jour à tout moment, y compris via une notification de mise à jour.
Le Capgo metteur à jour est conçu de telle sorte que lorsque le réseau n'est pas disponible, ou le serveur est en panne ou inaccessible, l'application continuera à fonctionner normalement. Si vous décidez un jour de supprimer une mise à jour de nos serveurs, tous vos clients continueront à fonctionner normalement.
Nous avons ajouté la possibilité de revenir sur des correctifs. La chose la plus simple est de simplement attacher un bundle précédent à votre canal pour annuler.
Est-ce que j'ai besoin de garder mon app_id secret?
Section intitulée « Est-ce que j'ai besoin de garder mon app_id secret ? »Non. Le app_id est inclus dans votre application et est en sécurité pour être public. Vous pouvez le vérifier dans le contrôle de version (même publiquement) et ne vous soucier pas de quelqu'un d'autre qui l'accède.
Qui a votre app_id peut récupérer la dernière version de votre application à partir des serveurs Capgo, mais ils ne peuvent pas envoyer de mises à jour à votre application ou accéder à tout autre aspect de votre compte Capgo.
Quelle information est envoyée aux serveurs Capgo?
Section intitulée « Quelle information est envoyée aux serveurs Capgo ? »La liste complète de l'inventaire des données, le comportement des points de terminaison et les contrôles de confidentialité sont documentés dans Conformité.
Réglage statsUrl: '' pour désactiver les rapports de statistiques de mise à jour explicites. Vous pouvez également envoyer statsUrl à un proxy ou un point de terminaison que vous contrôlez ; voir gestion des statistiques dans l'infrastructure auto-hébergée. Les vérifications de mise à jour nécessitent toujours un identifiant de dispositif scoping d'application afin que Capgo puisse sélectionner la mise à jour correcte et mesurer les appareils actifs par mois.
La liste des sous-traitants est notre source de vérité publique à jour pour les fournisseurs, les emplacements de traitement, les mécanismes de transfert et l'historique des modifications.
Puis-je utiliser Capgo pour les applications HIPAA sensibles ?
Section intitulée « Puis-je utiliser Capgo pour les applications sensibles à HIPAA ? »Oui, mais votre propriétaire de la conformité doit choisir le bon modèle de déploiement. Capgo Cloud n'est pas actuellement présenté comme un processeur de statistiques hébergé conforme à HIPAA. Par défaut, les données de mise à jour sont scoping de l'appareil et ne sont pas liées à un utilisateur de l'application connu, et beaucoup d'équipes utilisent ce modèle avec succès.
Pour des examens plus stricts, vous pouvez localiser la circulation de trafic de plugin, désactiver les statistiques en définissant statsUrl à une chaîne vide, héberger uniquement l'endpoint de statistiques, ou utiliser l'hébergement autonome sous licence. N'appellez pas CapacitorUpdater.setCustomId(...) avec un adresse e-mail, un ID utilisateur, un ID patient, un ID employé ou toute valeur qui remap les données de télémétrie de mise à jour vers une personne.
Voir Conformité HIPAA pour la configuration technique complète et les compromis d'observabilité lorsque les statistiques sont désactivées.
Puis-je conserver les données de mise à jour Capgo en Europe ?
Section intitulée « Puis-je conserver les données de mise à jour Capgo en Europe ? »Oui. Les applications qui nécessitent une résidence des données de l'UE pour la circulation de trafic de plugin Capgo Cloud peuvent définir les endpoints de mise à jour sur l'hôte de l'UE :
updateUrl:https://plugin.eu.capgo.app/updatesstatsUrl:https://plugin.eu.capgo.app/statschannelUrl:https://plugin.eu.capgo.app/channel_self
Utilisez les trois URL de l'UE ensemble afin que les mises à jour, les statistiques et l'attribution automatique du canal utilisent la même voie de données régionale. Puisque ces valeurs vivent dans capacitor.config.tsles applications mobiles en production nécessitent une mise en production native avant que les installations existantes utilisent les nouveaux points de terminaison.
Voir L'emplacement des données for exact Capacitor and Electron examples.
Quels sont les plateformes prises en charge par Capgo ?
Sous-titre « Quels sont les plateformes prises en charge par Capgo ? »Actuellement, Capgo prend en charge Android, iOS et Electron. Toutes sont prêtes pour la production.
L'utilisation de Capgo pour iOS, Android ou Electron peut être une décision independante. Vous pouvez définir votre stratégie de canal pour Android et un fichier ipa construit pour l'App Store, ou les canaux Electron, selon vos besoins.
Capgo peut (relativement facilement) être adapté pour prendre en charge les cibles de bureau ou embarquées. Si cela est important pour vous, veuillez nous en informer.
Comment Capgo interagit-il avec les pistes de test de Play ou Apple TestFlight ?
Section intitulée “Comment Capgo interagit-il avec les pistes de test de Play ou Apple TestFlight ?”Chaque magasin d'applications a ses propres mécanismes pour distribuer les applications à des groupes d'utilisateurs limités (par exemple, « test interne », « bêta fermée », etc.). Ces mécanismes sont tous destinés à segmenter vos utilisateurs en groupes et à distribuer des versions spécifiques de vos applications à chaque groupe.
Malheureusement, ces mécanismes ne permettent pas tous aux tiers de détecter quand les applications sont installées dans une piste de test spécifique ou via TestFlight. Ainsi, nous n'avons pas de visibilité fiable sur la composition de ces groupes, et nous ne pouvons pas nous fier pour gérer l'accès aux correctifs de Capgo en fonction de ces groupes. https://stackoverflow.com/questions/53291007/can-an-android-application-identify-the-test-track-within-google-play https://stackoverflow.com/questions/26081543/how-to-tell-at-runtime-whether-an-ios-app-is-running-through-a-testflight-beta-i
Si vous souhaitez segmenter la disponibilité du paquet Capgo, il existe 4 options potentielles:
- Utilisez un canal séparé pour chaque groupe. C'est la méthode la plus directe, mais elle nécessite de gérer plusieurs canaux. Vous pouvez déjà avoir des canaux de développement et de production avec des disponibilités différentes. Vous pouvez ainsi mettre à jour vos canaux de développement, les vérifier et mettre ensuite à jour séparément vos canaux de production. Nous recommandons d'utiliser des branches / étiquettes dans votre contrôle de version pour aider à suivre les sources associées à chaque version.
- Suivez votre propre ensemble d'utilisateurs qui ont opté pour participer, désactivez les mises à jour automatiques et déclenchez les mises à jour uniquement pour certains utilisateurs via le
@capgo/capacitor-updaterCe fonctionne aujourd'hui, mais nécessite que vous gériesz votre propre liste d'opt-in. - Capgo permet de créer son propre mécanisme d'opt-in sur une base par appareil (de même que les pistes de test ou TestFlight, mais sans dépendre d'une plateforme spécifique). Cela permet à votre équipe de test de s'abonner à un bundle avant qu'il ne soit promu au public général.
- Utilisez les lancements progressifs pour livrer un candidat bundle à un sous-ensemble aléatoire et collant d'un canal. Définissez un lancement de 0 à 100 %, ou utilisez
--rollout-percentage-bpspour des increments de 0,01 % ; configurez la durée de cache de 60 secondes à 365 jours et une politique d'arrêt automatique facultative. Cela ne sélectionne pas un groupe de dispositifs nommé.
Facturation
Lien direct vers FacturationSous-section intitulée « Facturation »
Section intitulée « Comment puis-je mettre à jour ou réduire mon plan ? »Vous pouvez mettre à jour ou réduire votre plan à tout moment dans votre tableau de bord : https://console.capgo.app/settings/organization/plans
Quand se réinitialise mon période de facturation ?
Section intitulée « Quand se réinitialise mon période de facturation ? »Les périodes de facturation sont réinitialisées automatiquement chaque mois au mois où vous vous êtes abonné à Capgo. Par exemple, si vous vous êtes abonné le 15 du mois, votre période de facturation sera réinitialisée le 15 de chaque mois.
Comment puis-je annuler mon abonnement ?
Section intitulée « Comment puis-je annuler mon abonnement ? »Vous pouvez annuler votre abonnement à tout moment dans votre tableau de bord : https://console.capgo.app/settings/organization/plans
Puis-je payer pour une année à l'avance ?
Section intitulée “Puis-je payer pour une année à l'avance ?”Oui. Vous pouvez choisir un facturation annuelle dans vos paramètres de plan d'organisation Paramètres de plan d'organisation.
Qu'est-ce qui compte envers le stockage, et pouvons-nous modifier la rétention ?
Section intitulée “Qu'est-ce qui compte envers le stockage, et pouvons-nous modifier la rétention ?”Le stockage comprend les versions historiques retenues et leurs actifs Delta à travers vos canaux. Vous contrôlez la rétention des versions inutilisées pour chaque application dans les paramètres d'application. Les versions liées à un canal actif ou à un déploiement restent protégées afin de rester disponibles pour la livraison et le retrait.
La réplication régionale multiplie-t-elle le stockage ou la bande passante ?
Section intitulée “La réplication régionale multiplie-t-elle le stockage ou la bande passante ?”No. Un paquet est compté une seule fois pour le stockage, quel que soit les régions qui le servent. Le Capgo débit est basé sur les téléchargements de périphériques qui ne sont pas servis à partir du cache de bordure ; les livraisons servies par le cache ne comptent pas contre le débit Capgo.
Qu'est-ce que l'Enterprise SLA inclut ?
Section intitulée « Qu'est-ce que l'Enterprise SLA inclut ? »L'Enterprise inclut un engagement mensuel de disponibilité de 99,9 % pour la plateforme de production. Si cet engagement est manqué, le calendrier de crédit de service est de 10 % à 30 % en fonction de la disponibilité mensuelle. Les objectifs initiaux de réponse au support sont P1 : une heure, 24/7/365 ; P2 : deux heures de travail ; P3 : un jour de travail ; et P4 : deux jours de travail. Lisez le L'Enterprise SLA pour les termes complets.
Statistiques et analyses
Section intitulée « Statistiques et analyses »Les statistiques dans votre tableau de bord sont mises à jour chaque nuit UTC. Les statistiques sont calculées à partir de MAU distincts. MAU active pendant la période de 30 jours en cours.
Comment est généré l'ID de l'appareil.
Section intitulée « Comment est généré l'ID de l'appareil ».L'ID de l'appareil est généré sur l'appareil lors de la première exécution, et est utilisé pour éviter les doublons d'installation par appareil et nous permettre de facturer en fonction des utilisateurs installés (par exemple, utilisateurs actifs mensuels), plutôt que le nombre total de patchs ou d'installations de patchs.
Le nombre d'utilisateurs actifs par mois est une meilleure solution que le nombre d'installations pour facturer Capgo, car elle est plus précise et reflète le coût réel de Capgo par appareil.
Persistance de l'ID de l'appareil :
- iOS: À partir de la version 7.25.0+, l'ID de l'appareil est stocké dans Keychain et persiste lors des réinstallations normales.
- Android: Utilisez la version 7.50.1+ (ou 5.50.1+/6.50.1+ sur ces lignes de version). L'ID de l'appareil est restauré uniquement lorsque Android Backup/Restore conserve les préférences de l'application.
- ElectronLe numéro de l'appareil est stocké dans un stockage sécurisé.
- Alerte Android: La désactivation du sauvegarde, l'exclusion des préférences pertinentes ou la suppression des données de l'application génère un nouveau numéro de l'appareil. Les versions Android v7.25.0 à v7.50.0 peuvent générer un nouveau numéro de l'appareil après un réinstallé même lorsque la sauvegarde est activée.
Le numéro de l'appareil est scoping d'application et prend en charge la livraison à jour en direct et la déduplication MAU ; il ne s'agit pas d'un identifiant de publicité ou de suivi d'applications croisées.
Les numéros d'appareil sont listés après que l'application se connecte à Capgo via les points de terminaison de mise à jour ou de statistiques. Un appareil n'a pas besoin d'installer une mise à jour avant de pouvoir apparaître dans la liste des appareils.
Pourquoi mon numéro d'appareil est différent de mon MAU ?
Section intitulée « Pourquoi mon numéro d'appareil est différent de mon MAU ? »La liste des appareils et le MAU sont basés sur des signaux différents.
La liste des appareils affiche les métadonnées les plus récentes pour chaque appareil, telles que le numéro de l'appareil, le système d'exploitation, la version du plugin, la version du système d'exploitation, la version native, le canal, le bundle installé et le pays de demande lorsqu'il est disponible. Le pays de demande est le dernier code à deux lettres code valide reçu d'une Cloudflare-traitée pour cet appareil, et non la position GPS ou la localisation fournie par l'application. Les demandes sans un pays valide ne suppriment pas la dernière valeur valide. Capgo met à jour ces métadonnées lors de la connexion de l'application, mais les connexions répétées qui signalent les mêmes métadonnées peuvent ne pas modifier la ligne ou sa dernière heure de mise à jour.
Le nombre de MAU compte les appareils actifs distincts pendant la fenêtre de facturation. Cette activité peut augmenter même lorsque les métadonnées de l'appareil restent les mêmes, donc le nombre d'appareils et le MAU peuvent être différents.
Comment avoir des mises à jour différentes par plateforme ?
Section intitulée « Comment avoir des mises à jour différentes par plateforme ? »Vous pouvez créer un canal pour chaque plateforme et désactiver les mises à jour spécifiques à la plateforme dans chaque canal.
Sur le canal iOS, désactiver les mises à jour Android et sur le canal Android, désactiver les mises à jour iOS.
Ensuite, téléchargez un bundle dans chaque canal pour avoir des mises à jour différentes pour chaque plateforme.
Si vous avez besoin de mises à jour identiques pour les deux plateformes, vous pouvez lier un bundle à plusieurs canaux. Pas besoin de dupliquer le bundle.
Continuez de la même manière à partir de la FAQ.
Section intitulée « Continuez de la même manière à partir de la FAQ »Si vous utilisez FAQ (Questions fréquentes) - Contexte : Page/zone : Capgo Builder / produit de construction native cloud. Rôle : Sujet de section ou tagline. Vu dans : page native-build.astro. Clé de message `native_build_builder_faq_eyebrow` (FAQ Constructeur de native Build). | Page/zone : Page de marketing de solutions Capgo. Rôle : En-tête de section ou de page. Vu dans : page solutions/cordova-to-capacitor.astro. Clé de message `solutions_cordova_to_capacitor_faq_title` (FAQ Solutions Cordova To Capacitor). Mise en place de livraison d'actualisation en direct, connectez-le à Capgo Mises à jour en direct Mise en place du flux de travail du produit dans Capgo Mises à jour en direct, Vue d'ensemble Mise en place des détails d'implémentation dans Vue d'ensemble, Fonctionnalités Mise en place des détails d'implémentation dans Fonctionnalités, Comportement de mise à jour Mise en place des détails d'implémentation dans Comportement de mise à jour, et Types de mise à jour Mise en place des détails d'implémentation dans Types de mise à jour.