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 reste disponible en tant que chemin de compatibilité facultatif et déprécié pour les équipes qui ont besoin de plus de temps pour migrer.L’ancienne disposition ne sera plus prise en charge et sera supprimée du programme d’installation à partir de la version d’avril 2027 du GDK.
Ancienne disposition des en-têtes et bibliothèques
La disposition de fichiers existante du Microsoft GDK est résumée ci-dessous.Nouvelle disposition des en-têtes et bibliothèques
Pour la version d’octobre 2025 du GDK, une disposition alternative des en-têtes et bibliothèques est désormais proposée. Elle facilite grandement l’intégration à la plateforme 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 adopter la nouvelle disposition en définissant la propriété GDKCrossPlatform.
Le projet doit ajouter à AdditionalDependencies les bibliothèques d’extension qu’il consomme, car chacune d’elles est facultative (« opt-in »).
Le projet doit également copier dans la disposition les DLL supplémentaires qu’il utilise. Vous pouvez le faire soit au moyen d’étapes de build personnalisée, typiques de nombreuses intégrations de bibliothèques DLL, soit en modifiant le fichier vcxproj ou en ajoutant un fichier props pour utiliser la liste de groupes d’éléments ReferenceCopyLocalPaths. Le code MSBuild ci-dessous répertorie toutes les DLL possibles, mais chaque projet n’en aura besoin que de certaines.
GameDKLatest n’est défini que par le Microsoft GDK avec XBOX Extensions. C’est pourquoi nous avons introduit de nouvelles variables d’environnement qui prennent entièrement en charge l’installation côte à côte des deux versions du Microsoft GDK : GameDKCoreLatest est défini par le Microsoft GDK. GameDKXboxLatest est défini par le Microsoft GDK avec XBOX Extensions.Utilisation d’un fichier Directory.Build.props
Pour valider rapidement des projets GDK Gaming.*.x64 existants avec 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, voire 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 build avec GDKCrossPlatform défini sur true. Comme elle est déjà présente pour les builds 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, cela nécessitait d’ajouter des instructions<Import Project="...\ExtensionLibrary.props"> pour les bibliothèques d’extension, comme décrit dans 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, activez la nouvelle disposition à l’aide du code suivant.VS_GLOBAL_GDKExtLibNames et remplacez-la par le code suivant (avec CMake 3.21 ou version ultérieure) pour copier les DLL d’extension utilisées dans la disposition.
Utilisation de la nouvelle disposition avec des systèmes de build 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 ») du contenu s’effectuent sur le PC de développement à l’aide des API XTF, de la bibliothèque d’encodage XMA2 et/ou d’outils Direct3D 12.X personnalisés. L’accès à ce contenu nécessite une configuration de build spécifique : La génération d’outils PC ciblant à la fois XBOX One et XBOX Series X|S nécessite :Lecture de l’édition de build à partir d’un fichier installé
La nouvelle disposition ne contient pas les fichiersgrdk.ini ou gxdk.ini. Pour obtenir les informations d’é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 build MSBuild personnalisée, qui se trouvaient à l’origine sous<edition>\flatDeployment dans l’ancienne disposition, se trouvent désormais sous <edition>\xbox\build avec des chemins raccourcis.
Par exemple, pour configurer un dossier de règles MSBuild BWOI pour VS 2022, utilisez les commandes suivantes.