Dépannage

Voici quelques problèmes courants que vous pourriez rencontrer lors de l'utilisation de Capgo et comment les résoudre.

Besoin d'aide experte ?

Bloqué par un problème complexe ? Notre équipe d'experts est là pour vous aider ! Obtenez un soutien personnalisé, des code commentaires et des solutions personnalisées adaptées à vos besoins spécifiques.

Obtenez un soutien professionnel

Échecs d'importation

Si votre chargement de bundle échoue, vérifiez doublement :

• Votre ID d'application dans capacitor.config.ts correspond à votre application dans le tableau de bord Capgo
• Vous exécutez la commande de chargement depuis la racine de votre projet Capacitor
• Vos actifs web sont construits et à jour

Options de chargement avancées

Le Capgo CLI fournit quelques drapeaux supplémentaires pour aider avec les problèmes de chargement courants :

• --tus Utilise le protocole de chargement résilient tus pour des chargements plus fiables de grands bundles ou sur des connexions réseau défaillantes. Si votre bundle dépasse 10MB ou que vous êtes sur une connexion défaillante, envisagez d'utiliser --tus:

  npx @capgo/cli@latest bundle upload --tus

• --package-json et --node-modules: Indique à Capgo où trouver votre racine package.json et node_modules si votre application utilise une structure non standard comme un monorepo ou npm espace de travail. Transmettez le chemin de la racine package.json et le --node_modules chemin :

  npx @capgo/cli@latest bundle upload --package-json=path/to/package.json --node_modules=path/to/node_modules

  Capgo a besoin de ces informations pour empaqueter correctement les dépendances de votre application.

Vous pouvez combiner ces drapeaux avec d'autres options comme --channel selon vos besoins. Consultez le Capgo CLI documentation pour obtenir des informations détaillées sur les options d'upload disponibles.

Si vous rencontrez toujours des difficultés avec les uploads, contactez le Capgo support pour obtenir de l'aide supplémentaire.

Débogage des Mises à Jour

Si vous rencontrez des problèmes avec les mises à jour en temps réel, le commandement de débogage Capgo est un outil utile pour résoudre les problèmes. Pour l'utiliser :

1. Exécutez la commande suivante dans votre répertoire de projet :

   npx @capgo/cli@latest app debug

2. Lancez votre application sur un appareil ou un émulateur et effectuez l'action qui devrait déclencher une mise à jour (par exemple, rouvrir l'application après avoir téléchargé un nouveau bundle).

3. Observez les informations de sortie de la commande de débogage. Elle affichera des informations sur le processus d'actualisation, notamment :

   • Lorsque l'application vérifie une mise à jour
   • Si une mise à jour est trouvée et quelle est sa version
   • Le progrès de téléchargement et d'installation de la mise à jour
   • Toute erreur qui se produit pendant le processus d'actualisation

4. Utilisez les journaux de débogage pour identifier où se produit le problème. Par exemple :

   • Si aucune mise à jour n'est trouvée, vérifiez à nouveau que votre bundle a été téléchargé avec succès et que l'application est configurée pour utiliser le canal correct.
   • Si la mise à jour se télécharge mais ne s'installe pas, assurez-vous d'avoir appelé CapacitorUpdater.notifyAppReady() et que l'application a été complètement fermée et rouvert.
   • Si vous voyez un message d'erreur, consultez les documents Capgo ou contactez le support pour obtenir de l'aide.

La commande de débogage est particulièrement utile pour identifier les problèmes liés au téléchargement et à l'installation de la mise à jour. Si les journaux montrent que la version d'actualisation attendue a été trouvée mais n'a pas été appliquée, concentrez votre dépannage sur les étapes après le téléchargement.

Débogage avec les journaux natifs

En plus de la commande de débogage Capgo, les journaux natifs sur Android, iOS et Electron peuvent fournir des informations de dépannage précieuses, surtout pour les problèmes du côté natif du processus d'actualisation.

Journaux Android

Pour accéder aux journaux Android :

1. Connectez votre appareil ou lancez votre émulateur
2. Ouvrez Android Studio et sélectionnez « Vue > Outils de fenêtre > Logcat »
3. Dans la fenêtre Logcat, filtrez les journaux pour ne conserver que le processus de votre application en sélectionnant celui-ci dans le menu déroulant en haut
4. Recherchez les lignes qui contiennent Capgo pour trouver les journaux SDK

Alternativement, vous pouvez utiliser la adb logcat commande et utilisez grep pour Capgo To filtrer les journaux.

Le Capgo SDK enregistrera les événements clés pendant le processus d'actualisation, notamment :

• Lorsqu'une vérification d'actualisation est initiée
• Si une mise à jour est trouvée et quelle est sa version
• Lorsque le téléchargement de l'actualisation commence et se termine
• Lorsque l'installation de l'actualisation est déclenchée
• Tous les erreurs qui se produisent pendant les étapes d'actualisation natives

Les problèmes de connectivité réseau qui pourraient empêcher le téléchargement de l'actualisation

• Les erreurs de permissions de fichiers lors de la sauvegarde ou de la lecture du paquet d'actualisation
• L'espace de stockage insuffisant pour le paquet d'actualisation
• L'échec du redémarrage de l'application après l'installation de l'actualisation
• Les problèmes de connectivité réseau empêchant le téléchargement de l'actualisation

iOS Logs

Pour accéder aux journaux iOS :

1. Connectez votre appareil ou lancez votre simulateur
2. Ouvrez Xcode et allez à « Outils > Dispositifs et simulateurs »
3. Sélectionnez votre appareil et cliquez sur « Console ouverte »
4. Dans la sortie de la console, recherchez les lignes qui incluent Capgo pour trouver les journaux SDK

Vous pouvez également utiliser le log stream commande dans le terminal et grep pour Capgo pour filtrer les journaux.

De manière similaire à Android, les Capgo SDK enregistreront les événements clés côté iOS :

• Initiation et résultat de la vérification de mise à jour
• Début, progression et fin de téléchargement
• Déclencheur et résultat de l'installation
• Erreurs potentielles pendant le processus de mise à jour native

Les problèmes spécifiques à iOS que vous pourriez identifier dans les journaux incluent :

• Problèmes de certificat SSL lors du téléchargement de la mise à jour
• La mise à jour téléchargement est bloqué par la sécurité de transport de l'application
• Espace de stockage insuffisant pour le paquet de mise à jour
• Échec de l'extraction ou de l'application correcte du paquet de mise à jour

Journaux Electron

Pour les applications Electron, vérifiez les deux les sorties du processus principal et du processus de rendu :

1. Exécutez l'application Electron à partir de votre terminal en utilisant votre commande de lancement normale (par exemple bun run electron:dev ou bun run electron:serve). Observez les sorties du terminal pour les démarrages, les vérifications de mise à jour et les erreurs de réseau.
2. Ouvrez les Outils de développement dans la fenêtre de rendu (Affichage → Activer les Outils de développement) et inspectez les journaux de console et les requêtes réseau échouées tout en reproduisant le flux de mise à jour.
3. Pour les applications empaquetées, vérifiez les outils de journaux du système pour les plantages ou les échecs de démarrage :
   • macOS : ouvrezet filtrez sur le nom de votre application Console.app Windows : ouvrez
   • L'Explorateur d'événementsJournaux Windows __CAPGO_KEEP_0__ → __CAPGO_KEEP_1__ → Application
   • Linux: utilisez votre logiciel de visualisation de journaux de bureau ou journalctl pour le processus de votre application

Lorsque vous déboguez des mises à jour, comparez les messages provenant des journaux de processus principal et de processus de rendu pour séparer les problèmes d'initialisation d'Electron des problèmes de cycle de vie de mise à jour Capgo.

À travers les plateformes, les journaux natifs fournissent une vue d'ensemble plus détaillée du processus de mise à jour, avec plus de détails sur la mise en œuvre native. Ils sont particulièrement utiles pour identifier les problèmes qui se produisent en dehors de la couche JavaScript Capgo.

Lorsque vous résolvez un problème de mise à jour en direct difficile, il est une bonne idée de capturer les journaux de débogage Capgo et les journaux natifs pour obtenir une image complète de ce qui se passe. Les deux journaux ensemble vous donneront la meilleure chance d'identifier et de résoudre le problème.

Mises à jour non appliquées

Si vous avez téléchargé un bundle mais que vous ne voyez pas les changements sur votre appareil :

• Assurez-vous d'avoir appelé CapacitorUpdater.notifyAppReady() dans votre application code comme indiqué dans l'exemple ci-dessous. quickstart
• Vérifiez que votre appareil est connecté à Internet et que les journaux de débogage Capgo affichent que l'update a été téléchargé
• Essayez de fermer complètement et de rouvrir l'application, car les mises à jour ne sont appliquées qu'à la mise en route fraîche
• Recherchez tout erreur dans les journaux natifs qui pourrait indiquer un problème lors de l'application de la mise à jour

Consultez le guide pour plus de détails sur le processus de mise à jour. Si vous êtes toujours bloqué, utilisez le commande et les journaux natifs pour obtenir plus de visibilité sur ce qui se passe. npx @capgo/cli@latest app debug Codes d'erreur de mise à jour courants

Si vos journaux montrent des erreurs de serveur telles que

ou disable_auto_update_to_major, semver_error, or cannot_update_via_private_channelUtilisez le guide dédié :

• Problèmes de mise à jour courants

Cela explique ce que chaque problème courant code signifie, pourquoi cela se produit et comment le résoudre.

Installation de SDK

Si vous rencontrez des difficultés pour installer le Capgo SDK, assurez-vous que :

• Votre application utilise une version prise en charge de Capacitor (4.0 ou ultérieure)
• Vous avez suivi les étapes de démarrage rapide dans l'ordre, y compris la synchronisation de votre application après l'installation de __CAPGO_KEEP_0__ Intégration CI/CD steps in order, including syncing your app after installing the SDK

Intégration CI/CD

Pour les problèmes liés à l'activation des Capgo téléchargements à partir de votre pipeline CI/CD :

• Vérifiez que votre jeton d'authentification Capgo est configuré correctement
• Assurez-vous d'exécuter la commande de téléchargement après que vos actifs web soient construits
• Vérifiez que la commande de téléchargement utilise le nom de canal correct pour votre environnement cible

Consultez la section Intégration CI/CD pour plus de conseils de dépannage. Vous pouvez également utiliser la npx @capgo/cli@latest app debug commande

pour confirmer si vos mises à jour déclenchées par CI/CD sont reçues par l'application.

Si vous utilisez la section Troubleshooting pour planifier le stockage et la gestion des fichiers, connectez-le à @capgo/capacitor-data-storage-sqlite pour les détails d'implémentation dans @capgo/capacitor-data-storage-sqlite, En utilisant @capgo/capacitor-data-storage-sqlite pour la capacité native dans En utilisant @capgo/capacitor-data-storage-sqlite, @capgo/capacitor-file pour les détails d'implémentation dans @capgo/capacitor-file, En utilisant @capgo/capacitor-file pour la capacité native dans En utilisant @capgo/capacitor-file, et @capgo/capacitor-uploader pour les détails d'implémentation dans @capgo/capacitor-uploader.