Que recherchez-vous ?
Hero background image
Accélérer le débogage avec Microsoft Visual Studio Code

Unity prend en charge un grand nombre d'éditeurs de code, notamment Microsoft Visual Studio et Visual Studio Code, JetBrains Rider et Atom.

Microsoft Visual Studio Code (VS Code) est une alternative légère à Visual Studio qui fournit un IDE extensible multiplateforme, ainsi qu'un riche écosystème d'extensions qui peuvent être installées pour ajouter des fonctionnalités et personnaliser l'IDE. Son utilisation est gratuite en tant que logiciel libre, ce qui en fait une option intéressante pour les développeurs disposant d'un budget limité.

Microsoft propose également une extension Unity qui offre aux développeurs C# une expérience de développement Unity rationalisée sur Visual Studio Code.

package-manager-visual-studio
INSTALLER L'ÉDITEUR VISUAL STUDIO À PARTIR DU GESTIONNAIRE DE PAQUETS
Installer le paquetage Unity de l'éditeur de Visual Studio

VS Code fonctionne avec de nombreuses extensions disponibles pour fonctionner comme un véritable IDE.

Vous devrez suivre plusieurs étapes pour utiliser VS Code dans Unity.

Tout d'abord, téléchargez et installez Visual Studio Code à partir du site web, où vous trouverez des versions pour Windows, macOS et Linux.

Après avoir installé VS Code, récupérez le package Visual Studio Editor pour Unity. Dans la fenêtre du gestionnaire de paquets, assurez-vous d'installer. Si vous disposez d'une version plus ancienne du paquet, passez à la version 2.0.20 ou à une version plus récente.

Le package Visual Studio Editor prend désormais en charge toute la famille des produits Visual Studio. Veillez à ne pas le confondre avec le paquet nommé Visual Studio Code Editor, qui n'est plus pris en charge.

visualcode-1
SÉLECTIONNER VS CODE COMME ÉDITEUR DE SCRIPT EXTERNE
Configurer VS Code pour Unity

Après avoir installé VS Code et le paquetage Visual Studio Editor, vous devrez définir VS Code comme éditeur de script externe.

Faites-le via Unity > Préférences > Outils externes dans l'éditeur. Sous Éditeur de script externe, choisissez Visual Studio Code dans le menu déroulant. Si VS Code n'apparaît pas dans la liste, cliquez sur Parcourir et localisez l'exécutable VS Code sur votre système. La prochaine fois que vous ouvrirez un fichier C# dans Unity, Visual Studio Code s'ouvrira pour vous.

visual-studio-code-extension
L'EXTENSION UNITY POUR VISUAL STUDIO CODE EST DISPONIBLE SUR LA PLACE DE MARCHÉ DE VISUAL STUDIO.
Installer l'extension VS Code

L'étape suivante consiste à installer l'extension Unity pour Visual Studio Code, qui offre une expérience de développement Unity simplifiée. Il s'appuie sur les riches possibilités offertes par le kit de développement C# et les extensions C#, et s'intègre nativement à Visual Studio Code.

Les principales caractéristiques sont les suivantes :

- Un débogueur pour votre éditeur Unity et vos joueurs

- Analyseurs et refactorings C# spécifiques à l'unité

- Coloration du code pour les formats de fichiers Unity (.asmdef, .shader, .uss, .uxml)

Allez sur le marché Visual Studio pour obtenir l'extension. Après l'avoir téléchargé, une fenêtre vous invite à l'ouvrir dans l'application Visual Studio Code. VS Code installera alors les extensions Unity, y compris le kit de développement C# et les extensions C#.

Une fois installé, vous pouvez configurer l'environnement du kit de développement C#.

debugging-in-visual-code
DÉBOGAGE DANS VS CODE
Débogage à l'aide de VS Code

Il existe un bouton Play dans la barre d'outils gauche de l'éditeur VS Code qui est marqué d'une icône de bug. En cliquant sur ce bouton, vous ouvrirez la vue Exécution et débogage. En haut de cette vue se trouve un bouton Play et une liste déroulante d'options de lancement provenant du fichier launch.json. Sélectionnez Unity Editor (il devrait déjà être sélectionné par défaut puisqu'il s'agit de la première option de lancement).

La vue Exécution et débogage comprend cinq fenêtres permettant d'examiner l'état de votre programme : Locals, Watch, Call Stack, Breakpoints et Exception Breakpoints (cette dernière option n'est généralement pas utilisée aussi fréquemment que les quatre autres). Ces fenêtres vous permettent d'inspecter votre code et de comprendre l'état actuel de votre application pendant le débogage. Elles fonctionnent de la même manière que les fenêtres de débogage de Visual Studio.

Ajoutez des points d'arrêt en cliquant dans la marge ou en appuyant sur F9 lorsque la ligne de point d'arrêt est sélectionnée dans le code que vous souhaitez tester. Les points d'arrêt dans la marge de l'éditeur sont représentés par des cercles rouges pleins.

Les points d'arrêt peuvent être modifiés par un clic droit et des conditions peuvent être ajoutées pour contrôler l'interruption du programme. Lorsque l'exécution du programme est interrompue dans VS Code, une barre d'outils est ajoutée à la vue (similaire à Visual Studio). La barre d'outils propose les boutons suivants :

- Lecture/Pause (F6)

- Passer à l'étape suivante (F10)

- Entrer (F11)

- Step Out (⇧F11)

- Redémarrer : Ctrl⇧F5 (Windows) et ⇧⌘F5 (macOS).

- Arrêter le débogage (⇧F5)

Pour en savoir plus sur la barre d'outils de VS Code, consultez la documentation de VS Code, et regardez cette vidéo pour plus d'astuces.

visualcode
LES FENÊTRES DE DÉBOGAGE DANS VS CODE
Exploiter les fenêtres de débogage

Locale
La fenêtre locale affiche les valeurs de toutes les variables locales dans le champ d'application actuel où l'exécution est interrompue. Cela inclut les variables déclarées dans la méthode ou la fonction que vous êtes en train de déboguer, ce qui vous permet d'inspecter les valeurs des variables au point actuel de l'exécution de votre code.

Regarder
La fenêtre de surveillance vous permet d'ajouter des variables ou des expressions spécifiques que vous souhaitez surveiller pendant le processus de débogage en ajoutant manuellement n'importe quelle variable ou expression à la surveillance. Vous pouvez voir les valeurs mises à jour au fur et à mesure que vous avancez dans le code, une fonction utile lorsque vous souhaitez garder une trace de variables ou d'expressions spécifiques tout au long de la session de débogage, même si elles ne sont pas dans le champ d'application actuel.

Pile d'appels
La fenêtre Pile d'appel est utile pour comprendre le flux de votre code et identifier comment un morceau de code particulier a été atteint. Elle montre la séquence des appels de méthodes ou de fonctions qui ont conduit au point d'exécution actuel, chaque entrée de la pile d'appels représentant un appel de méthode ou de fonction et l'appel le plus récent se trouvant en haut de la pile. Vous pouvez cliquer sur n'importe quelle entrée de la pile d'appels pour naviguer vers le code correspondant dans votre projet et afficher les variables locales à ce stade de l'exécution.

Point d'arrêt
La fenêtre Point d'arrêt affiche une liste de tous les points d'arrêt que vous avez définis dans votre code. Les points d'arrêt sont les marqueurs que vous placez dans votre code pour interrompre l'exécution lorsqu'une ligne particulière est atteinte. Cette fenêtre vous permet d'activer ou de désactiver les points d'arrêt, de les supprimer ou de naviguer jusqu'à la ligne de code correspondante dans votre projet. Cette fonction est utile pour gérer vos points d'arrêt (si vous en avez plusieurs) et pour accéder rapidement à des endroits spécifiques de votre code où vous souhaitez interrompre l'exécution.

Write_Clean_Code
Plus de ressources pour les créateurs avancés d'Unity

Prévoyez-vous d'utiliser un autre éditeur de code ? Vous pouvez lire notre article sur Microsoft Visual Studio 2022.

Augmentez la productivité de votre équipe grâce à notre e-book Créez un guide de style C# : Écrire un code plus propre et évolutif. Obtenez des conseils d'experts de l'industrie sur la façon de créer un guide de style de code pour aider votre équipe à développer une base de code propre, lisible et évolutive.

Vous trouverez de nombreux autres conseils de productivité dans 70+ astuces pour augmenter la productivité avec Unity. Améliorez votre flux de travail quotidien avec Unity 2020 LTS, y compris les astuces que même les développeurs expérimentés ont pu manquer.

Retrouvez tous les e-books et articles avancés d'Unity dans le hub des meilleures pratiques d'Unity.

Vous avez aimé ce contenu ?