Troubleshooting

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

🚀 Besoin d'aide experte ?

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

Aide professionnelle

Échecs d'upload

Si votre upload de bundle échoue, vérifiez :

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

Options d'upload avancées

The Capgo CLI fournit quelques drapeaux supplémentaires pour aider à résoudre les problèmes d'importation courants :

• --tus: Utilise le protocole d'importation résiliente « tus » pour des importations plus fiables de gros paquets ou sur des connexions réseau défaillantes. Si votre paquet dépasse 10 Mo ou que vous êtes sur une connexion défaillante, envisagez d'utiliser Fenêtre de terminal --tus:

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

• --package-json : Indique à __CAPGO_KEEP_0__ où trouver le répertoire racine --node-modules: Tells Capgo where to find your root package.json si votre application utilise une structure non standard comme un monorepo ou un espace de travail __CAPGO_KEEP_0__. Spécifiez le chemin du répertoire racine node_modules if your app uses a non-standard structure like a monorepo or npm workspace. Pass the path to the root package.json chemin : --node_modules path:

  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 bundler correctement les dépendances de votre application.

Vous pouvez combiner ces drapeaux avec d'autres options comme --channel selon vos besoins. Consultez les Capgo CLI docs pour obtenir des informations complètes sur les options d'upload disponibles.

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

Mise à jour de débogage

Si vous rencontrez des problèmes avec les mises à jour en direct, la commande 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. Regardez la sortie de la commande de débogage. Elle affichera des informations sur le processus de mise à jour, notamment :

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

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 l'update télécharge mais ne s'installe pas, assurez-vous d'avoir appelé CapacitorUpdater.notifyAppReady() et que l'application était complètement fermée et rouvert.
   • Si vous voyez un message d'erreur, consultez les docs 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 l'update. Si les journaux montrent que la version d'update attendue a été trouvée mais n'a pas été appliquée finalement, concentrez votre dépannage sur les étapes après le téléchargement.

Débogage avec les Journaux Natives

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'update.

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. In la fenêtre Logcat, filtrez les journaux pour n'afficher 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 grep pour Capgo filtrer les journaux.

Les journaux Capgo SDK enregistreront 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 la mise à jour commence et se termine
• Lorsque l'installation de la mise à jour est déclenchée
• Tous les erreurs qui se produisent pendant les étapes d'actualisation natives

Problèmes Android spécifiques que vous pourriez voir dans les journaux incluent :

• Problèmes de connectivité réseau empêchant le téléchargement de mise à jour
• Erreurs de droits de fichiers lors de la sauvegarde ou de la lecture du bundle de mise à jour
• Manque de place de stockage pour le bundle de mise à jour
• Échec du redémarrage de l'application après l'installation de la mise à jour

Journaux iOS

Pour accéder aux journaux iOS :

1. Connectez votre appareil ou lancez votre simulateur
2. Ouvrez Xcode et allez à « Fenêtre > Dispositifs et simulateurs »
3. Sélectionnez votre appareil et cliquez sur « Ouvrir la console »
4. Dans la sortie de la console, cherchez toute ligne qui inclut Capgo pour trouver les journaux SDK

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

De même que sur Android, le Capgo SDK enregistrera les événements clés côté iOS :

• Lancement et résultat de la vérification des mises à jour
• Début, progression et fin de la téléchargement
• Déclenchement et résultat de l'installation
• Tout problème rencontré lors du processus d'actualisation native

Problèmes SSL liés au certificat lors du téléchargement de la mise à jour

• Blocage de la téléchargement de mise à jour par la sécurité de transport de l'application
• Problèmes spécifiques à iOS que vous pourriez identifier dans les journaux :
• Espace de stockage insuffisant pour le bundle de mise à jour
• Échec de l'extraction ou de l'application correcte du bundle de mise à jour

Journaux d'Electron

Pour les applications Electron, vérifiez les deux processus principaux et de rendu :

1. Exécutez l'application Electron à partir de votre terminal en utilisant votre commande de lancement normal (par exemple bun run electron:dev ou bun run electron:serve) et observez la sortie du terminal pour les démarrages, les contrôles de mise à jour et les erreurs de réseau.
2. Ouvrez les Outils de développement dans la fenêtre de rendu (Vue → Activer les Outils de développement) et inspectez les journaux de console et les requêtes réseau échouées pendant la reproduction de la 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: ouvrir Console.app et filtrez sur le nom de votre application
   • Windows: ouvrir Consulter les journaux d'événement → Journaux Windows → 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 de démarrage d'Electron des problèmes de cycle de mise à jour de Capgo.

Sur plusieurs 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 de 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 de 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 qui ne s'appliquent pas

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 montré dans le quickstart
• Vérifiez que votre appareil est connecté à Internet et que les journaux de débogage Capgo montrent 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 première mise en route
• Recherchez tout erreur dans les journaux natifs qui pourrait indiquer un problème pour appliquer la mise à jour

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

Codes d'erreur de mise à jour courants

Si vos journaux montrent des erreurs de serveur telles que disable_auto_update_to_major, semver_errorou cannot_update_via_private_channelutilisez le guide dédié :

• Problèmes de mise à jour courants

Il explique ce que chaque code code courant signifie, pourquoi cela se produit et comment le résoudre.

SDK Installation

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

• 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 l'__CAPGO_KEEP_0__ démarrage rapide Vous avez suivi les étapes de démarrage rapide dans l'ordre, y compris la synchronisation de votre application après l'installation de l'SDK

Intégration CI/CD

Pour les problèmes liés à la mise en œuvre de l'Capgo des téléchargements depuis votre pipeline CI/CD :

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

Consultez les docs d'intégration CI/CD pour plus de conseils de dépannage. Vous pouvez également utiliser les npx @capgo/cli@latest app debug commande pour confirmer si vos mises à jour déclenchées par votre CI/CD sont bien reçues par l'application.

Continuez de Troubleshooting

Si vous utilisez Troubleshooting pour planifier le stockage et la gestion de fichiers, connectez-le avec @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, Utiliser @capgo/capacitor-fichier pour la capacité native dans Utiliser @capgo/capacitor-fichier, et @capgo/capacitor-téléchargeur pour le détail d'implémentation dans @capgo/capacitor-téléchargeur.