L’Unreal Engine (UE) est conçu pour s'intégrer harmonieusement à Visual Studio (VS), ce qui vous permet de modifier rapidement le code de vos projets et d'en voir immédiatement les résultats lors de la compilation. Configurer VS pour travailler avec l’UE peut contribuer à améliorer l'efficacité des développeurs et l'expérience globale de l'utilisateur.
Ce document couvre les bases de la configuration de votre flux de travail Unreal Engine-Visual Studio.
Compatibilité des versions
Le tableau suivant répertorie les versions de VS qui sont intégrées à la version binaire de l'UE.
| Version d’Unreal Engine | Version VS 2019 | Version VS 2022 |
|---|---|---|
5.6 | Non prise en charge | 17.8 ou ultérieure ; 17.14 recommandée (par défaut) |
5.5 | Non prise en charge | 17.8 ou ultérieure ; 17.10 recommandée (par défaut) |
5.4 | Non prise en charge | 17.4 ou ultérieure ; 17.8 recommandée (par défaut) |
5.3 | 16.11.5 ou ultérieure | 17.4 ou ultérieure ; 17.6 recommandée (par défaut) |
5.2 | 16.11.5 ou ultérieure | 17.4 ou ultérieure (par défaut) |
5.1 | 16.11.5 ou ultérieure (par défaut) | 17.4 ou ultérieure |
Autres versions du logiciel :
| Logiciel | Version minimale | Version recommandée |
|---|---|---|
MSVC | 14.38.33130 | 14.38.33130 |
SDK Windows | 10.0.19041.0 | 10.0.22621.0 ou ultérieure |
LLVM | 18.1.3 | 18.1.8 |
.NET | .NET 8.0 | .NET 8.0 |
Vérifier les prérequis de l'UE
Si vous avez installé l’UE depuis le lanceur Epic Games ou l'avez cloné depuis GitHub, le programme d’installation des prérequis de l’UE a automatiquement installé les dépendances, bibliothèques et frameworks nécessaires à l'exécution du moteur.
Si vous avez installé ou synchronisé l’UE à partir de Perforce, exécutez le programme d'installation des prérequis avant d'exécuter les outils UE que vous avez créés localement. Recherchez le programme d'installation dans le répertoire [UNREAL_ENGINE_ROOT]\Engine\Extras\Redist\en-us\.
Ajouter des options d'installation de Visual Studio
Si vous installez Visual Studio (VS) pour la première fois ou si vous modifiez une installation existante, assurez-vous que les charges de travail et les composants suivants sont activés.
Pour modifier votre installation de VS, exécutez le programme d'installation de Visual Studio, puis cliquez sur Modifier à côté de la dernière version.
Ajouter les charges de travail requises
Dans l'onglet Charges de travail du programme d'installation, sous Bureau et mobile, activez les options suivantes :
Développement d’applications de bureau .NET
Développement d’applications de bureau avec C++
Développement d’interfaces d’application .NET multiplateforme
Sous Jeux, activez l’option Développement de jeux avec C++.
Ajouter les composants requis
Dans le panneau Détails de l'installation du programme d'installation, développez la section Développement de jeux avec C++ et activez les options suivantes :
Outils de profilage en C++
AddressSanitizer en C++
SDK Windows 10 ou 11 (10.0.18362 ou ultérieure)
Programme d'installation d'Unreal Engine
À l’ouverture de votre premier projet Unreal Engine en C++ dans VS, un avertissement concernant des composants manquants peut apparaître dans l’explorateur de solutions. Cliquez sur Installer pour autoriser VS à installer les composants supplémentaires nécessaires à votre projet.
Paramètres recommandés
Ces ajustements facultatifs de l'interface de VS peuvent rendre votre expérience de développement plus commode.
Désactiver la fenêtre Liste des erreurs
Généralement, la fenêtre Liste des erreurs s'ouvre automatiquement lorsqu'une erreur est détectée dans votre code. Cependant, lorsque vous travaillez avec l'UE, la fenêtre Liste des erreurs peut afficher des erreurs supplémentaires en aval qui rendent difficile l'identification de la cause première. Vous pouvez désactiver la fenêtre Liste des erreurs et utiliser à la place le journal de sortie pour voir les erreurs de code réelles lorsque vous travaillez avec l’UE.
Pour désactiver la fenêtre Liste des erreurs, procédez comme suit :
Dans VS, accédez à Outils > Options.
Sur le côté gauche de la fenêtre Options, sélectionnez Projets et solutions.
Désactivez l’option Toujours montrer la liste des erreurs si la génération se termine avec des erreurs.
(Facultatif) Modifiez toutes les autres options et fonctionnalités du tableau ci-dessous qui sont pertinentes pour votre projet.
Cliquez sur OK.
| À : | Dans Options, accédez à : | Et modifiez l’option suivante : |
|---|---|---|
Empêcher que des tronçons de code apparaissent grisés dans l'éditeur de texte | Éditeur de texte > C/C++ > Vue | Définissez l’option Afficher les blocs inactifs sur False |
Masquez les dossiers inutiles dans l'explorateur de solutions | Éditeur de texte > C/C++ > Avancé | Définissez l’option Désactiver les dossiers de dépendances externes sur True. |
Activez IntelliSense (complétion du code, suggestions et mise en forme automatique pendant la saisie) | Éditeur de texte > C/C++ > IntelliSense | Activez l’option Activer IntelliSense 64 bits |
Augmenter la largeur du menu déroulant Configurations de solution
Il peut être utile d’élargir le menu déroulant Configurations de solution dans la barre d’outils de Visual Studio afin de pouvoir afficher le nom complet de toutes les configurations personnalisées.
Pour élargir le menu Configurations de solution, procédez comme suit :
Dans Visual Studio, faites un clic droit sur la barre d'outils principale, puis sélectionnez Personnaliser en bas du menu contextuel.
Dans la fenêtre Personnaliser, cliquez sur l'onglet Commandes, sélectionnez le bouton radio Barre d'outils, puis utilisez le menu déroulant pour changer la Barre d'outils en Standard.
Dans la barre d'outils Aperçu, faites défiler les options pour trouver et sélectionner Configurations de solution, puis cliquez sur Modifier la sélection.
Modifiez la Largeur à 200 et cliquez sur OK. VS met à jour la barre d'outils avec sa nouvelle taille.
Fermez la fenêtre Personnaliser.
Ajouter le menu déroulant Plateformes de solutions
Lors du développement multiplateforme, il est pratique d’avoir le menu déroulant Plateformes de solution dans la barre d’outils de Visual Studio.
Si ce menu n’apparaît pas à droite du menu déroulant Configurations de solution, vous pouvez l’ajouter à la barre d’outils en cliquant sur la petite flèche située à droite de la barre d’outils Standard, puis en choisissant Ajouter ou supprimer des boutons, et en sélectionnant Plateformes de solution.
