Aperçu des outils de débogage

Ce guide vous donnera un aperçu des outils de débogage disponibles dans le moteur.

Godot est doté d'un puissant débogueur et de profileurs qui permettent de repérer les bogues, d'inspecter votre jeu à l'exécution, de surveiller les paramètres essentiels et de mesurer les performances. Il offre également des options permettant de visualiser les boîtes de collision et les polygones de navigation dans le jeu en cours d'exécution.

Enfin, vous avez la possibilité de déboguer le jeu en cours d'exécution sur un appareil distant et de recharger les modifications apportées à vos scènes ou à votre code pendant le déroulement du jeu.

Panneau de débogage

De nombreux outils de débogage de Godot font partie du panneau de débogage, sur lequel vous pouvez trouver des informations dans Panneau de débogage.

Options du menu de débogage

Il existe quelques options de débogage courantes que vous pouvez activer ou désactiver lorsque vous exécutez votre jeu dans l'éditeur, ce qui peut vous aider à déboguer votre jeu.

Vous pouvez trouver ces options dans le menu de l'éditeur Debug.

../../_images/overview_debug.png

Voici les descriptions des options :

Déployer avec le débogage distant

Lors de l'exportation et du déploiement, l'exécutable résultant tentera de se connecter à l'IP de votre ordinateur pour le débogage.

Déploiement minime avec système de fichier réseau

Cette option accélère les tests pour les jeux avec une grande empreinte sur les appareils distants.

Lorsque Small Deploy with Network FS est activé, au lieu d'exporter le jeu complet, le déploiement du jeu crée un exécutable minimal. L'éditeur fournit ensuite les fichiers du projet sur le réseau.

De plus, sur Android, le jeu est déployé à l'aide du câble USB pour accélérer le déploiement.

Formes de collision visibles

Cette option rend visibles les formes de collision et les nœuds de raycast dans le jeu en cours d’exécution.

Navigation visible

Les maillages de navigation et les polygones seront visibles sur le jeu en cours d’exécution.

Synchroniser les modifications des scènes

Avec cette option, toute modification apportée à une scène dans l'éditeur au moment de l'exécution apparaît instantanément. Lorsqu'il est utilisé à distance sur un appareil, cela est plus efficace avec le système de fichiers réseau.

Synchroniser les modifications des scripts

Tout script sauvegardé sera rechargé sur le jeu en cours d’exécution. Lorsqu'il est utilisé à distance sur un appareil, ce système est plus efficace avec le système de fichiers du réseau.

Outils et options de débogage de l'éditeur de script

L'éditeur de script possède son propre ensemble d'outils de débogage à utiliser avec les points d'arrêt(breakpoints) et deux options. Les outils de points d'arrêt se trouvent également dans l'onglet Debugger du débogueur.

../../_images/overview_script_editor.png

Le bouton Break provoque une rupture dans le script comme le ferait un point d'arrêt. Le bouton Continue permet de continuer le jeu après une pause à un point d'arrêt. Step Over passe à la ligne de code suivante, et Step Into passe dans une fonction si possible. Sinon, il fait la même chose que Step Over.

L'option Keep Debugger Open permet de garder le débogueur ouvert après la fermeture d'une scène. Et l'option Debug with External Editor vous permet de déboguer votre jeu avec un éditeur externe.

Paramètres de débogage du projet

Dans les paramètres du projet, il y a une catégorie Debug avec trois sous-catégories qui contrôlent différentes choses.

Réglages

Il s'agit de quelques paramètres généraux tels que l'impression du FPS actuel sur le panneau Output, le nombre maximum de fonctions lors du profilage et autres.

GDScript

Ces paramètres vous permettent d'activer/désactiver des avertissements GDScript spécifiques, par exemple pour les variables non utilisées. Vous pouvez également désactiver complètement les avertissements.

Formes

Les formes permettent d'ajuster la couleur des formes qui n'apparaissent qu'à des fins de débogage, telles que les formes de collision et de navigation.

Remote dans le dock de scène

Lorsque vous lancez un jeu dans l'éditeur, deux options apparaissent en haut du dock Scene, Remote et Local. En utilisant Remote, vous pouvez inspecter ou modifier les paramètres des nœuds dans le projet en cours d'exécution.

../../_images/overview_remote.png

Note

Certains paramètres de l'éditeur relatifs au débogage se trouvent dans les Paramètres de l'éditeur, sous les sections Network > Debug et Debugger.