La structure de répertoires décrite dans cet article est la disposition simplifiée (multiplateforme) introduite avec le GDK d’octobre 2025.À partir du GDK d’octobre 2026, la disposition simplifiée est installée par défaut. L’ancienne disposition demeure disponible comme option de compatibilité facultative et dépréciée pour les équipes qui ont besoin de plus de temps pour effectuer la migration.L’ancienne disposition ne sera plus prise en charge et sera retirée du programme d’installation à partir de la version d’avril 2027 du GDK.
Ancienne disposition des en-têtes et des bibliothèques
La disposition actuelle des fichiers du GDK Microsoft se résume comme suit.Nouvelle disposition des en-têtes et des bibliothèques
La version d’octobre 2025 du GDK offre désormais une disposition de remplacement pour les en-têtes et les bibliothèques, qui facilite grandement l’intégration des plateformes et permet d’accueillir d’autres plateformes au fil du temps.Utilisation de la nouvelle disposition avec les plateformes MSBuild personnalisées
Les plateformes MSBuild Gaming.*.x64 existantes utilisent l’ancienne disposition par défaut, mais vous pouvez choisir d’utiliser la nouvelle disposition en définissant la propriété GDKCrossPlatform.
Le projet doit ajouter à AdditionalDependencies les bibliothèques d’extension qu’il utilise, car chacune d’elles doit être activée explicitement.
Le projet doit également copier dans la disposition les DLL supplémentaires qu’il utilise. Pour ce faire, vous pouvez utiliser des étapes de génération personnalisée, typiques de nombreuses intégrations de bibliothèques DLL, ou modifier le fichier vcxproj ou ajouter un fichier props pour utiliser la liste de groupes d’éléments ReferenceCopyLocalPaths. Le code MSBuild ci-dessous liste toutes les DLL possibles, mais chaque projet n’aura besoin que de certaines d’entre elles.
GameDKLatest est défini uniquement par le GDK Microsoft avec XBOX Extensions. Par conséquent, nous avons introduit de nouvelles variables d’environnement qui prennent entièrement en charge l’installation côte à côte des deux versions du GDK Microsoft : GameDKCoreLatest est défini par le GDK Microsoft. GameDKXboxLatest est défini par le GDK Microsoft avec XBOX Extensions.Utilisation d’un fichier Directory.Build.props
Pour valider rapidement des projets GDK Gaming.*.x64 existants à l’aide de la nouvelle disposition, placez le contenu suivant dans un fichier nommé Directory.Build.props dans votre arborescence source. Cela active la nouvelle disposition et inclut la plupart ou la totalité des bibliothèques d’extension, même si le projet ne les utilise pas.La propriété GDKExtLibNames n’est pas utilisée par les règles MSBuild lors d’une génération avec GDKCrossPlatform défini à true. Comme elle est déjà présente pour la génération avec les anciennes règles MSBuild, elle est utilisée dans ce fichier props pour activer certaines DLL supplémentaires dans la disposition.
Utilisation de la nouvelle disposition avec la plateforme MSBuild x64
Au lieu d’utiliser la plateforme Gaming.Desktop.x64, vous pouvez utiliser la plateforme x64 standard pour générer pour PC. Dans l’ancienne disposition, il fallait ajouter des instructions<Import Project="...\ExtensionLibrary.props"> pour les bibliothèques d’extension, comme le détaille la rubrique Utilisation de la plateforme x64 avec le Microsoft Game Development Kit (GDK).
Dans la nouvelle disposition, les instructions d’intégration sont simplifiées.
Utilisation de la nouvelle disposition avec CMake
Lorsque vous utilisez les générateurs Microsoft Visual Studio avec CMake et les plateformes MSBuild personnalisées Gaming.*.x64, la nouvelle disposition est activée avec ce qui suit.VS_GLOBAL_GDKExtLibNames et remplacez-la par ce qui suit (en supposant CMake 3.21 ou une version ultérieure) pour copier dans la disposition les DLL d’extension utilisées.
Utilisation de la nouvelle disposition avec des systèmes de génération personnalisés
La génération pour Windows x64 à l’aide du GDK nécessite ce qui suit.Utilisation de la nouvelle disposition pour les outils de contenu PC
Pour le développement sur console, certains types de préparation (« cooking ») de contenu ont lieu sur le PC de développement à l’aide des API XTF, de la bibliothèque d’encodage XMA2 ou d’outils Direct3D 12.X personnalisés. L’accès à ce contenu nécessite une configuration de génération particulière : La génération d’outils PC qui ciblent à la fois XBOX One et XBOX Series X|S nécessite :Lecture de l’édition de génération à partir d’un fichier installé
La nouvelle disposition ne contient pas les fichiersgrdk.ini ou gxdk.ini. Pour trouver les informations sur l’édition en analysant un fichier, utilisez grdk.h ou gxdk.h.
Voici un exemple PowerShell qui fonctionne également avec les versions antérieures du GDK.
Génération sans installation (BWOI)
Les fichiers de plateforme de génération MSBuild personnalisée qui se trouvaient à l’origine sous<edition>\flatDeployment dans l’ancienne disposition se trouvent maintenant sous <edition>\xbox\build, avec des chemins raccourcis.
Par exemple, pour configurer un dossier de règles MSBuild BWOI pour VS 2022, utilisez ces commandes.