Débogage
Copiez un prompt de configuration incluant les étapes d'installation et le guide markdown complet pour ce plugin.
Comprendre les logs cloud
Section intitulée « Comprendre les logs cloud »En cas de refus cloud code et si vous avez besoin de guides de résolution plus détaillés, consultez Problèmes courants de mise à jour.
Les logs Capgo peuvent inclure des métadonnées pour l’événement. Dans le dashboard, filtrez par l’action code en snake_case, puis cliquez sur la cellule des métadonnées pour copier la charge utile JSON complète. Les métadonnées sont particulièrement utiles pour les événements de crash et de WebView, car elles peuvent contenir le message d’erreur, l’URL source, la ligne et la colonne, l’état du processus, la pression mémoire ou la raison spécifique à la plateforme. Les anciens logs peuvent encore afficher les alias camelCase legacy listés entre parenthèses.
Chaque titre de section correspond à l’action code affichée dans le tableau des logs de la console, ce qui permet d’y accéder directement.
Limites du plan et réponses normales
Section intitulée « Limites du plan et réponses normales »Refus backend liés à la facturation, au throttling ou à des états non-erreur.
InvalidIp
Section intitulée « InvalidIp »Signification
Capgo a détecté un trafic qui semble provenir de Google ou d’infrastructures cloud. Les mises à jour datant de moins de quatre heures sont ignorées afin que le trafic des bots ne soit pas comptabilisé comme des appareils facturables.
Que faire
Ignorez cela pour les utilisateurs réels. Réessayez via un réseau classique et un appareil réel, ou attendez et vérifiez plus tard.
provider_infrastructure_request_blocked
Section intitulée « provider_infrastructure_request_blocked »Signification
Votre application est configurée pour bloquer les requêtes provenant des plages d'IP connues des datacenters Google et Apple. Cette protection s'applique aux vérifications de mise à jour, aux statistiques et aux requêtes channel-self ; les sondes hébergées dans le cloud et les runners des fournisseurs peuvent donc recevoir cette réponse même si la configuration de l'application est valide par ailleurs.
Que faire
Réessayez depuis un appareil physique sur un réseau utilisateur classique. Si le trafic provenant du fournisseur est intentionnel, désactivez temporairement Bloquer les requêtes d'infrastructure du fournisseur dans l'onglet Informations de l'application, puis réactivez-l’après le test. Les nouvelles applications activent ce paramètre par défaut ; les applications existantes conservent leur réglage désactivé précédent jusqu'à modification.
needPlanUpgrade
Section intitulée « needPlanUpgrade »Signification
Your organization reached its plan or device limit. The device will not receive updates until you upgrade or the next billing cycle resets usage.
Que faire
Mettez à niveau votre plan dans le dashboard ou attendez le prochain cycle de facturation.
Signification
L’appareil dispose déjà du dernier bundle disponible pour son canal. C’est un état normal, pas une erreur.
rateLimited
Section intitulée « rateLimited »Signification
L’appareil a envoyé trop de requêtes de mise à jour ou de canal sur une courte période.
Que faire
Arrêtez d’appeler les API de mise à jour dans des boucles de rendu. Appelez setChannel / getChannel uniquement depuis des actions utilisateur, et définissez defaultChannel dans capacitor.config.
Format de version
Section intitulée « Format de version »Refus du backend causés par des métadonnées de version native invalides.
semver_error
Section intitulée « semver_error »Signification
La version de l'app native dans la config est manquante ou n'est pas un semver valide (x.y.z).
Que faire
Définissez plugins.CapacitorUpdater.version pour un semver valide, vérifiez-la dans la testeur SemVer, puis recompilez et réinstallez l'app native.
Ciblage par plateforme et par build
Section intitulée « Ciblage par plateforme et par build »Refus du backend lorsque la politique du canal bloque une plateforme, un type de build ou une classe d'appareil.
disablePlatformIos
Section intitulée « disablePlatformIos »Signification
L'appareil tourne sous iOS, mais les mises à jour iOS sont désactivées pour ce canal.
Que faire
Activez iOS pour ce canal si c'est involontaire, ou redirigez les builds iOS vers un canal dédié si le blocage est intentionnel.
disablePlatformAndroid
Section intitulée « disablePlatformAndroid »Signification
L'appareil tourne sous Android, mais les mises à jour Android sont désactivées pour ce canal.
Que faire
Activez Android dans le canal si c’était accidentel, ou orientez les builds Android vers un canal dédié si le blocage est intentionnel.
disablePlatformElectron
Section intitulée « disablePlatformElectron »Signification
L’appareil exécute Electron, mais les mises à jour Electron sont désactivées pour ce canal.
Que faire
Activez Electron dans le canal si c’était accidentel, ou orientez les builds Electron vers un canal dédié si le blocage est intentionnel.
disableDevBuild
Section intitulée « disableDevBuild »Signification
L’appareil est un build de développement, mais les builds de développement sont bloqués pour ce canal.
Que faire
Autorisez les builds dev dans un canal de test, ou limitez ce canal aux releases et déplacez les appareils dev ailleurs.
disableProdBuild
Section intitulée « disableProdBuild »Signification
Un build de production appelé /updates, mais les mises à jour de production sont bloquées pour ce canal.
Que faire
Autorisez les mises à jour de production dans le canal si c’était accidentel, ou dirigez les builds de production vers le bon canal.
disableDevice
Section intitulée « disableDevice »Signification
Un téléphone ou une tablette réelle a été bloqué car ce canal bloque les appareils réels.
Que faire
Activez les mises à jour sur appareil réel si c’était accidentel, ou conservez la restriction et redirigez les appareils réels vers un autre canal.
disableEmulator
Section intitulée « disableEmulator »Signification
L'appareil est un émulateur, mais les mises à jour sur émulateur sont désactivées pour ce canal.
Que faire
Activez les mises à jour sur émulateur dans un canal de test, ou gardez ce canal bloqué pour les émulateurs et utilisez un autre canal pour la validation sur émulateur.
Règles de compatibilité auto-update
Section titled “Auto-update compatibility rules”Refus du backend lorsque les règles semver ou de métadonnées bloquent le bundle cible.
disableAutoUpdate
Section intitulée « disableAutoUpdate »Signification
L'auto-update est désactivé par la politique de compatibilité du canal. Les métadonnées incluent auto_update avec une règle correspondante telle que major, minor, patch, metadata, ou none.
Que faire
Modifiez la politique de mise à jour automatique du canal pour autoriser le déploiement prévu.
disableAutoUpdateUnderNative
Section intitulée « disableAutoUpdateUnderNative »Signification
Le canal contient un bundle plus ancien que la baseline de l’appareil et bloque l’envoi de mises à jour sous la version native.
Que faire
Publiez un bundle au niveau ou au-dessus de la baseline native, ou désactivez la protection sous-native dans le canal.
disableAutoUpdateMetadata
Section intitulée « disableAutoUpdateMetadata »Signification
Le canal exige min_update_version, mais la version native de l’appareil est inférieure à ce seuil.
Que faire
Définissez min_update_version sur le bundle ou la release cible d'une version native plus récente.
disableAutoUpdateToMajor
Section intitulée « disableAutoUpdateToMajor »Signification
Le canal bloque les sauts de version majeure, par exemple 1.x.x vers 2.x.x.
Que faire
Alignez la stratégie de canal avec votre plan de déploiement progressif, ou autorisez les sauts de version majeure pour ce canal. Voir Problèmes courants de mise à jour.
disableAutoUpdateToMinor
Section intitulée « disableAutoUpdateToMinor »Signification
Le canal bloque les sauts de version mineure par rapport à la version native de l'appareil ("version_build), par exemple 1.2.3 vers 1.3.0.
Que faire
Align channel strategy with your minor rollout plan, or allow minor jumps for this track.
disableAutoUpdateToPatch
Section intitulée « disableAutoUpdateToPatch »Signification
Le canal bloque les modifications de niveau patch tout en conservant le même MAJOR.MINOR.PATCH prefix; only suffix changes are allowed.
Que faire
Alignez la cadence de release avec la politique du canal, ou autorisez les sauts de patch pour cette piste.
Configuration du canal
Section intitulée « Configuration du canal »Refus du backend dus à une configuration de canal manquante ou incompatible.
cannotUpdateViaPrivateChannel
Section intitulée « cannotUpdateViaPrivateChannel »Signification
L'appareil a tenté de s'associer à un canal privé qui n'autorise pas l'auto-assignation des appareils (allow_device_self_set vaut false) et le canal n'est pas public.
Que faire
Activer allow_device_self_set sur le canal ou basculez l'appareil vers un canal public ou autorisé.
channelMisconfigured
Section intitulée « channelMisconfigured »Signification
Le canal utilise disable_auto_update: "version_number" mais le bundle min_update_version est null, donc Capgo ne peut pas décider quels appareils doivent être mis à jour.
Que faire
Complétez la configuration manquante pour cette règle ou passez à un mode d'auto-update plus simple.
NoChannelOrOverride
Section intitulée « NoChannelOrOverride »Signification
Aucun canal par défaut n'est configuré et l'appareil n'a pas d'override de canal.
Que faire
Définissez un canal par défaut dans le dashboard ou configurez-le defaultChannel lors du build.
Livraison et chiffrement du bundle
Section intitulée « Livraison et chiffrement du bundle »Refus du backend lorsque Capgo ne peut pas fournir ou déchiffrer le bundle.
cannotGetBundle
Section intitulée « cannotGetBundle »Signification
Capgo n’a pas pu générer une URL de téléchargement signée valide et aucun manifeste de secours n’était disponible.
Que faire
Réenvoyez le bundle, régénérez les manifestes et vérifiez les paramètres R2 ou de bundle public.
missingBundle
Section intitulée « missingBundle »Signification
Le bundle assigné au canal ne contient aucun contenu téléchargeable : aucun external_url, non r2_path, pas une version intégrée, et aucune entrée dans le manifeste.
Que faire
Recompilez et renvoyez la version, puis vérifiez que le bundle contient bien des fichiers réels.
keyMismatch
Section intitulée « keyMismatch »Signification
La clé publique de chiffrement de l'appareil ne correspond pas à la clé utilisée pour chiffrer le bundle. Les métadonnées peuvent inclure device_key_id, bundle_key_id, et version.
Que faire
Comparez les ID de clé de l'appareil et du bundle dans la console. Publiez avec la même clé et des versions CLI/plugin correspondantes.
Configuration de l'app et clients legacy
Section intitulée « Configuration de l'app et clients legacy »Refus du backend causés par la configuration de l'app ou des versions de l'updater non supportées.
customIdBlocked
Section intitulée « customIdBlocked »Signification
L'app a envoyé un ID d'appareil personnalisé, mais cette app n'accepte pas les ID personnalisés ; l'ID est donc ignoré.
Que faire
Arrêtez d’envoyer des identifiants personnalisés, ou activez-les uniquement si votre workflow l’exige.
blocked_by_server_url
Section intitulée « blocked_by_server_url »Signification
server.url est défini dans la configuration Capacitor, de sorte que la WebView charge une URL distante au lieu des fichiers du bundle local. Les live updates Capgo nécessitent des fichiers locaux et server.url est déconseillé en production.
Que faire
Supprimer ou vider server.url pour les builds de production et garder les payloads de mise à jour en local. Ce code peut se manifester par un refus du backend ou une stat côté appareil.
backend_refusal
Section intitulée « backend_refusal »Signification
Le plugin updater est en v4, une version que le backend n’accepte plus.
Que faire
Passez le plugin et CLI en v5+ (de préférence la v8) avec Capacitor v5+, recompilez et republiez les métadonnées du bundle.
Cycle de vie d'une MAJ
Section titled “Update lifecycle”Événements côté appareil pour le flux de mise à jour normal, l’activation et le rollback.
Signification
Action de test interne utilisée pour vérifier le pipeline de statistiques.
Signification
Capgo a envoyé à l’appareil les informations de téléchargement d’une nouvelle version.
Signification
Un bundle a été activé sur l’appareil.
set_fail
Section intitulée « set_fail »Signification
L’activation d’un bundle a échoué sur l’appareil.
Que faire
Vérifiez les logs natifs avec npx @capgo/cli@latest app debug et vérifiez l’intégrité du bundle, les chemins et notifyAppReady flux.
Signification
L’appareil a été réinitialisé sur le bundle intégré.
Signification
Un bundle a été supprimé sur l'appareil.
Échecs de téléchargement et d'installation
Section intitulée « Échecs de téléchargement et d'installation »Événements côté appareil pour la progression du téléchargement, la validation de l'archive et les erreurs d'installation.
download_0
Section intitulée « download_0 »Signification
La séquence de téléchargement a commencé à 0 % de progression.
download_10
Section intitulée « download_10 »Signification
Un nouveau bundle a été téléchargé — progression indiquée à 10 %.
download_20
Section intitulée « download_20 »Signification
Un nouveau bundle a été téléchargé — progression indiquée à 20 %.
download_30
Section intitulée « download_30 »Signification
Un nouveau bundle a été téléchargé — progression indiquée à 30 %.
download_40
Section intitulée « download_40 »Signification
Un nouveau bundle a été téléchargé — progression indiquée à 40 %.
download_50
Section intitulée « download_50 »Signification
Un nouveau bundle a été téléchargé — progression indiquée à 50 %.
download_60
Section intitulée « download_60 »Signification
Un nouveau bundle a été téléchargé — progression indiquée à 60 %.
download_70
Section intitulée « download_70 »Signification
Un nouveau bundle a été téléchargé — progression indiquée à 70 %.
download_80
Section intitulée « download_80 »Signification
Un nouveau bundle a été téléchargé — progression indiquée à 80 %.
download_90
Section intitulée « download_90 »Signification
Un nouveau bundle a été téléchargé — progression indiquée à 90 %.
download_complete
Section intitulée « download_complete »Signification
Le téléchargement du bundle s’est terminé avec succès.
download_manifest_start
Section intitulée « download_manifest_start »Signification
L’appareil a commencé à télécharger le manifeste de mise à jour.
download_manifest_complete
Section intitulée « download_manifest_complete »Signification
L’appareil a terminé le téléchargement du manifeste de mise à jour.
download_zip_start
Section intitulée « download_zip_start »Signification
L’appareil a commencé à télécharger l’archive du bundle.
download_zip_complete
Section intitulée « download_zip_complete »Signification
L'appareil a fini de télécharger l'archive du bundle.
download_manifest_file_fail
Section intitulée « download_manifest_file_fail »Signification
Une entrée du manifeste n'a pas pu être téléchargée. version_name utilise version:fileName pour identifier l'asset.
Que faire
Corrigez l'asset manquant ou bloqué, régénérez le manifeste et renvoyez le bundle.
download_manifest_checksum_fail
Section intitulée « download_manifest_checksum_fail »Signification
La validation du checksum du fichier manifest a échoué.
Que faire
Re-upload the bundle avec une version actuelle de CLI et vérifiez les checksums du manifest.
download_manifest_brotli_fail
Section intitulée « download_manifest_brotli_fail »Signification
Un fichier manifest a échoué lors de la décompression Brotli.
Que faire
Vérifiez les paramètres de compression et renvoyez les assets concernés.
download_fail
Section intitulée « download_fail »Signification
Le téléchargement du bundle a échoué.
Que faire
Vérifiez la connectivité réseau, l’expiration de l’URL signée, l’accessibilité du CDN et le stockage de l’appareil.
update_fail
Section intitulée « update_fail »Signification
Le bundle a été installé mais l'app n'a jamais appelé notifyAppReady, donc Capgo a effectué un rollback.
Que faire
Appelez notifyAppReady() après le bootstrapping de votre application. Texte des logs natifs notifyAppReady was not called, roll back current bundle correspond à ce code.
checksum_fail
Section intitulée « checksum_fail »Signification
Le bundle téléchargé n'a pas passé la validation du checksum. Causes fréquentes : incohérence CRC32 vs SHA256 due à un ancien upload CLI, ou clé de chiffrement différente sur d'anciens plugins qui remontent un échec de déchiffrement comme un échec de checksum.
Que faire
Renvoyez le bundle avec un CLI/plugin à jour (SHA256). Si vous utilisez le chiffrement, vérifiez que la clé publique de l'app correspond à la clé d'upload, ou passez au plugin 8.3.0+ pour des keyMismatch erreurs.
decrypt_fail
Section intitulée « decrypt_fail »Signification
Le bundle téléchargé n'a pas pu être déchiffré.
Que faire
Vérifiez les clés de chiffrement et renvoyez le bundle avec la paire de clés correspondante.
windows_path_fail
Section intitulée « windows_path_fail »Signification
Le zip contient des chemins de style Windows non valides.
Que faire
Recompilez le bundle avec des chemins Unix ou nettoyez les chemins de l'archive avant l'upload.
canonical_path_fail
Section intitulée « canonical_path_fail »Signification
Les chemins de fichiers dans le zip ne sont pas canoniques.
Que faire
Corrigez la génération des chemins de l'archive avant l'upload.
directory_path_fail
Section intitulée « directory_path_fail »Signification
Le zip contient des chemins de répertoire invalides.
Que faire
Corrigez la structure de l'archive avant l'upload.
unzip_fail
Section intitulée « unzip_fail »Signification
L'appareil n'a pas pu décompresser le bundle téléchargé.
Que faire
Vérifiez l'intégrité de l'archive et la compression prise en charge.
low_mem_fail
Section intitulée « low_mem_fail »Signification
L'échec du téléchargement est dû à un manque de mémoire sur l'appareil.
Que faire
Réduisez la taille du bundle ou réessayez sur un appareil avec plus de mémoire libre.
Santé de l'app et événements WebView
Section intitulée « Santé de l'app et événements WebView »Diagnostics de crash, de mémoire et de WebView côté appareil. Inspectez toujours le JSON des métadonnées dans le dashboard.
app_moved_to_background
Section intitulée « app_moved_to_background »Signification
L'application est passée en arrière-plan.
app_moved_to_foreground
Section intitulée « app_moved_to_foreground »Signification
L'application est passée au premier plan.
app_crash
Section intitulée « app_crash »Signification
Crash de la couche JavaScript ou Capacitor. Les métadonnées peuvent inclure le message, la stack, la source et le contexte du bundle actif.
Que faire
Inspectez les métadonnées et les logs natifs. Associez le reporting d'erreurs JS et natif (par exemple Sentry) pour localiser le chemin code défaillant.
app_crash_native
Section intitulée « app_crash_native »Signification
Crash de la plateforme native. Les métadonnées peuvent inclure la plateforme, la raison, la pile et les détails du processus.
Que faire
Utilisez les logs de crash Xcode ou Logcat et croisez-les avec le bundle actif via les métadonnées.
Signification
Événement « Application ne répond pas » sur Android.
Que faire
Inspectez les traces ANR dans Logcat et réduisez le travail bloquant du thread principal après les mises à jour.
app_killed_low_memory
Section intitulée « app_killed_low_memory »Signification
The OS killed the app after memory pressure.
Que faire
Réduire l’usage mémoire après l’activation de la mise à jour et inspecter les métadonnées pour les signaux de mémoire disponible.
app_killed_excessive_resource_usage
Section intitulée « app_killed_excessive_resource_usage »Signification
The OS killed the app for excessive resource use.
Que faire
Inspectez les métadonnées selon le type de ressource ou motif de plateforme.
app_initialization_failure
Section intitulée « app_initialization_failure »Signification
L'Updater ou le démarrage a échoué avant que le runtime normal ne soit prêt.
Que faire
Inspectez les métadonnées pour identifier l'étape en échec et le message d'erreur.
app_memory_warning
Section intitulée « app_memory_warning »Signification
Avertissement mémoire iOS.
Que faire
Inspectez le contexte mémoire des métadonnées et réduisez le pic après les mises à jour.
webview_javascript_error
Section intitulée « webview_javascript_error »Signification
Erreur JavaScript non interceptée dans la WebView. Les métadonnées peuvent inclure le message, l'URL source, la ligne, la colonne et la stack.
Que faire
Installez le reporting d'erreurs dans les couches JS et natives pour capturer la ligne exacte qui échoue en production.
webview_unhandled_rejection
Section intitulée « webview_unhandled_rejection »Signification
Rejet de promesse non géré dans la WebView.
Que faire
Capturez les échecs asynchrones via le reporting d’erreurs JS et natif.
webview_resource_error
Section intitulée « webview_resource_error »Signification
Un ressource WebView a échoué à charger.
Que faire
Utilisez l’URL de métadonnées et les détails du statut pour corriger les assets cassés ou les règles réseau.
webview_security_policy_violation
Section intitulée « webview_security_policy_violation »Signification
La politique de sécurité du contenu a bloqué une ressource.
Que faire
Ajustez la CSP à l’aide de la directive metadata et des détails des URI bloqués.
webview_unclean_restart
Section intitulée « webview_unclean_restart »Signification
La session WebView précédente n’a pas été fermée proprement, ce qui peut indiquer des boucles de crash après une mise à jour.
Que faire
Corrélez avec les événements de crash et d'erreur WebView avant et après le redémarrage.
webview_render_process_gone
Section intitulée « webview_render_process_gone »Signification
Le processus de rendu WebView Android s'est arrêté.
Que faire
Inspectez les signaux de crash du renderer dans les métadonnées et logs.
webview_content_process_terminated
Section intitulée « webview_content_process_terminated »Signification
Processus de contenu WebView iOS terminé.
Que faire
Inspectez le bundle actif et l'URL de page dans les métadonnées.
Télémétrie de lancement et de navigation
Section intitulée « Télémétrie de lancement et de navigation »Ces événements de timing décrivent le cycle de vie de l’application. Ils ne garantissent pas que toutes les fonctionnalités fonctionnent.
app_launch_start
Section intitulée « app_launch_start »Signification
L’application a démarré une mesure de lancement. C’est un événement normal du cycle de vie.
app_launch_ready
Section intitulée « app_launch_ready »Signification
L’application a signalé qu’elle était prête. Les métadonnées de timing permettent de comparer le démarrage entre les versions. C’est un événement normal du cycle de vie.
app_launch_timeout
Section intitulée « app_launch_timeout »Signification
L’application n’a pas signalé qu’elle était prête dans la fenêtre de mesure du lancement.
Que faire
Inspectez les erreurs de démarrage et la chronologie de l’appareil. Vérifiez que le démarrage atteint l’appel de readiness, puis appelez notifyAppReady() après le bootstrap réussi. Comparez les délais et les échecs avec le bundle précédent avant de modifier les paramètres de timeout.
webview_dom_content_loaded
Section intitulée « webview_dom_content_loaded »Signification
Le WebView a signalé que le contenu DOM était chargé. Il s’agit d’un événement de chronométrage normal, pas d’une preuve que toutes les ressources ou fonctionnalités de l’application sont prêtes.
webview_page_loaded
Section intitulée « webview_page_loaded »Signification
Le WebView a signalé le chargement d’une page. C’est un événement de chronométrage normal. Comparez les métadonnées de durée entre les versions lors de l’investigation de chargements lents.
Signification
L’app a signalé un événement de navigation. Il s’agit de télémétrie normale. Les métadonnées de route et de durée permettent des comparaisons par écran si l’app les fournit.
Autres résultats de l’updater
Section intitulée « Autres résultats de l’updater »set_next
Section intitulée « set_next »Signification
Un bundle a été planifié pour activation au prochain lancement de l’application. La planification est normale et ne signifie pas que le bundle a déjà été activé.
channelPaused
Section intitulée « channelPaused »Signification
Le canal sélectionné est en pause. Le serveur n’envoie aucune mise à jour et l’appareil conserve son bundle actuel. Il peut s’agir d’une politique de release volontaire.
Que faire
Vérifiez pourquoi le canal a été mis en pause et s’il est sûr de le reprendre. Ne reprenez pas un déploiement progressif automatiquement pour faire taire cet événement.
finish_download_fail
Section intitulée « finish_download_fail »Signification
L’appareil n’a pas pu finaliser un bundle téléchargé.
Que faire
Inspectez les métadonnées et les logs natifs pour identifier l’erreur sous-jacente de système de fichiers ou de validation. Vérifiez l’espace de stockage disponible et l’archive envoyée avant de réessayer.
manifest_path_fail
Section intitulée « manifest_path_fail »Signification
Le chemin du fichier manifest a échoué à la validation ou n’a pas pu être utilisé lors de la mise à jour.
Que faire
Inspectez le chemin défaillant dans les logs natifs, corrigez la structure des fichiers du bundle et renvoyez-le. Ne contournez pas la validation des chemins.
checksum_required
Section intitulée « checksum_required »Signification
L’updater nécessite des métadonnées de checksum manquantes pour ce téléchargement.
Que faire
Renvoyez le bundle avec le CLI actuel et vérifiez que les métadonnées de checksum sont présentes. Ne désactivez pas les vérifications d’intégrité pour contourner l’erreur.
insufficient_disk_space
Section intitulée « insufficient_disk_space »Signification
L’appareil ne dispose pas d’assez d’espace de stockage pour la mise à jour.
Que faire
Libérez de l’espace de stockage sur l’appareil, réduisez la taille du bundle si possible et réessayez sur un appareil de test concerné. Ce problème ne se résout pas en modifiant la politique de version d’un canal.
update_check_error
Section intitulée « update_check_error »Signification
L’échec d’une vérification de mise à jour ne permet pas à lui seul de déterminer si la cause est la connectivité, la disponibilité du serveur ou un refus de réponse spécifique.
Que faire
Inspectez les métadonnées de la réponse et les logs natifs environnants. Vérifiez la connectivité et l’URL de mise à jour configurée, puis consultez les erreurs backend spécifiques dans Common Update Problems avant de modifier les paramètres.
Contexte d'environnement et de canal
Section intitulée « Environment and channel context »Événements de contexte côté appareil pour corréler le comportement des mises à jour avec les changements d’OS, de version native ou de canal.
os_version_changed
Section intitulée « os_version_changed »Signification
Version d’OS de l’appareil changée entre deux vérifications.
native_app_version_changed
Section intitulée « native_app_version_changed »Signification
La version de l’app native sur le store a changé, pour distinguer les changements natifs du bundle web.
getChannel
Section intitulée « getChannel »Signification
L’appareil a interrogé son canal actuel.
setChannel
Section intitulée « setChannel »Signification
Un canal a été défini avec succès pour l’appareil.
uninstall
Section intitulée « uninstall »Signification
L’application a été désinstallée ou les données Capgo ont été effacées.
Statut du bundle
Section intitulée « Statut du bundle »SUCCESS: installation du bundle terminéeERROR: échec de l’installation ou du téléchargementPENDING: téléchargement terminé, release en attenteDELETED: bundle supprimé, toujours affiché pour les statistiquesDOWNLOADING: téléchargement d’un bundle en cours
Comprendre les logs de l'appareil
Section intitulée « Comprendre les logs de l’appareil »Commande de debug
Section intitulée « Commande de débogage »Il existe une commande de debug pour les utilisateurs cloud de Capgo.
npx @capgo/cli@latest app debugCela vous permettra de vérifier tous les événements de l’app et de trouver une solution si les mises à jour ne se déclenchent pas.
Logs natifs iOS
Section intitulée « Logs natifs iOS »pour trouver vos logs dans Xcode
Logs natifs Android
Section intitulée « Logs natifs Android »pour trouver vos logs dans Android Studio
Mapping des phrases de logs natifs
Section intitulée « Correspondance des phrases de logs natifs »Failed to download fromcorrespond àdownload_failnotifyAppReady was not called, roll back current bundlecorrespond àupdate_fail
Trouver le bundle téléchargé sur un appareil
Section intitulée « Trouver le bundle téléchargé sur un appareil »Pour déboguer sur iOS, vous devez extraire l'app sur votre ordinateur, vous pouvez le faire de cette manière :
Xcode possède une fonctionnalité intégrée pour inspecter le système de fichiers des apps installées par un développeur sur un appareil iOS.

Pour ce faire :
- Connectez votre appareil à votre Mac et sélectionnez Fenêtre > Appareils dans la barre de menus de Xcode.
- Sélectionnez votre appareil dans le volet de gauche, sous la section Appareils.
- Cela affiche la liste des apps installées par un développeur sur cet appareil.
- Sélectionnez l’application à inspecter, puis cliquez sur l’icône à trois points située en bas de l’écran.
- Vous pouvez consulter le système de fichiers actuel en téléchargeant un snapshot.

Sélectionner Download Container… téléchargera et exportera un snapshot du système de fichiers sous forme de fichier .xcappdata que vous pourrez parcourir.

Faites un clic droit sur ce fichier et sélectionnez Afficher le contenu du paquet pour ouvrir le dossier.
Ouvrez le dossier App Data, vous devriez maintenant voir quelques dossiers comme Documents, Library, tmp, etc.

Vous trouverez ensuite une version dans 2 dossiers :
library/NoCloud/ionic_built_snapshots est nécessaire après le redémarrage de l'app
et documents/versions pour le hot reload
Pour déboguer sur Android, vous devez accéder à l’appareil depuis Android Studio :
- Cliquez sur View > Tool Windows > Device File Explorer ou sur le bouton Device File Explorer dans la barre des fenêtres d’outils pour ouvrir le panneau Device File Explorer.
- Sélectionnez un appareil dans la liste déroulante.
- Ouvrez le chemin data/data/APP_NAME/ où APP_NAME est l’identifiant de votre application.

Trouvez ensuite le versions dossier pour voir toutes les versions
Comprendre les crash logs de production iOS
Section intitulée « Comprendre les crash logs de production iOS »Continuer depuis Débogage
Section intitulée « Pour aller plus loin après le débogage »Si vous utilisez Débogage pour planifier le travail sur les plugins natifs, connectez-l’à Utiliser @capgo/capacitor-updater pour la capacité native dans « Utiliser @capgo/capacitor-updater », Capgo Répertoire des plugins pour le workflow produit dans Capgo Plugin Directory, Plugins Capacitor par Capgo pour les détails d'implémentation dans Plugins Capacitor par Capgo, Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Ajout ou mise à jour de plugins, et Alternatives aux plugins Ionic Enterprise pour le workflow produit dans Alternatives aux plugins Ionic Enterprise.