> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Structure des répertoires d'en-têtes et de bibliothèques du GDKX
> Décrit la nouvelle disposition des répertoires pour les en-têtes et bibliothèques du GDKX.
> [!NOTE]
>
> 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.
Dans les versions actuelles du Microsoft Game Development Kit (GDK), la disposition était optimisée pour le partage de code et axée sur des plateformes spécifiques. L'intégration de build pour cette disposition reposait largement sur la dissimulation de la complexité dans des plateformes MSBuild personnalisées. Pour la nouvelle disposition, l'accent est mis sur la simplification de l'intégration, la prise en charge d'une liste croissante de plateformes cibles et l'amélioration de la prise en charge des plateformes MSBuild standard comme des systèmes de build non Microsoft.
## Ancienne disposition des en-têtes et bibliothèques
La disposition de fichiers existante du Microsoft GDK est résumée ci-dessous.
```text theme={null}
251000\
GRDK\
ExtensionLibraries\
Xbox.Services.API.C\
ExtensionLibrary.props
DesignTime\CommonConfiguration\Neutral\
Include\
Lib\
Redist\
...
GameKit\
Include\
Lib\
amd64\
```
```text theme={null}
GXDK\
gameKit\
Include\
XboxOne\
Scarlett\
Lib\
amd64\
XboxOne\
Scarlett\
ToolKit\
Include\
XboxOne\
Scarlett\
Lib\
amd64\
XboxOne\
Scarlett\
```
Les plateformes MSBuild personnalisées **Gaming.Desktop.x64**, **Gaming.Xbox.Scarlett.x64** et **Gaming.Xbox.XboxOne.x64** implémentent toute la logique de construction des chemins include/lib qui combinent tout ce contenu de diverses manières. Si vous utilisiez CMake ou une solution make personnalisée, cette logique devait également y être implémentée. Pour un exemple détaillé, consultez la version d'avril 2025 de [CMakeExample](https://github.com/microsoft/Xbox-GDK-Samples/tree/apr2025/Samples/Tools/CMakeExample).
Les versions d'octobre 2025 et d'avril 2026 du GDK incluent à la fois la disposition simplifiée et l'ancienne disposition. À partir du GDK d'octobre 2026, le programme d'installation installe uniquement la disposition simplifiée par défaut. L'ancienne disposition peut toujours être sélectionnée en tant qu'installation facultative, mais elle est dépréciée et n'est plus le chemin de développement recommandé.
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.
## 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.
```text theme={null}
251000\
windows\
bin\
arm64
x64\
include\
lib\
arm64
x64\
redist
xbox\
bin\
gen8\
gen9\
devpctools\
gen8\
gen9\
x64\
x64\
build\
include\
lib\
redist\
source\
```
## 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**.
```xml theme={null}
...
true
```
Cela ajoute au projet les chemins include/lib appropriés au lieu des divers chemins complexes utilisés par l'ancienne disposition.
Dans cette nouvelle intégration simplifiée, le mécanisme des bibliothèques d'extension n'est plus utilisé. Tout le contenu est disponible par défaut au moment de la build dans les chemins include/lib.
Le projet doit ensuite effectuer l'édition de liens avec les bibliothèques supplémentaires qu'il utilise. Les projets créés à partir des anciens modèles de projet GDK doivent contenir des instructions comme celle-ci.
```xml theme={null}
uuid.lib;$(Console_Libs);%(XboxExtensionsDependencies);%(AdditionalDependencies)
```
Pour la nouvelle disposition, la propriété **Console\_Libs** répertorie les bibliothèques principales requises.
| Plateforme | Bibliothèques principales |
| - | - |
| Gaming.\*.x64 | xgameruntime.lib d3d12.lib dxguid.lib dxgi.lib gameinput.lib |
| Gaming.Xbox.Scarlett.x64 | xgameruntime.lib xgameplatform.lib d3d12\_xs.lib xg\_xs.lib pixevt.lib xmem.lib |
| Gaming.Xbox.XboxOne.x64 | xgameruntime.lib xgameplatform.lib d3d12\_x.lib xg\_x.lib pixevt.lib xmem.lib |
Le projet doit ajouter à **AdditionalDependencies** les bibliothèques d'extension qu'il consomme, car chacune d'elles est facultative (« opt-in »).
| Plateforme | Bibliothèques principales |
| - | - |
| Xbox.LibHttpClient | libHttpClient.lib |
| Xbox.XCurl.API | XCurl.lib |
| Xbox.Game.Chat.2.Cpp.API | GameChat2.lib |
| Xbox.Services.API.C (Debug) | Appnotify.lib winhttp.lib crypt32.lib Microsoft.Xbox.Services.142.C.Debug.lib |
| Xbox.Services.API.C (Release) | Appnotify.lib winhttp.lib crypt32.lib Microsoft.Xbox.Services.142.C.lib |
| PlayFab.Party.Cpp | Party.lib |
| PlayFab.PartyXboxLive.Cpp | PartyXboxLive.lib |
| PlayFab.Services.C | PlayFabCore.lib PlayFabGameSave.lib PlayFabServices.lib |
| PlayFab.Multiplayer.Cpp | PlayFabMultiplayer.lib |
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.
```xml theme={null}
$(GameDKCoreLatest)$(GameDKXboxLatest)
```
> [!NOTE]
>
> `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.
> [!NOTE]
>
> 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.
```xml theme={null}
true$(GameDKCoreLatest)$(GameDKXboxLatest)Appnotify.lib;winhttp.lib;crypt32.lib;libHttpClient.lib;XCurl.lib;GameChat2.lib;PlayFabCore.lib;PlayFabServices.lib;PlayFabMultiplayer.lib;Party.lib;PartyXboxLive.lib;PlayFabGameSave.libMicrosoft.Xbox.Services.142.C.Debug.lib;$(AllExtensionLibs)Microsoft.Xbox.Services.142.C.lib;$(AllExtensionLibs)$(AllExtensionLibs);%(AdditionalDependencies)$(AllExtensionLibs);%(XboxExtensionsDependencies)
```
## 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 `` pour les bibliothèques d'extension, comme décrit dans [Utilisation de la plateforme x64 avec le Microsoft Game Development Kit (GDK)](https://docs.xbox.com/fr/tools/tools-pc/visualstudio/gr-vs-templates.md#using-the-x64-platform-with-the-microsoft-game-development-kit-gdk).
Dans la nouvelle disposition, les instructions d'intégration sont simplifiées.
```xml theme={null}
$(GameDKCoreLatest)$(GameDKXboxLatest)
```
```xml theme={null}
$(GameDK)bin;$(GDKCrossPlatformPath)windows\bin\x64;$(ExecutablePath)$(GDKCrossPlatformPath)windows\Include;$(IncludePath);$(GDKCrossPlatformPath)windows\lib\x64;$(LibraryPath)
```
```xml theme={null}
$(GameDK)bin;$(GDKCrossPlatformPath)windows\bin\x64;$(ExecutablePath)$(GDKCrossPlatformPath)windows\Include;$(IncludePath);$(GDKCrossPlatformPath)windows\lib\x64;$(LibraryPath)
```
Ajoutez toutes les bibliothèques d'extension requises à **AdditionalDependencies**, en plus de la liste d'origine.
```xml theme={null}
xgameruntime.lib;gameinput.lib;d3d12.lib;dxgi.lib;dxguid.lib;uuid.lib;kernel32.lib;user32.lib;%(AdditionalDependencies)
```
Les DLL des bibliothèques d'extension facultatives doivent être copiées dans le répertoire des binaires comme indiqué ci-dessus, à l'aide d'une action de build personnalisée ou du groupe d'éléments **ReferenceCopyLocalPaths** pour la disposition finale.
Les autres instructions relatives à **PreprocessorDefinitions** et à la gestion du fichier .mgc avec les ressources d'images restent inchangé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.
```text theme={null}
set_property(TARGET ${PROJECT_NAME} PROPERTY VS_GLOBAL_GDKCrossPlatform "true")
```
Dans [CMakeGDKExample](https://github.com/microsoft/Xbox-GDK-Samples/tree/apr2025/Samples/Tools/CMakeGDKExample), supprimez l'utilisation de `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.
```text theme={null}
add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD
COMMAND ${CMAKE_COMMAND} -E $>,copy,true>
$ $
COMMAND_EXPAND_LISTS
)
```
## 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.
```cmd theme={null}
set INCLUDE=%GameDKXboxLatest%windows\include;%INCLUDE%
set LIB=%GameDKXboxLatest%windows\lib\x64;%LIB%
set PATH=%GameDK%bin;%GameDKXboxLatest%windows\bin\x64;%PATH%
```
La génération pour XBOX Series X|S (également appelée *Gaming.Xbox.Scarlett.x64*) nécessite :
```cmd theme={null}
set INCLUDE=%GameDKXboxLatest%xbox\include\gen9;%GameDKXboxLatest%xbox\include;%INCLUDE%
set LIB=%GameDKXboxLatest%xbox\lib\gen9;%GameDKXboxLatest%xbox\lib\x64;%LIB%
set PATH=%GameDK%bin;%GameDKXboxLatest%xbox\bin\gen9;%GameDKXboxLatest%xbox\bin\x64;%PATH%
```
La génération pour XBOX One (également appelée *Gaming.Xbox.XboxOne.x64*) nécessite :
```cmd theme={null}
set INCLUDE=%GameDKXboxLatest%xbox\include\gen8;%GameDKXboxLatest%xbox\include;%INCLUDE%
set LIB=%GameDKXboxLatest%xbox\lib\gen8;%GameDKXboxLatest%xbox\lib\x64;%LIB%
set PATH=%GameDK%bin;%GameDKXboxLatest%xbox\bin\gen8;%GameDKXboxLatest%xbox\bin\x64;%PATH%
```
## 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 :
```cmd theme={null}
set INCLUDE=%GameDKXboxLatest%xbox\include\devpctools;%GameDK%\toolKit\include;%INCLUDE%
set LIB=%GameDKXboxLatest%xbox\lib\devpctools\x64;%GameDK%\toolKit\lib\amd64;%LIB%
set PATH=%GameDK%bin;%PATH%
```
La génération d'outils PC ciblant les graphismes XBOX Series X|S nécessite :
```cmd theme={null}
set INCLUDE=%GameDKXboxLatest%xbox\include\devpctools\gen9;%GameDKXboxLatest%xbox\include\devpctools;%GameDK%\toolKit\include;%INCLUDE%
set LIB=%GameDKXboxLatest%xbox\lib\devpctools\gen9;%GameDKXboxLatest%xbox\lib\devpctools\x64;%GameDK%\toolKit\lib\amd64;%LIB%
set PATH=%GameDKXboxLatest%xbox\devpctools\bin\gen9;%GameDK%bin;%PATH%
```
La génération d'outils PC ciblant les graphismes XBOX One nécessite :
```cmd theme={null}
set INCLUDE=%GameDKXboxLatest%xbox\include\devpctools\gen8;%GameDKXboxLatest%xbox\include\devpctools;%GameDK%\toolKit\include;%INCLUDE%
set LIB=%GameDKXboxLatest%xbox\lib\devpctools\gen8;%GameDKXboxLatest%xbox\lib\devpctools\x64;%GameDK%\toolKit\lib\amd64;%LIB%
set PATH=%GameDKXboxLatest%xbox\devpctools\bin\gen8;%GameDK%bin;%PATH%
```
## Lecture de l'édition de build à partir d'un fichier installé
La nouvelle disposition ne contient pas les fichiers `grdk.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.
```powershell theme={null}
$result = Get-ChildItem -Path $env:GameDKXboxLatest -Filter "gxdk.h" -Recurse
if ($result.Count -eq 0)
{
$result = Get-ChildItem -Path $env:GXDKLatest -Filter "gxdk.h" -Recurse
}
if ($result.Count -eq 0)
{
Write-Error "##[error]Failed to find gxdk.h in either GameDKXboxLatest or GXDKLatest" -ErrorAction Stop
}
$content = Get-Content -Path $result[0].FullName
if (-not ([string]$content -match '#define\s+_GXDK_EDITION\s+([0-9][0-9][0-9][0-9][0-9][0-9])')) {
Write-Error "##[error]Failed to find edition define" -ErrorAction Stop
}
$xbld_edition = $Matches[1]
if (-not ([string]$content -match '#define\s+_GXDKVER_PRODUCTBUILDVER_FULL\s+([0-9]+\.[0-9]+\.([0-9]+)\.[0-9]+)')) {
Write-Error "##[error]Failed to find full version define" -ErrorAction Stop
}
$xbld_full_productbuild = $Matches[1]
$xbld_build = $Matches[2]
if (-not ([string]$content -match '#define\s+_GXDK_MM_NUM\s+([0-9]{1,2})')) {
Write-Error "##[error]Failed to find month define" -ErrorAction Stop
}
$month = $Matches[1]
if (-not ([string]$content -match '#define\s+_GXDK_FULLYY\s+([0-9]{4})')) {
Write-Error "##[error]Failed to find full year define" -ErrorAction Stop
}
$year = $Matches[1]
Write-Output ("_xbld_name={0} {1} GXDK" -f (Get-Culture).DateTimeFormat.GetMonthName([int]$month), $year)
Write-Output ("_xbld_edition={0}" -f $xbld_edition)
Write-Output ("_xbld_full_productbuild={0}" -f $xbld_full_productbuild)
Write-Output ("_xbld_build={0}" -f $xbld_build)
```
## Génération sans installation (BWOI)
Les fichiers de plateforme de build MSBuild personnalisée, qui se trouvaient à l'origine sous `\flatDeployment` dans l'ancienne disposition, se trouvent désormais sous `\xbox\build` avec des chemins raccourcis.
Par exemple, pour configurer un dossier de règles MSBuild BWOI pour VS 2022, utilisez les commandes suivantes.
```cmd theme={null}
rd /q /s c:\temp\msbuildgdk
md c:\temp\msbuildgdk
xcopy "%VSInstallDir%\MSBuild\Microsoft\VC" /s c:\temp\msbuildgdk
xcopy "%GameDKXboxLatest%\xbox\build\VS2022\gen8" c:\temp\msbuildgdk /s
xcopy "%GameDKXboxLatest%\xbox\build\VS2022\gen9" c:\temp\msbuildgdk /s
xcopy "%GameDKXboxLatest%\xbox\build\VS2022\pc" c:\temp\msbuildgdk /s
```
Ensuite, dans le fichier Directory.Build.props utilisé pour BWOI, définissez les propriétés pour qu'elles pointent vers ce dossier combiné.
```xml theme={null}
c:\temp\msbuildgdk\v170\c:\temp\msbuildgdk\v160\
```
## Related topics
- [Structure des répertoires d'en-têtes et de bibliothèques du GDK](https://docs.xbox.com/fr/build/gdk-and-engines/guides/gdk-directory-structure.md)
- [Prise en main sur Android](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/android-specific-requirements.md)
- [Prise en main sur Linux](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/linux-specific-requirements.md)
- [Index des rubriques NDA pour le développement sur console avec le GDK XBOX](https://docs.xbox.com/fr/nda/nda-overview.md)
- [Prise en main sur iOS et macOS](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/apple-specific-requirements.md)