Les versions 16.0 à 16.10 de Visual Studio 2019 ne sont plus prises en charge depuis octobre 2022. La version 16.11 ne bénéficie plus non plus du support standard.
Installer Visual Studio 2019
Le GDK prend en charge le développement avec l’édition Professional ou Enterprise de Visual Studio 2019. L’édition Community n’est pas prise en charge. Lors de l’installation de Visual Studio 2019, sélectionnez la charge de travail Game development with C++, comme illustré dans la capture d’écran suivante.
L’ensemble d’outils v141 de Visual Studio 2017 n’est plus pris en charge depuis la version d’octobre 2024.
Prise en charge des projets clang/LLVM pour Windows (ClangCl)
Visual Studio 2019 prend aussi en charge le développement avec clang/LLVM pour Windows. Cette prise en charge nécessite l’installation des composants individuels C++ Clang-cl for Windows et C++ Clang-cl for v142 build tools (x64/x86). Pour plus de renseignements, consultez l’article Clang du Microsoft Game Development Kit (GDK) et Microsoft Docs.Édition Build Tools
Utilisez Build Tools for Visual Studio 2019 pour générer avec les en-têtes, bibliothèques et outils du Microsoft GDK en suivant les instructions de génération avec ou sans installation.- Utilisez la charge de travail Desktop Development with C++, qui installe le compilateur Visual C++ pour le PlatformToolset
v142. Vous pouvez aussi sélectionner des composants pour la prise en charge deClangClen suivant les instructions données plus haut dans cet article. - Installez le Windows SDK ou utilisez-le sous forme de package NuGet.
L’édition Build Tools ne prend pas en charge les extensions; vous ne pouvez donc pas installer les packages VSIX du Microsoft GDK pour l’édition Build. Cette limitation signifie qu’elle ne prend en charge ni le déploiement ni le débogage, bien que vous puissiez utiliser les outils en ligne de commande.
Migrer des projets Visual Studio 2017 existants vers Visual Studio 2019
Dans la plupart des cas, l’assistant de mise à niveau fourni avec Visual Studio peut migrer votre projet vers Visual Studio 2019 sans autre modification. Lorsque vous ouvrez un projet Visual Studio 2017 dans Visual Studio 2019, la boîte de dialogue Review Solution Actions suivante s’affiche et vous invite à effectuer la mise à niveau. Pour mettre à niveau le projet, sélectionnez OK.
Mettre à niveau manuellement des projets vers Visual Studio 2019
Si vous voulez mettre à niveau votre projet en modifiant directement vos fichiers projet (.vcxproj), apportez les modifications suivantes.- Remplacez toutes les occurrences de
PlatformToolsetv141parv142. L’exemple suivant montre comment effectuer cette modification.
- Régénérez le projet.
Utiliser des versions spécifiques
Par défaut, Visual Studio Installer télécharge toujours la dernière version. En environnement d’entreprise, vous pouvez contrôler la version utilisée à l’aide d’une disposition hors connexion. Pour plus de renseignements, consultez Controlling updates to Visual Studio deployments. Cet article fournit aussi des informations sur la suppression de l’icône VS notification. Téléchargez des versions spécifiques de Visual Studio 2019 depuis Visual Studio 2019 Releases.Problèmes connus
- Les fonctions DirectXMath
*IsNanpeuvent échouer avec Visual Studio 2019 lors d’une génération avec/fp:fast. La solution consiste à utiliser Visual Studio 2019 (16.3 ou version ultérieure). Sinon, vous pouvez contourner le problème en plaçant des instructions#pragma float_controlautour de l’utilisation de ces fonctions. - Seul l’ensemble d’outils de compilation natif 64 bits est pris en charge pour le développement avec le GDK. Dans un
vcxprojVisual C++, définissez cet ensemble d’outils dans les propriétés globales :
- Les en-têtes précompilés présentent des problèmes connus dans les versions de clang/LLVM pour Windows antérieures à v11. Selon votre utilisation des PCH et des modèles C++, vous devrez peut-être ajouter
-fno-pch-instantiate-templatespour réussir la génération. - Les mises à jour de .NET Core 2.1 distribuées par Microsoft Update peuvent bloquer l’installation du GDK. Pour plus de renseignements sur ce problème, consultez l’avis de fin de support de .NET Core 2.1. Pour résoudre ce problème :
- Exécutez Visual Studio Installer
- Sélectionnez le bouton Modify de Visual Studio 2019
- Sélectionnez l’onglet Individual components et supprimez le composant .NET Core 2.1 Runtime (LTS)
- Réessayez de désinstaller puis de réinstaller le GDK
Signaler des bogues
Signalez les bogues du compilateur Visual C++ (si possible) par la commande Report a Problem… de Visual Studio. Consultez Microsoft Docs et le site Web Developer Community. Pour savoir comment rédiger un bon rapport de bogue pour le compilateur, consultez cette page.Vous pouvez ajouter un commentaire marqué « Microsoft only » à un rapport public si d’autres informations soumises à NDA sont nécessaires pour reproduire le problème.