Déboguer JavaScript dans Qt Creator

Imprimer vers la console

La méthode privilégiée pour déboguer vos applications AppStudio consiste à utiliser le système de messagerie console.log dans votre code QML car ces messages s’affichent dans la console Qt Creator et sont les mêmes pour toutes les plateformes. Cette méthode fonctionne sans installer le kit Qt. Seul AppStudio est requis.

Pour exécuter votre application dans Qt Creator, cliquez sur Run (Exécuter) dans le menu Tools (Outils) > External (Externe) > AppStudio. Vous pouvez également appuyer sur les touches Alt+Maj+R du clavier ou cliquer sur le bouton Run (Exécuter) en bas à gauche de la fenêtre Qt Creator.

Mode débogage de Qt Creator

La version de Qt Creator associée à AppStudio version 4.0 offre un accès immédiat aux outils de débogage de Qt Creator. Pour ouvrir votre application en mode débogage, appuyez sur la touche F5 dans Qt Creator ou cliquez sur le bouton Start debugging of startup project (Démarrer le débogage du projet de démarrage) en bas à gauche de la fenêtre Qt Creator.

Reportez-vous à la page Interaction avec le débogueur de la documentation Qt pour en savoir plus sur l’utilisation des outils de débogage dans Qt Creator.

Remarque :

La documentation Qt inclut des informations sur le débogage de C++, mais une licence SDK Qt est requise pour utiliser ce langage. Cette licence n’est pas fournie avec AppStudio.

Points d'arrêt

Des points d’arrêt peuvent être utilisés dans Qt Creator pour interrompre votre application une fois qu’elle a atteint des lignes de code spécifiques et vous en donner le contrôle. Vous pouvez alors examiner l’état de l’application et poursuivre l’exécution ligne par ligne ou en continu.

Vous pouvez insérer un point d’arrêt dans votre application de différentes manières :

• Appuyez sur la touche F9 (F8 sur macOS) après avoir placé le pointeur de texte sur la ligne où vous souhaitez insérer le point d’arrêt.
• Cliquez sur l’espace à gauche du numéro de ligne.
• Double-cliquez sur la partie vide de la vue Breakpoints (Points d’arrêt), puis spécifiez un numéro de ligne dans la fenêtre Add Breakpoints (Ajouter des points d’arrêt) qui apparaît.
• Sélectionnez Add Breakpoint (Ajouter un point d’arrêt) dans la vue Breakpoints (Points d’arrêt), puis spécifiez un numéro de ligne dans la fenêtre Add Breakpoints (Ajouter des points d’arrêt) qui apparaît.

Votre application s’arrêtera maintenant au point où vous avez défini le point d’arrêt et le débogueur de Qt Creator vous proposera des options pour reprendre normalement l’exécution, arrêter l’application ou passer à une autre ligne de code.

Pour ouvrir la fenêtre Edit Breakpoints (Mettre à jour des points d’arrêt), double-cliquez sur le point d’arrêt dans la vue Breakpoints (Points d’arrêt) ou cliquez avec le bouton droit sur le point d’arrêt dans la vue du code, puis cliquez sur Edit Breakpoint (Mettre à jour le point d’arrêt). Dans cette fenêtre, vous pouvez définir différents types de point d’arrêt, ainsi que les conditions avant que l’application ne s’arrête au point d’arrêt, le nombre de fois que le point d’arrêt sera ignoré avant d’arrêter l’application et les commandes à transmettre automatiquement une fois que le point d’arrêt est atteint.

Pour déplacer un point d’arrêt, sélectionnez-le, puis faites-le glisser vers l’emplacement de votre choix. Pour supprimer un point d’arrêt, appuyez de nouveau sur la touche F9 (F8 sur macOS), cliquez sur l’icône du point d’arrêt ou cliquez avec le bouton droit sur le point d’arrêt et sélectionnez Delete Selected Breakpoints (Supprimer les points d’arrêt sélectionnés) ou Delete All Breakpoints (Supprimer tous les points d’arrêt).

Pour plus d’informations sur les points d’arrêt, voir Définition de points d’arrêt dans la documentation Qt.

Profileur QML

En plus de générer éventuellement des erreurs inattendues qui empêchent une application de fonctionner comme prévu, JavaScript peut également être à l’origine d’une baisse des performances d’une application QML. Une exécution excessive de JavaScript pendant une brève période peut par exemple entraîner des délais ou supprimer des images. Vous pouvez utiliser l’outil Profileur QML pour rechercher le motif de ces baisses de performances en surveillant des données telles que les fonctions JavaScript en cours d’utilisation, la quantité de mémoire utilisée et les événements en entrée.

Pour activer le Profileur QML, assurez-vous au préalable que votre application n’exécute pas actuellement Qt Creator. Ensuite, à l’aide de la vue Project (Projet) de votre application, sélectionnez Analyze (Analyser) > QML Profiler (Profileur QML). Votre application s’ouvre et la section QML Profiler (Profileur QML) s’ouvre derrière dans Qt Creator. Effectuez les actions de votre application à profiler, puis cliquez sur Stop (Arrêter) dans la section QML Profiler (Profileur QML). La section QML Profiler (Profileur QML) fournit un Scene Graph (Graphe de scène) du comportement de votre application. La vue de votre code affiche également, en pourcentages, le temps passé par votre application à exécuter chaque portion de son code.

Pour plus d’informations sur le Profileur QML, voir Profilage des applications QML dans la documentation Qt.