• 20 heures
  • Facile

Ce cours est visible gratuitement en ligne.

course.header.alt.is_certifying

J'ai tout compris !

Mis à jour le 24/10/2023

Débuguez avec Blueprint

Debugging Controls

Débuguer est le processus de recherche permettant de trouver et de retirer un bug d’un programme.

Vous voyez de quoi je parle ? Ce truc qui fait que votre jeu ne marche pas comme prévu et vous ne savez pas pourquoi ! o_O

Dans ce chapitre, je vais vous présenter un ensemble de techniques faciles à appliquer à vos projets. Car oui, autant vous faire une raison, vous n’échapperez pas aux bugs !

Debugging Controls

Le Debugging Controls est une console qui permet de visualiser en temps réel l’exécution de votre code. Cette fonctionnalité est activée par défaut. Pour y accéder, il faut séparer la fenêtre du jeu et celle du Blueprint Editor à débuguer. Scindez l'Unreal Engine 4 en deux, mettez l'éditeur sur la gauche et la classe Blueprint sur la droite. Je me doute que vous n'avez pas tous la chance d'avoir deux écrans comme moi, mais le but est d'afficher les deux fenêtres côte à côte. Lancez ensuite le jeu avec « Play ».

Les lignes pointillées oranges représentes les actions qui sont en train d’être effectuées. Il est bien sûr possible de mettre en pause le jeu afin de débuguer. Pour cela, cliquez sur le bouton « Pause » situé en haut.

Observer la valeur d’une variable

Pour observer la valeur d’une variable, faites un clic droit sur le rond puis cliquez sur « Watch this value » .

À présent, si vous lancez le jeu et que vous jetez un oeil sur cette variable à partir du Blueprint Editor, vous verrez la valeur de votre variable se mette à jour en fonction de vos événements.

Les breakpoints

Les breakpoints (points d’arrêt en français) permettent de mettre en pause le jeu pendant une action précise. Il est possible de mettre autant de breakpoints que nécessaire.

Exemple d’un Breakpoints sur un Print String
Exemple d’un Breakpoints sur un Print String

Le rond rouge montre qu’un breakpoint existe sur cette fonction. Quand la fonction Print String sera exécutée, le jeu se mettra alors en pause. Essayons de montrer un exemple concret avec notre classe « SuperScaler ».

Effectuez un clic droit sur la fonction « Set Actor Scale 3D » puis cliquez sur « Add breakpoint »

Vous pouvez maintenant lancer le jeu en appuyant sur le bouton « Play ». Rentrez maintenant dans le trigger pour exécuter la fonction « Set Actor Scale 3D ».

Quand l’action s’exécutera, vous observerez une flèche rouge au-dessus de celle-ci. Vous pouvez à ce moment-là visualiser d’autres variables en cliquant dessus puis sur « Watch this value ».

Vous pouvez relancer votre jeu en cliquant sur « Resume » situé en haut. Il est bien sûr possible de supprimer un breakpoint en cliquant sur la fonction puis « Remove breakpoint ».

Il est également possible de visualiser tout ce qui est exécuté par l’Unreal Engine 4. Pour cela, cliquez sur Window dans le menu d’UE4, Developer Tools puis sur « Blueprints Debugger ».

En lançant le jeu, vous observerez l’exécution des différentes actions que vous réalisez. Il est bien sûr possible de voir à partir du blueprint debugger les valeurs des variables ou des breakpoints

Nous nous arrêterons là pour cette partie. Il existe beaucoup de procédés pour débugger son programme. Je vous ai présenté ici les plus fréquemment utilisés. 

Exemple de certificat de réussite
Exemple de certificat de réussite