Aller au contenu

FAQ

Si vous avez des questions non traitées ici, n’hésitez pas à poser ! Ouvrir un issue ou demander sur Discord fonctionne.

Code push, également appelé « mises à jour OTA » (over-the-air), est un service cloud permettant aux développeurs Capacitor de déployer des mises à jour sur leurs apps en production. Capgo fonctionne actuellement sur Android, iOS et Electron.

« Code Push » fait référence au nom d’une fonctionnalité de déploiement utilisée par la communauté React Native depuis Microsoft et Expo, dont aucun ne supporte Capacitor.

Do Capgo CLI majors need to match my plugin or Capacitor version?

Section titled “Do Capgo CLI majors need to match my plugin or Capacitor version?”

No. Always use the latest Capgo CLI (npx @capgo/cli@latest). Les consoles CLI et Capgo suivent leur propre versioning et restent compatibles avec toutes les versions majeures des plugins updater supportés. Les plugins Capgo suivent Capacitor versions majeures ; voir le versionnement Capgo pour les tags LTS tels que @lts-v7.

Quelle est la différence entre un bundle et une release ?

Section intitulée « Quelle est la différence entre un bundle et une release ? »

Nous utilisons le terme « release » pour désigner la préparation d'un binaire pour les stores. Pour pouvoir générer un bundle plus tard, Capgo doit connaître le binaire exact qui a été publié sur les stores.

Nous utilisons le terme « bundle » pour désigner un patch pouvant être appliqué à une release afin de la mettre à jour vers de nouveaux code. npx @capgo/cli@latest bundle upload La commande sert à générer un bundle à partir de votre nouveau code local, qui est ensuite déployé auprès de vos utilisateurs.

Are there Delta update file-path limitations?

Section titled “Are there Delta update file-path limitations?”

Oui :

  • Fichiers de taille nulle : Les logs CLI Ignoring empty file... et exclut les fichiers vides des fichiers delta. L’upload ne rate pas, donc un fichier vide peut modifier le bundle résultant sans interrompre votre déploiement. N’incluez pas de fichiers de taille nulle dans les chemins des bundles Delta.
  • Chemins contenant des espaces : Les uploads Delta échouent rapidement avec une erreur claire si un chemin de bundle contient un espace. Renommez les fichiers ou les répertoires pour supprimer les espaces avant d’uploader une mise à jour Delta.

Consultez Mises à jour delta pour les détails de configuration.

Nos tableaux de projet sont également publics et disponibles ici : https://github.com/orgs/Cap-go/projects

Notre équipe travaille aussi en public, vous pouvez donc voir sur quoi nous travaillons à tout moment. Nous serons ravis de répondre à vos questions sur notre roadmap ou nos priorités via les issues Github ou Discord.

Yes! All plans support unlimited developers. We only limit app metrics (MAU, storage and bandwidth) to each organization.

Consultez Équipes pour plus d’informations.

Est-ce que Capgo stocke mon code source ?

Section intitulée « Capgo stocke-t-il mon code source ? »

Non. Les serveurs de Capgo ne voient jamais votre code source. Lorsque vous exécutez npx @capgo/cli@latest bundle upload, Capgo stocke un fichier zip du code minifié/compilé - le même code qu'un navigateur recevrait, et non votre code source.

Pour une sécurité supplémentaire, vous avez deux options :

  • Chiffrement de bout en bout: Chiffrez votre bundle avant l’upload pour le protéger au repos et en transit, et empêcher des tiers de générer des mises à jour chiffrées valides sans votre clé privée. Cela ne rend pas les assets web livrés impossibles à rétro-ingénier, car la clé publique est présente dans l’app distribuée.
  • Upload via URL externe: Stockez le bundle sur votre propre serveur et fournissez à Capgo uniquement le lien de téléchargement avec l’option --external <url>

Voir aussi notre politique de confidentialité : https://capgo.app/privacy

Les fichiers de bundle sont-ils des données privées ?

Section titled “Are bundle files private data?”

Non. Les fichiers bundle sont des assets web publics destinés à être téléchargés par vos utilisateurs. Quiconque connaît l’URL du bundle peut récupérer ces fichiers, et Capgo en informe les utilisateurs lors de la configuration et dans la documentation.

L’accès aux fichiers bundle n’est pas considéré comme une violation de données. N’incluez pas de secrets, d’identifiants, de données personnelles ou de données réglementées dans votre bundle d’app. Si vous avez besoin d’une confidentialité accrue pour des cas d’usage à forte sécurité, utilisez le chiffrement de bout en bout, mais traitez toujours les code et les assets de l’app livrée comme publics d’un point de vue signalement de sécurité.

Oui. Capgo est conçu pour être utilisé depuis des systèmes CI. Nous avons publié un guide pour Android et Github Actions et iOS, ainsi que pour GitLab. Les autres systèmes CI devraient être similaires.

N’hésitez pas à nous contacter via les issues GitHub ou Discord si vous rencontrez des problèmes.

Code push permet d’ajouter de nouveaux code / de remplacer des code sur l’appareil. Firebase Remote Config et Launch Darkly sont tous deux des systèmes de configuration. Ils vous permettent de modifier la configuration de votre application sans avoir à déployer une nouvelle version. Ils ne sont pas conçus pour remplacer code.

Quelle empreinte de dépendances cela ajoute-t-il ?

Section intitulée « Quel poids en dépendances cela ajoute-t-il ? »

Je n'ai pas mesuré récemment, mais je pense que la bibliothèque push code ajoute moins d'un mégaoctet aux apps Capacitor. Nous avons des pistes pour réduire ça quand ce sera une priorité. Si la taille est un blocage pour vous, dites-le-nous !

Est-ce que Capgo fonctionne sur le simulateur iOS 18.4 ?

Section intitulée « Est-ce que Capgo fonctionne sur le simulateur iOS 18.4 ? »

Non. En raison d'un problème en amont sur le simulateur iOS 18.4, Capgo ne s'y exécute pas de manière fiable. Testez plutôt sur un appareil réel ou utilisez une autre version du simulateur iOS.

Voir les détails dans l'issue React Native : facebook/react-native#50510

Est-ce que le push code fonctionne avec de grosses applications ?

Section intitulée « Est-ce que le push code fonctionne avec de grosses applications ? »

Oui. Il n’y a pas de limite de taille pour l’application mise à jour via code push. Comme indiqué ci-dessous, Capgo peut modifier n’importe quel code JS de votre application, quelle que soit sa taille.

To note: A bigger size make it harder for users to download updates. We recommend keeping your app as small as possible.

À quoi peut me servir le push code de Capgo ?

Section intitulée « Que puis-je faire avec Capgo code push ? »

Nous avons observé une variété d’utilisations, notamment :

  • Corrections d’urgence sur les apps en production.
  • Déployer des correctifs aux utilisateurs des anciennes versions de votre application.
  • Déploiement constant (par ex. chaque heure).

Notez que la plupart des stores d’applications interdisent de déployer des code qui modifient de manière significative le comportement de l’application. Voir ci-dessous pour plus d’informations.

Qu'est-ce qui compte comme « MAU » pour Capgo ?

Section intitulée « Qu’est-ce qui compte comme MAU pour Capgo ? »

Un MAU est un appareil actif mensuel. Un appareil distinct qui contacte Capgo au cours d’une période glissante de 30 jours compte pour un MAU pour cet ID d’application native. Le même appareil physique utilisé avec deux ID d’application native distincts compte une fois pour chaque ID ; il n’est pas dédupliqué entre eux.

Si vos flavors ne diffèrent que par leur couche web ou leur routage des mises à jour, utilisez un seul ID d’application native avec canaux. Cela permet de regrouper les variantes sous une seule application Capgo et de simplifier les releases. Utilisez des ID d’application native distincts si une variante nécessite un bundle ID, une identité de signature, un ensemble d’entitlements ou une fiche store différente.

Sur iOS, v7.25.0+ conserve l’identifiant d’appareil aléatoire et spécifique à l’application lors des réinstallations normales via Keychain. Sur Android, utilisez v7.50.1+ (ou v5.50.1+ et v6.50.1+ sur ces lignes de release) ; l'ID n'est restauré que si Android Backup/Restore conserve les préférences de l'app. Désactiver la sauvegarde, exclure ces préférences ou effacer les données de l'app génère un nouvel ID d'appareil. Mettre à jour l'app ne crée pas de nouvel ID d'appareil.

Pour les builds de test et de développement, désactivez la livraison des builds de développement et des émulateurs sur les canaux de production. Cela pilote la livraison, pas les MAU : un appareil peut quand même être comptabilisé lorsqu'il contacte Capgo. Pour l'exclure de l'usage en production, désactivez les live updates et n'appelez pas les endpoints Capgo de production. Voir Tester les Native Builds sans live updates pour les paramètres exacts.

Capgo ne peut pas modifier le code natif comme Java, Kotlin, Objective-C, Swift, les plugins natifs ou la configuration native. Ces changements nécessitent une nouvelle release de l'app native. Pour le périmètre de la revue des stores, consultez les politiques de l'App Store et de Google Play.

Puis-je déployer des modifications de capacitor.config.ts via Capgo ?

Section intitulée « Puis-je appliquer des modifications à capacitor.config.ts via Capgo ? »

Non. Règle simple : Capgo peut envoyer le dossier du web build généré, incluant le HTML, le CSS, le JavaScript, les assets et les modifications de packages pure JavaScript intégrées à ce build. Les changements de capacitor.config.ts, la configuration de plugins natifs, l'installation ou la mise à jour de packages natifs, et tout ce qui nécessite une modification du projet iOS ou Android via npx cap sync ou npx cap copy nécessitent une release de l'app native.

Le fichier de configuration Capacitor est lu au moment du build natif et compilé dans le binaire de l'app native. Si vous devez modifier votre configuration Capacitor, vous devez :

  1. Mise à jour capacitor.config.ts localement
  2. Recompiler votre application native (npx cap sync suivi d’un build natif)
  3. Soumettre le nouveau binaire aux stores

Est-ce que Capgo soumet mon app aux stores à ma place ?

Section intitulée « Capgo soumet-il aux stores à ma place ? »

Capgo Build peut compiler et signer un projet natif iOS ou Android préparé et, s’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, la synchronisation Capacitor et la préparation native personnalisée ; Capgo reçoit le projet natif préparé pour l’étape de build natif.

Consultez Build Capgo et le référence de configuration de build pour les options de workflow et de publication sur les stores.

L'updater Capgo (inclus dans votre application lors du build) met en cache le dernier bundle téléchargé dans le seul répertoire depuis lequel capacitor autorise le chargement de code. Sur Android, il se trouve dans /data/user/0/com.example.app/code_cache/capgo_updater bien que la base de ce chemin soit fournie par le système Android et puisse changer dynamiquement à l'exécution. Sur les appareils iOS, les données sont stockées sous Library/Application Support/capgo.

Les outils en ligne de commande Capgo (ex. npx @capgo/cli@latest bundle upload) sont installés sur le disque dans les caches npm, vos identifiants sont stockés dans votre répertoire personnel dans ~/.capgo.

Le Hot reload de Capacitor est une fonctionnalité réservée au développement. Le push Code est destiné à la production.

Le Hot Reload est une fonctionnalité de Capacitor qui vous permet de modifier code sur l'appareil pendant le développement. Cela nécessite de compiler l'application Capacitor avec un proxy pour se connecter à votre machine locale.

Le push Code est une fonctionnalité qui vous permet de modifier code sur l'appareil en production. Nous utiliserons diverses techniques pour y parvenir selon la plateforme.

Quels types de changements les push code de Capgo prennent-ils en charge ?

Section intitulée « Quels types de changements le push code de Capgo prend-il en charge ? »

Capgo peut modifier n'importe quel code JS dans votre application. Cela inclut le code de l'app et les code générés. Vous pouvez aussi mettre à jour les dépendances dans package.json tant qu'elles ne nécessitent pas de modifications du code natif.

Nous ne prévoyons pas de prendre en charge la modification du code natif (par ex. Java/Kotlin sur Android ou Objective-C/Swift sur iOS), et l'outil vous avertira s'il détecte un changement de code natif, car il ne sera pas inclus dans le bundle.

Est-ce que cela fonctionne sur le Web ?

Section intitulée « Prend-il en charge le Web ? »

Le push Code n'est pas nécessaire pour le web car le web fonctionne déjà ainsi. Lorsqu'un utilisateur ouvre une app web, elle télécharge la dernière version depuis le serveur si nécessaire.

Si vous avez un cas d'usage pour code push avec le web, nous serions ravis de le savoir !

Cela fonctionnera-t-il sur iOS, Android, Mac, Windows, Linux, etc. ?

Section intitulée « Est-ce que cela fonctionne sur iOS, Android, Mac, Windows, Linux, etc. ? »

Oui.

Jusqu’ici, nous nous sommes concentrés sur le support d’Android, d’iOS et d’Electron, et le push code est prêt pour la production sur les trois.

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 sont prises en charge par Capgo ?

Section intitulée « Quelles versions de Capacitor Capgo prend-il en charge ? »

Capgo prend actuellement en charge uniquement les releases stables récentes de Capacitor. Nous pourrions aussi prendre en charge d’anciennes versions de Capacitor, mais nous n’avons pas encore mis en place l’infrastructure nécessaire pour les maintenir dans le temps. Nous prévoyons de prendre en charge davantage de versions de Capacitor à l’avenir, y compris toutes les versions pour nos clients enterprise. https://github.com/Cap-go/capgo/issues/1100

Capgo suit les versions stables de Capacitor et se met généralement à jour dans les heures qui suivent toute release stable. Notre système d’automatisation de ces mises à jour prend quelques minutes à s’exécuter. Nous effectuons ensuite une étape de vérification manuelle supplémentaire avant de publier sur nos serveurs.

Quel est le lien avec le processus de révision ou les politiques de l'App Store/Play Store ?

Section intitulée « En quoi cela concerne-t-il le processus ou les politiques de revue de l’App/Play Store ? »

Capgo ne livre des modifications que dans la couche web Capacitor : le HTML, le CSS, le JavaScript et les assets déjà exécutés dans le WebView de l’application. Il ne modifie pas le binaire natif, les plugins natifs, les permissions, les entitlements, la signature ni les métadonnées du store.

Utilisez une release native du store pour chaque modification native et pour les changements substantiels susceptibles d’affecter le but ou la fonctionnalité de l’application tels que déclarés lors de la revue. Limitez les live updates à l’expérience de l’application que vous avez soumise et communiquée aux utilisateurs.

Est-ce que Capgo peut provoquer un rejet d'exécution d'un code distant d'Apple ?

Section intitulée « Capgo peut-il provoquer un rejet d'exécution code par Apple ? »

Non. Ce n'est pas possible. Capgo n'installe ni n'exécute de code natif, de bibliothèques dynamiques, de frameworks ou de plugins, et ne peut pas appeler dlopen, dlsym, performSelector:, ou method_exchangeImplementations(). Il remplace uniquement le JavaScript, le HTML, le CSS et les assets statiques à l'intérieur de la WebView ou du moteur JavaScriptCore déjà compilé dans le binaire examiné.

Lorsque l'App Review cite la directive 2.5.2 ou l'« exécution de code à distance », ne considérez pas Capgo comme la cause. Lisez l'avis de review, puis inspectez le projet natif et les autres SDK pour détecter un chargement d'exécutable ou l'utilisation de API privées. Une ancienne note de review sur le linking dynamique dans le chemin d'auto-masquage du splash screen Capgo était un bug de ce plugin natif, pas des live updates, et ce lien a été supprimé.

La règle d'Apple sur l'exécution de code à distance affecte-t-elle Capgo ?

Section intitulée « La règle d'Apple sur l'exécution de code à distance affecte-t-elle Capgo ? »

Non. Capgo ne peut pas provoquer le rejet d'une exécution code à distance. Voir Est-ce que Capgo peut provoquer un rejet d'exécution d'un code distant d'Apple ?. Capgo est conçu pour la couche web interprétée dans les applications Capacitor. Il n'installe ni n'exécute de code natif après la review. Apple examine toujours chaque application selon ses propres éléments, et Capgo ne peut garantir aucun résultat.

La directive App Review 2.5.2 d'Apple indique que les apps ne peuvent pas « télécharger, installer ou exécuter code qui introduit ou modifie des fonctionnalités ou le comportement de l'app ». Les équipes de revue citent cette règle, ainsi que l'Apple Developer Program License Agreement section 3.3.1(B) on exécute code, lorsqu'ils rejettent les applications qui utilisent des ressources distantes pour modifier leur comportement après approbation. Les exemples typiques incluent dlopen, dlsym, performSelector:, ou des scripts distants qui accèdent à des API privées.

Le même contrat de licence autorise le code interprété à être téléchargé lorsqu'il :

  • ne modifie pas l'objectif principal de l'app,
  • ne contourne pas la signature, le sandbox ou d'autres mécanismes de sécurité de l'OS, et
  • ne crée pas un store ou une vitrine pour d'autres applications.

Section 3.3.1(C) restreint séparément la fourniture, le déverrouillage ou l'activation de fonctionnalités ou de capacités supplémentaires via des mécanismes de distribution autres que l'App Store, la distribution personnalisée d'apps ou TestFlight, à moins qu'Apple ne donne son accord écrit préalable ou que l'activité ne soit autorisée par la section 3.3.9(A) (Achats intégrés API). La manière dont cette clause s'applique à un bundle OTA code donné est une question juridique qui relève de votre équipe et de vos conseillers.

Capgo remplace le JavaScript, le HTML, le CSS et les assets statiques qui s'exécutent déjà dans la WebView ou le moteur JavaScriptCore de votre app. Il n'embarque pas de binaires natifs, de code machine code, de bibliothèques dynamiques ni de plugins. Directive 4.7 (précisé dans novembre 2025) s'applique lorsque votre app propose des mini-apps HTML5 et JavaScript, des mini-jeux, des chatbots, des plug-ins ou des logiciels similaires qui ne sont pas intégrés au binaire. Si les utilisateurs peuvent parcourir ou lancer plusieurs expériences logicielles distinctes depuis votre app, évaluez avec votre conseil juridique les exigences supplémentaires de la section 4.7. Un produit unique qui met à jour son propre bundle web via des canaux est une expérience utilisateur différente, mais seul Apple décide si vos métadonnées correspondent à cette description.

Déployez les capacités natives, les permissions, les entitlements et les changements de fonctionnalités substantiels via un binaire App Store classique. Utilisez Capgo pour les correctifs et améliorations de la couche web qui restent dans l'app que vous avez soumise. Voir l'exécution de code à distance par Apple et Capgo pour une analyse de conformité plus détaillée, ou le guide sur le blog pour la règle 2.5.2, l'ADPLA 3.3.1(B) et la clarification de 2025 sur la règle 4.7.

Est-ce que Capgo garantit la validation par l'App Store ou Google Play ?

Section intitulée « Est-ce que Capgo garantit l'approbation de l'App Store ou de Google Play ? »

Non. Apple et Google examinent chaque app et chaque release selon les éléments qui lui sont propres, et Capgo ne peut garantir l'approbation ni le résultat d'un examen individuel. Votre équipe reste responsable du contenu de l'app, des informations fournies, du périmètre des mises à jour et du respect des politiques actuelles des stores.

Pour préparer vos examens et vos releases, consultez directement les politiques officielles : Règles de révision de l'App Store d'Apple et Politique Google Play sur les abus d'appareils et de réseau.

Nous n’avons pas cherché à restreindre l’accès à Capgo depuis un quelconque pays.

Nous savons que certains pays imposent des restrictions sur les URL accessibles depuis leur territoire. Capgo utilise actuellement Cloudflare Cloud pour l’hébergement, notamment R2 Storage et les workers Cloudflare.

Les URL suivantes sont utilisées par Capgo :

  • https://api.capgo.app — utilisée par les npx @capgo/cli outils en ligne de commande pour interagir avec les serveurs Capgo, ainsi que l’updater Capgo sur les appareils des utilisateurs pour vérifier les mises à jour.
  • https://*.r2.cloudflarestorage.com — utilisée par les npx @capgo/cli outil en ligne de commande pour envoyer et télécharger des bundles

Si toutes ces URL sont accessibles depuis votre pays, Capgo devrait fonctionner.

Si votre région impose de bloquer l'accès à l'une de ces URL, dites-le-nous et nous chercherons une solution avec vous. Les serveurs proxy sont une option.

Oui. Enterprise prend en charge les déploiements sous licence de Capgo auto-hébergés lorsque vous devez exécuter le backend de l'updater sur votre propre infrastructure. Voir Updater auto-hébergé pour le modèle de déploiement et les endpoints.

Oui. On peut imaginer faire tourner un serveur pour distribuer les mises à jour indépendamment d'internet, mais une forme de connectivité réseau reste nécessaire pour acheminer les mises à jour vers les appareils.

Quel est l'impact de l'absence de connectivité réseau sur Capgo ?

Section intitulée « Comment Capgo est-il affecté par l'absence de connexion réseau ? »

L'updater Capgo (inclus dans votre application quand vous la compilez avec Capgo) est conçu pour être résilient face aux problèmes de connectivité réseau.

Avec le comportement de mise à jour par défaut, au lancement de l'application, l'updater Capgo est sollicité ; il lance alors un thread séparé pour effectuer une requête réseau vers les serveurs de Capgo afin de demander une mise à jour. Nous utilisons volontairement un thread séparé pour ne rien bloquer de ce que l'application est en train de faire. Si la requête réseau échoue ou expire, l'updater tentera simplement de vérifier à nouveau au prochain lancement de l'application.

Les outils en ligne de commande Capgo (ex. npx @capgo/cli@latest bundle upload) nécessitent une connexion réseau pour fonctionner. Si vous utilisez Capgo pour distribuer votre application, assurez-vous que votre système de CI dispose d'un accès réseau.

Que se passe-t-il si un utilisateur ne fait pas de mise à jour pendant longtemps et en rate une ?

Que se passe-t-il si un utilisateur ne fait pas de mise à jour pendant longtemps et en manque une ?

Notre implémentation envoie toujours une mise à jour spécifiquement adaptée à l'appareil qui la demande, en mettant toujours l'appareil demandeur à jour vers la dernière version disponible. Ainsi, si un utilisateur ne fait pas de mise à jour pendant un certain temps, il passera à côté des versions intermédiaires.

Le serveur de mise à jour peut être modifié pour répondre avec la version incrémentale suivante ou la dernière version, selon les besoins de votre application. Faites-nous savoir si d'autres comportements de mise à jour sont importants pour vous.

Capgo est un plugin pour Capacitor qui ajoute la push code. Capgo n'est pas un remplacement pour Capacitor. Vous pouvez continuer à utiliser les outils Capacitor que vous connaissez et appréciez déjà.

Nous suivons la dernière release stable de Capacitor et mettons à jour notre plugin de push code pour qu'il fonctionne avec.

Quand les mises à jour ont-elles lieu ?

Section titled “When do updates happen?”

Par défaut, le metteur à jour Capgo vérifie les mises à jour au démarrage de l'application. Il s'exécute sur un thread en arrière-plan et ne bloque pas le thread UI. Les mises à jour sont installées pendant que l'utilisateur utilise l'application et seront appliquées au prochain redémarrage de l'application.

Il est également possible d'exécuter manuellement le metteur à jour Capgo en utilisant @capgo/capacitor-updater package, permettant de déclencher des mises à jour à tout moment, y compris via une notification push.

L'updater Capgo est conçu pour que l'application continue de fonctionner normalement lorsque le réseau est indisponible, ou que le serveur est hors ligne ou injoignable. Si vous choisissez un jour de supprimer une mise à jour de nos serveurs, tous vos clients continueront de fonctionner normalement.

Nous avons ajouté la possibilité de faire un rollback des patchs. Le plus simple est d'associer un bundle précédent à votre canal pour revenir en arrière.

Non. L' app_id est inclus dans votre application et peut être public sans risque. Vous pouvez l'ajouter à votre gestion de versions (même publiquement) sans craindre qu'un tiers y accède.

Une personne possédant votre app_id peut récupérer la dernière version de votre application depuis les serveurs Capgo, mais elle ne peut pas envoyer de mises à jour à votre application ni accéder à aucun autre aspect de votre compte Capgo.

Quelles informations sont envoyées aux serveurs Capgo ?

Section intitulée « Quelles informations sont envoyées aux serveurs Capgo ? »

L'inventaire complet des données, le comportement des endpoints et les contrôles de confidentialité sont documentés dans Conformité.

Définissez statsUrl: '' pour désactiver les rapports statistiques explicites de l'updater. Vous pouvez également envoyer statsUrl vers un proxy ou un endpoint que vous contrôlez ; voir la gestion des statistiques sur une infrastructure auto-hébergée. Les vérifications de mise à jour nécessitent toujours un identifiant d'appareil propre à l'app pour que Capgo puisse sélectionner la bonne mise à jour et mesurer les appareils actifs mensuels.

Le la liste des sous-traitants est notre source de vérité publique à jour concernant les providers, les lieux de traitement, les mécanismes de transfert et l'historique des changements.

Oui, mais votre responsable conformité doit choisir le bon modèle de déploiement. Capgo Cloud n'est pas actuellement présenté comme un service hébergé de traitement des statistiques conforme à HIPAA. Par défaut, les données de l'updater sont limitées à l'appareil et ne sont pas liées à un utilisateur connu de l'application, et de nombreuses équipes utilisent ce modèl’avec succès.

Pour des audits plus stricts, vous pouvez géolocaliser le trafic des plugins, désactiver les statistiques en réglant statsUrl sur une chaîne vide, auto-héberger uniquement l'endpoint de statistiques, ou utiliser l'auto-hébergement sous licence. N'appelez pas CapacitorUpdater.setCustomId(...) avec un e-mail, un ID utilisateur, un ID patient, un ID employé ou toute valeur permettant de lier la télémétrie de l'updater à une personne.

Consultez 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 live update de Capgo en Europe ?

Section intitulée « Puis-je conserver les données Capgo live update en Europe ? »

Oui. Les applications nécessitant la résidence des données dans l'UE pour le trafic du plugin Cloud Capgo peuvent configurer les endpoints de l'updater sur l'hôte EU :

  • updateUrl: https://plugin.eu.capgo.app/updates
  • statsUrl: https://plugin.eu.capgo.app/stats
  • channelUrl: https://plugin.eu.capgo.app/channel_self

Utilisez les trois URL de l'UE ensemble pour que les vérifications de mise à jour, les statistiques et l'auto-assignation de canal utilisent le même chemin de données régional. Comme ces valeurs résident dans capacitor.config.ts, production mobile apps need a native release before existing installs use the new endpoints.

Consultez Localisation des données pour des exemples précis avec Capacitor et Electron.

Actuellement, Capgo prend en charge Android, iOS et Electron. Tous sont prêts pour la production.

L'usage de Capgo pour iOS, Android ou Electron peut relever de décisions indépendantes. Vous pouvez définir votre stratégie de canaux pour Android et un ipa compilé pour l'App Store, ou pour des canaux Electron, selon vos besoins.

Capgo peut (relativement facilement) être adapté pour supporter le desktop ou l'embarqué. Si cela est important pour vous, n'hésitez pas à nous le faire savoir.

Comment Capgo interagit-il avec les Play Testing Tracks ou Apple TestFlight ?

Section intitulée « Comment Capgo interagit-il avec les pistes de test Play ou Apple TestFlight ? »

Chaque store d’applications dispose de ses propres mécanismes pour distribuer des applications à des groupes restreints d’utilisateurs (par exemple « test interne », « bêta fermée », etc.). Tous ces mécanismes servent à segmenter vos utilisateurs en groupes et à distribuer des versions spécifiques de vos applications à chacun d’eux.

Malheureusement, tous ces mécanismes ne permettent pas aux tiers de détecter si une application est installée sur une piste de test spécifique ou via TestFlight. Nous n’avons donc pas de visibilité fiable sur la composition de ces groupes et ne pouvons pas restreindre de manière fiable l’accès aux correctifs 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 bundle Capgo, voici 4 options possibles :

  1. Utilisez un canal distinct pour chaque groupe. C’est l’approche la plus simple, mais elle implique de gérer plusieurs canaux. Vous avez peut-être déjà des canaux dev et prod avec des disponibilités différentes. Vous pouvez donc mettre à jour vos canaux dev, vérifier le résultat, puis mettre à jour séparément vos canaux prod. Nous recommandons d’utiliser des branches ou des tags dans votre système de contrôle de version pour suivre les sources associées à chaque release.
  2. Suivez votre propre ensemble d'utilisateurs opt-in, désactivez les mises à jour automatiques et déclenchez des mises à jour uniquement pour certains utilisateurs via le @capgo/capacitor-updater package. Cela fonctionne aujourd'hui, mais vous devez gérer votre propre liste d'opt-in.
  3. Capgo permet de créer son propre mécanisme d'opt-in par appareil (similaire aux Test Tracks ou TestFlight, mais agnostique de la plateforme). Cela permet à votre équipe QA de faire opt-in sur le bundle avant qu'il ne soit déployé auprès du grand public.
  4. Utiliser déploiements progressifs pour livrer un bundle candidat à un sous-ensemble aléatoire et persistant d'un canal. Définissez un déploiement de 0 à 100 %, ou utilisez --rollout-percentage-bps pour des incréments de 0,01 % ; configurez la durée du cache de 60 secondes à 365 jours et une politique de pause automatique optionnelle. Cela ne sélectionne pas de groupe d'appareils nommé.

Comment changer de plan (upgrade ou downgrade) ?

Section intitulée « Comment passer à un autre plan ? »

Vous pouvez passer à un autre plan à tout moment dans votre dashboard : https://console.capgo.app/settings/organization/plans. Les mises à niveau prennent effet immédiatement. Les rétrogradations s’appliquent à la fin de votre cycle de facturation en cours.

Que se passe-t-il si j’atteins ma limite de MAU ?

Section intitulée « Que se passe-t-il si j’atteins ma limite de MAU ? »

Capgo vous envoie un e-mail à 50 %, 70 %, 90 % et 100 % de votre limite de MAU. Une fois la limite atteinte, les live updates sont bloquées jusqu’à la fin de votre cycle de facturation. Passez à un plan supérieur ou achetez des crédits pour reprendre la diffusion des mises à jour. Voir les tarifs de Capgo et Tarifs pour les niveaux de plan.

Sauf obligation légale, les frais d'abonnement payés ne sont pas remboursables. Certaines demandes de remboursement peuvent être examinées au cas par cas à la seule discrétion de Capgo. Contactez le support si vous pensez y avoir droit.

Les périodes de facturation sont réinitialisées automatiquement chaque mois à la date de votre premier abonnement à 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.

Vous pouvez annuler votre abonnement à tout moment depuis votre dashboard : https://console.capgo.app/settings/organization/plans

Oui. Vous pouvez choisir la facturation annuelle dans votre configuration du plan d’organisation.

Qu'est-ce qui est comptabilisé dans le stockage, et peut-on modifier la rétention ?

Section intitulée « Que compte-t-on dans le stockage, et peut-on modifier la rétention ? »

Le stockage inclut les bundles historiques conservés ainsi que leurs assets Delta sur l’ensemble de vos canaux. Vous gérez la rétention des bundles inutilisés pour chaque application dans les paramètres de l’application. Les bundles liés à un canal actif ou à un déploiement progressif restent protégés afin de garantir leur disponibilité pour la livraison et le rollback.

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 ? »

Non. Un bundle n'est compté qu'une seule fois pour le stockage, peu importe les régions qui le servent. La bande passante n'est pas non plus multipliée par les régions : voir Comment la bande passante est-elle comptabilisée ?.

Comment la bande passante est-elle comptabilisée ?

Section titled “How is bandwidth counted?”

La bande passante ne comptabilise que les fichiers qu'un appareil télécharge réellement depuis Capgo :

  • Mises à jour delta : lorsque vous effectuez un upload avec --delta, un appareil ne télécharge que les fichiers qui ont changé depuis la version qu'il possède déjà. Seuls ces fichiers sont comptabilisés. Les fichiers inchangés, comme les images volumineuses ou les polices, ne sont pas téléchargés à nouveau et ne coûtent rien. Voir Mises à jour delta.
  • Cache edge : si le fichier demandé ou le zip complet est déjà en cache à l’edge, ce téléchargement ne compte pas dans votre bande passante. Cela s’applique aussi bien aux fichiers Delta qu’aux zips complets.
  • Téléchargements repris : si un téléchargement est interrompu, l’appareil reprend là où il s’était arrêté. La partie déjà téléchargée n’est ni retéléchargée ni comptée à nouveau.
  • Zip complet : les bundles envoyés sans --delta, ou les appareils sur une version de plugin sans prise en charge des Delta, téléchargent le zip complet. Il ne compte que s’il n’est pas servi depuis le cache edge.

Pour garder la bande passante basse, envoyez avec --delta et conservez les gros assets qui changent rarement dans des chemins de fichiers stables.

L'offre Enterprise inclut un engagement de disponibilité mensuelle de 99,9 % pour la plateforme de production. En cas de non-respect de cet engagement, le barème de crédits de service va de 10 % à 30 % selon la disponibilité mensuelle. Les objectifs initiaux de délai de réponse du support sont : P1 : une heure, 24/7/365 ; P2 : deux heures ouvrées ; P3 : un jour ouvré ; et P4 : deux jours ouvrés. Consultez le SLA Enterprise pour les conditions complètes.

Les stats de votre dashboard sont mises à jour chaque minuit UTC. Les stats sont calculées à partir des MAU sur la période glissante de 30 jours.

L'ID de l'appareil est généré sur l'appareil au premier lancement. Il sert à dédoublonner les installations par appareil et nous permet de facturer en fonction des utilisateurs ayant installé l'app (par ex. les utilisateurs actifs mensuels), plutôt que sur le nombre total de patches ou d'installations de patches.

Les utilisateurs actifs mensuels (MAU) sont une meilleure base de facturation que le nombre d'installations pour tarifer Capgo : c'est plus précis et cela reflète le coût réel de Capgo par appareil.

Persistance de l'ID de l'appareil :

  • iOS: À partir de la v7.25.0, l'ID de l'appareil est stocké dans le Keychain et persiste lors des réinstallations normales.
  • Android: Utilisez la v7.50.1+ (ou v5.50.1+/v6.50.1+ sur ces branches de release). L'ID de l'appareil n'est restauré que si Android Backup/Restore conserve les préférences de l'application.
  • Electron: L'ID de l'appareil est stocké dans un stockage sécurisé.
  • Avertissement Android: Désactiver la sauvegarde, exclure les préférences concernées ou effacer les données de l'application génère un nouvel ID de l'appareil. Les versions Android 7.25.0 à 7.50.0 peuvent générer un nouvel ID de l'appareil après une réinstallation, même avec la sauvegarde activée.

L’identifiant d’appareil est propre à l’application et permet la livraison des live updates ainsi que la déduplication des MAU. Ce n’est pas un identifiant publicitaire ni un traceur inter-applications.

Les identifiants d’appareil apparaissent une fois que l’application a fait son check-in auprès de Capgo via les endpoints updater ou stats. Un appareil n’a pas besoin d’installer un patch pour apparaître dans la liste des appareils.

Pourquoi mon nombre d'appareils diffère-t-il de mes MAU ?

Section intitulée « Pourquoi mon nombre d’appareils diffère-t-il de mes MAU ? »

La liste des appareils et les MAU reposent sur des signaux différents.

La liste des appareils affiche les dernières métadonnées connues pour chaque appareil : identifiant d’appareil, plateforme, version du plugin, version de l’OS, version native, canal, bundle installé et pays de la requête le cas échéant. Le pays de la requête correspond au dernier code code à deux lettres valide reçu dans une requête traitée par Cloudflare pour cet appareil, et non à la position GPS ni à la localisation fournie par l’application. Les requêtes sans pays valide n’effacent pas la dernière valeur valide. Capgo met à jour ces métadonnées lors du check-in de l’application, mais des check-ins répétés avec les mêmes métadonnées peuvent ne pas modifier la ligne ni sa date de dernière mise à jour.

Le MAU compte les appareils actifs distincts pendant la période de facturation. Cette activité peut augmenter même si les métadonnées de l’appareil restent identiques, ce qui explique que le nombre d’appareils et le MAU puissent différer.

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ésactivez les mises à jour Android, et sur le canal Android, désactivez les mises à jour iOS.

Ensuite, envoyez un bundle à chaque canal pour avoir des mises à jour différentes pour chaque plateforme.

Si vous avez besoin de la même mise à jour pour les deux plateformes, vous pouvez lier un bundle à plusieurs canaux. Pas besoin de dupliquer le bundle.

Si vous utilisez FAQ pour planifier la livraison de live update, connectez-l’à Live Updates Capgo pour le workflow produit dans Capgo Live Updates, Aperçu pour les détails d'implémentation dans Vue d'ensemble, Fonctionnalités pour le détail d’implémentation dans Fonctionnalités, Comportement de mise à jour pour les détails d'implémentation dans Update Behavior, et Types de mise à jour pour les détails d'implémentation dans Update Types.