Résoudre les problèmes

Ici, vous trouverez 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 coincé avec un problème complexe ? Notre équipe d'experts est là pour vous aider ! Obtenez un soutien personnalisé, des code examens, et des solutions personnalisées adaptées à vos besoins spécifiques.

Obtenez un soutien professionnel

Échecs d'upload

Si votre envoi de bundle échoue, vérifiez bien :

• Votre ID d'application correspond à celle de votre application dans le tableau de bord de __CAPGO_KEEP_0__ capacitor.config.ts Vous exécutez la commande d'upload depuis la racine de votre projet Capgo
• You’re running the upload command from the root of your Capacitor project
• Vos actifs web sont construits et à jour

Options d'upload avancées

Le Capgo CLI fournit quelques drapeaux supplémentaires pour aider avec les problèmes d'upload courants:

• --tus : Utilise le protocole d'upload résilient tus pour des uploads plus fiables de gros ensembles ou sur des connexions réseau défaillantes. Si votre ensemble est supérieur à 10 Mo ou que vous êtes sur une connexion défaillante, considérez l'utilisation de --tus:

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

• --package-json et --node-modules: Tells Capgo where to find your root package.json : Indique à __CAPGO_KEEP_0__ où trouver votre racine «  node_modules Si votre application utilise une structure non standard comme un monorepo ou un espace de travail npm. 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 assembler 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 détaillées sur les options de téléchargement disponibles.

Si vous continuez à rencontrer des problèmes avec les téléchargements, contactez le Capgo support Pour obtenir de l'aide supplémentaire.

Diagnostic des Mises à Jour

Si vous rencontrez des problèmes avec les mises à jour en direct, 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. 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
   • Progression de téléchargement et d'installation de la mise à jour
   • Les erreurs qui se produisent 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 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 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 à la 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 finalement, 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

To 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 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 le adb logcat commande et grep pour filtrer les journaux. Capgo Les journaux __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ enregistreront les événements clés pendant le processus de mise à jour, comme :

The Capgo SDK will log key events during the update process, such as:

• Si une mise à jour est trouvée et quelle est sa version
• Connecter votre appareil ou démarrer votre émulateur Android
• Lorsque le téléchargement de mise à jour commence et se termine
• Lorsque l'installation de mise à jour est déclenchée
• Tous les erreurs qui se produisent lors des étapes de mise à jour natives

Les problèmes de connectivité réseau empêchant le téléchargement de mise à jour

• Les erreurs de permissions 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 de redémarrage de l'application après l'installation de la mise à jour
• Journaux iOS

Section intitulée « Journaux iOS »

Connectez votre appareil ou lancez votre simulateur

1. Lorsque le téléchargement de mise à jour commence et se termine
2. Ouvrez Xcode et allez à « Fenêtres > Dispositifs et simulateurs »
3. Sélectionnez votre appareil et cliquez sur « Ouvrir la console »
4. Dans la sortie de la console, recherchez les lignes qui incluent Capgo pour trouver les journaux SDK

Vous pouvez également utiliser la log stream commande dans le terminal 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 :

• Initiation et résultat de la vérification de mise à jour
• Début, progression et fin de téléchargement
• Déclenchement et résultat de l'installation
• Toute erreur survenue pendant le processus d'actualisation native

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 sécurité de transport de l'application bloque le téléchargement de la mise à jour
• 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 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 normal (par exemple bun run electron:dev ou bun run electron:serveExécutez l'application Electron à partir de votre terminal en utilisant votre commande de lancement normal (par exemple
2. et observez les sorties du terminal pour les démarrages, les vérifications de mise à jour et les erreurs de réseau.
3. Pour les applications empaquetées, vérifiez les outils de journalisation du système pour les plantages ou les échecs de démarrage :
   • macOS: ouvrir Console.app et filtrer sur votre nom d'application
   • Windows: ouvrir Consuleur d'événements → Journaux de Windows → Application
   • Linux: utilisez votre visionneuse de journaux de bureau ou journalctl pour le processus de votre application

Quand vous déboguez les 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 vie de mise à jour Capgo.

À travers les plateformes, les journaux natifs offrent une vue d'ensemble plus détaillée sur le 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 déboguez 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 ne voyez pas les changements sur votre appareil :

• Assurez-vous d'avoir appelé CapacitorUpdater.notifyAppReady() code dans votre application, 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 les erreurs dans les journaux natifs qui pourraient indiquer un problème d'application de la mise à jour

Consultez le guide de mise en ligne d'actualisations en direct pour plus de détails sur le processus d'actualisation. Si vous êtes toujours bloqué, utilisez la commande et les journaux natifs pour obtenir plus de visibilité sur ce qui se passe. guide de déploiement d'actualisations en direct détails sur le processus d'actualisation npx @capgo/cli@latest app debug commande et les journaux natifs

Codes d'erreur courants d'actualisation

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 d'actualisation courants

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

SDK Installation

Si vous rencontrez 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 la quickstart étape par étape, y compris la synchronisation de votre application après l'installation de SDK

Intégration CI/CD

For issues with triggering Capgo uploads from your CI/CD pipeline:

• Pour les problèmes liés à l'activation des téléchargements Capgo à partir de votre pipeline CI/CD :
• Vérifiez que votre jeton d'authentification __CAPGO_KEEP_0__ est configuré correctement
• Assurez-vous d'exécuter la commande de téléchargement après la construction de vos actifs web 

Consultez les docs sur l'intégration CI/CD pour obtenir plus de conseils de dépannage. Vous pouvez également utiliser le 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.

Continuez de la section Dépannage

Si vous utilisez Dépannage contexte: Page/zone : Support / page de support premium ou section de support du pied de page. Rôle : En-tête de section ou de page. Vu dans : page support-policy.astro. Clé de message `support_policy_troubleshooting_title` (Titre de la politique de support de dépannage). @capgo/capacitor-data-storage-sqlite @capgo/capacitor-data-storage-sqlite pour les détails d'implémentation dans @capgo/capacitor-data-storage-sqlite, » : « Utilisez @capgo/capacitor-data-storage-sqlite pour la capacité native dans l'utilisation de @capgo/capacitor-data-storage-sqlite, @capgo/capacitor-fichier pour le détail d'implémentation dans @capgo/capacitor-fichier, En utilisant @capgo/capacitor-fichier pour la capacité native dans l'utilisation de @capgo/capacitor-fichier, et @capgo/capacitor-téléchargeur pour le détail d'implémentation dans @capgo/capacitor-téléchargeur.