Démarrage rapide : Visual Studio Tools pour Unreal Engine

Dans cet article, téléchargez un exemple de jeu Unreal Engine (UE) et configurez Visual Studio Tools pour Unreal Engine. Visual Studio Tools pour Unreal Engine est une extension gratuite qui vous aide à développer des jeux avec Unreal Engine. Il fournit des fonctionnalités qui améliorent l’expérience de développement d’Unreal Engine dans Visual Studio.

Prérequis

Les éléments suivants doivent être installés :

• Visual Studio version 17.10 ou ultérieure.
• Unreal Engine version 5 ou supérieure car l'exemple utilisé dans cet article nécessite Unreal Engine 5 ou supérieur.
• Visual Studio Tools pour Unreal Engine. Pour obtenir des instructions sur l’installation, consultez Installer Visual Studio Tools pour Unreal Engine.

Télécharger et générer l’exemple de jeu Lyra dans Visual Studio

Lyra est un exemple de projet de jeu permettant de se familiariser avec Unreal Engine. Consultez la section Télécharger le jeu Lyra Starter dans Exemple de jeu Lyra pour obtenir des instructions de téléchargement. Si vous l’avez acquis via l’installation du code source de Unreal Engine, cette version ne contient pas les ressources requises pour générer et exécuter le jeu. Utilisez les instructions de téléchargement pour obtenir tout ce dont vous avez besoin via le programme d’installation Epic.

Configurer l’exemple de jeu Lyra pour utiliser Visual Studio Tools pour Unreal Engine

Depuis la version 17.7 de Visual Studio 2022, le plug-in Visual Studio Tools for Unreal Engine est inclus dans l'installation d'Unreal Engine. Il n'est plus nécessaire pour visualiser les Blueprints d'Unreal Engine. Si vous disposez d’une version antérieure de Visual Studio, consultez Installer Visual Studio Tools pour Unreal Engine pour installer le plug-in manuellement.

Après avoir téléchargé l'échantillon de jeu, mettez à jour LyraStarterGame.uproject pour utiliser le plug-in Visual Studio Tools. L’éditeur Unreal est l’un des moyens de le faire. Chargez le projet Lyra et, dans le menu principal, choisissez Modifier>Plug-ins. Recherchez le plug-in Visual Studio Integration Tools et cochez la case en regard de celui-ci.

On peut également modifier manuellement le fichier LyraStarterGame.uproject. Voici comment procéder :

1. Ouvrez le fichier LyraStarterGame.uproject dans un éditeur de texte. Il se trouve dans le répertoire où vous avez installé l’exemple de jeu.

2. Ajoutez ce qui suit à la fin de la section Plugins :

   ,{
       "Name": "VisualStudioTools",
       "Enabled": true
   }
   

Dans Unreal Engine

1. Ouvrez le projet Lyra dans Unreal Engine.
2. Dans le menu principal de l'éditeur Unreal Engine, choisissez Outils>Générer un projet Visual Studio. Cela crée le fichier de solution pour Visual Studio.
3. Dans le menu principal de l'éditeur Unreal Engine, choisissez Outils>Ouvrir Visual Studio pour ouvrir le jeu dans Visual Studio. Si vous avez plusieurs versions de Visual Studio sur votre machine, vérifiez que la version appropriée s’ouvre : dans le menu principal de Visual Studio, choisissez Aide>À propos de Microsoft Visual Studio. Vous devez utiliser Visual Studio 2022 version 17.7 ou ultérieure. Si la version appropriée ne s’est pas ouverte, ouvrez manuellement LyraStarterGame.sln dans la version correcte de Visual Studio.

Dans Visual Studio

1. Changez la liste déroulante Configurations de solutions en Éditeur de développement. Ceci active les blueprints de Visual Studio Tools pour Unreal Engine :
2. Définissez le projet LyraStarterGame comme projet de démarrage. Dans l’Explorateur de solutions, cliquez sur la solution, puis sur Propriétés.
3. Dans la boîte de dialogue Pages de propriétés de la solution, sous Propriétés communes, choisissez Configurer des projets de démarrage.
4. Vérifiez que le Projet de démarrage unique est sélectionné et choisissez LyraStarterGame dans la liste déroulante.

   

   Sous « Propriétés communes », l’option « Configurer les projets de démarrage » est sélectionnée. La case d’option du projet de démarrage unique est sélectionnée. Le projet de démarrage dans la liste déroulante est LyraStarterGame.

5. Choisissez OK pour fermer la boîte de dialogue.
6. Dans le menu principal de Visual Studio, choisissez Build>Générer la solution pour générer le jeu.

Fenêtre de sortie de build dans Visual Studio

La fenêtre de sortie de build dans Visual Studio montre la progression de la build et toutes les erreurs ou tous les avertissements qui se produisent. Vous pouvez ouvrir la fenêtre Sortie de génération à partir du menu principal de Visual Studio via Afficher> la sortie.

À partir de la version Visual Studio 2022 17.12, vous pouvez double-cliquer sur un chemin absolu vers un fichier dans la fenêtre de sortie pour ouvrir ce fichier dans Visual Studio. Le code source doit faire partie de la solution Visual Studio et le chemin d’accès dans la fenêtre de sortie doit être un chemin absolu. Cela fonctionne lorsque vous créez des projets Unreal Engine dans Visual Studio ou d'autres types de projets.

La capture d'écran suivante montre la fenêtre de sortie pour une compilation de l'échantillon LyraStarterGame. L’utilisateur a double-cliqué sur l’avertissement à partir de LyraCharacter.generated.h. Le chemin absolu de ce fichier étant fourni, le fichier s’ouvre dans l’éditeur.

Barre d'outils Unreal Engine

Visual Studio propose une barre d'outils qui améliore l'expérience d'intégration du développement Unreal Engine dans Visual Studio. La barre d'outils permet d'accéder rapidement aux tâches courantes d'Unreal Engine.

Activez la barre d'outils Unreal Engine dans Visual Studio à partir du menu principal via Afficher>Barres d'outils>Unreal Engine La barre d'outils se présente comme suit :

Les boutons de la barre d’outils, de gauche à droite :

• L'icône de lecture est un bouton d'attachement rapide aux processus répertoriés dans la liste déroulante de droite. La liste déroulante répertorie les processus liés à Unreal Engine, ce qui permet de s'attacher plus facilement à l'éditeur Unreal Engine. Vous pouvez également utiliser ce bouton pour vous attacher à n'importe quel processus.
• Boutons permettant de démarrer et d'arrêter le serveur d'intégration Unreal Engine. Le serveur d'intégration améliore les performances de l'intégration d'Unreal Engine avec Visual Studio. Il s'exécute en arrière-plan et met automatiquement à jour les informations de test pendant que vous travaillez sur votre projet. Vous pouvez le désactiver pour récupérer des ressources machine, et le démarrer lorsque vous souhaitez bénéficier des améliorations de l'intégration. Le serveur est démarré automatiquement lorsque vous ouvrez un projet UE dans Visual Studio.
• Un bouton pour renumériser les ressources Unreal Engine Blueprint. Cela permet de mettre à jour la solution Visual Studio avec les dernières ressources Blueprint du projet Unreal Engine.
• Un bouton qui ouvre la fenêtre du journal d'Unreal Engine.
• Un bouton pour ouvrir la fenêtre Unreal Engine Integration Configuration où vous pouvez actualiser et voir l'état général de la configuration et l'état de l'outil d'intégration de Visual Studio, vérifier la prise en charge de Blueprint, voir si vous obtenez l'état du vérificateur de convention de nommage d'Unreal Engine, etc.

Liste déroulante des arguments de ligne de commande

Vous pouvez fréquemment lancer votre jeu avec différentes combinaisons d’arguments de ligne de commande pendant la modification et le débogage de la partie de votre boucle interne. Cela est désormais plus facile avec la liste déroulante des arguments de ligne de commande :

Pour ajouter des arguments de ligne de commande, tapez-les dans la liste déroulante, puis appuyez sur Entrée. Les arguments sont enregistrés dans l’ordre dans lequel vous les entrez et apparaissent dans la liste déroulante pour une utilisation ultérieure.

Il existe une limite de cinq lignes de commande que vous pouvez ajouter avant que le plus ancien soit supprimé pour en faire place à un nouveau.

Le premier argument lors du débogage d’un projet Unreal Engine qui s’exécute dans l’éditeur Unreal Engine doit être le chemin d’accès au projet. Par exemple : C:\UE\LyraStarterGame\LyraStarterGame.uproject.

Pour plus d’informations sur l’utilisation de la liste déroulante des arguments de ligne de commande, consultez Les arguments de ligne de commande pass lors du débogage (C++).

Étapes suivantes

Ajouter des classes, des modules et des plug-ins Unreal Engine dans Visual Studio
Visualiser les Blueprints de l'Unreal Engine dans Visual Studio
Visualiser le journal de l'Unreal Engine dans Visual Studio
Visualiser les macros Unreal Engine dans Visual Studio