> ## 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.
# Estructura de directorios de encabezados y bibliotecas del GDKX
> Describe el nuevo diseño de directorios para los encabezados y bibliotecas del GDKX.
> [!NOTE]
>
> La estructura de directorios descrita en este artículo es el **diseño simplificado (multiplataforma)** introducido con el GDK de octubre de 2025.
>
> A partir del GDK de octubre de 2026, el diseño simplificado se instala de forma predeterminada. El diseño heredado sigue disponible como una ruta de compatibilidad opcional y en desuso para los equipos que necesiten más tiempo de migración.
>
> El diseño heredado dejará de ser compatible y se quitará del instalador a partir de la versión del GDK de abril de 2027.
En las versiones actuales del Microsoft Game Development Kit (GDK), el diseño se optimizó en torno al uso compartido de código y se centró en plataformas específicas. La integración de compilación para este diseño dependía en gran medida de ocultar la complejidad en plataformas personalizadas de MSBuild. En el nuevo diseño, el objetivo es simplificar la integración, admitir una lista creciente de plataformas de destino y mejorar la compatibilidad tanto con las plataformas estándar de MSBuild como con sistemas de compilación que no son de Microsoft.
## Diseño anterior de encabezados y bibliotecas
El diseño de archivos existente del Microsoft GDK se resume de la siguiente manera.
```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\
```
Las plataformas personalizadas de MSBuild **Gaming.Desktop.x64**, **Gaming.Xbox.Scarlett.x64** y **Gaming.Xbox.XboxOne.x64** implementan toda la lógica para generar las rutas de acceso include/lib que combinan todo este contenido de varias formas. Si usaba CMake o una solución make personalizada, esta lógica también tenía que implementarse allí. Para ver un ejemplo detallado, consulte la versión de abril de 2025 de [CMakeExample](https://github.com/microsoft/Xbox-GDK-Samples/tree/apr2025/Samples/Tools/CMakeExample).
Las versiones del GDK de octubre de 2025 y abril de 2026 incluyen tanto el diseño simplificado como el heredado. A partir del GDK de octubre de 2026, el programa de instalación instala solo el diseño simplificado de forma predeterminada. El diseño heredado todavía se puede seleccionar como instalación opcional, pero está en desuso y ya no es la ruta de desarrollo recomendada.
El diseño heredado dejará de ser compatible y se quitará del instalador a partir de la versión del GDK de abril de 2027.
## Nuevo diseño de encabezados y bibliotecas
La versión del GDK de octubre de 2025 ofrece ahora un diseño alternativo para los encabezados y las bibliotecas que facilita mucho la integración de plataformas y permite incorporar plataformas adicionales con el tiempo.
```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\
```
## Uso del nuevo diseño con plataformas personalizadas de MSBuild
Las plataformas de MSBuild **Gaming.\*.x64** existentes usarán el diseño anterior de forma predeterminada, pero puede optar por el nuevo diseño estableciendo la propiedad **GDKCrossPlatform**.
```xml theme={null}
...
true
```
Como resultado, se agregan al proyecto las rutas de acceso include/lib adecuadas en lugar de las diversas rutas complejas que usaba el diseño anterior.
En esta nueva integración simplificada, ya no se usa el mecanismo de bibliotecas de extensión. Todo el contenido está disponible de forma predeterminada en tiempo de compilación en las rutas de acceso include/lib.
A continuación, el proyecto debe vincularse a las bibliotecas adicionales que usa. Los proyectos creados a partir de las plantillas de proyecto del GDK anteriores deben contener instrucciones como la siguiente.
```xml theme={null}
uuid.lib;$(Console_Libs);%(XboxExtensionsDependencies);%(AdditionalDependencies)
```
En el nuevo diseño, la propiedad **Console\_Libs** enumerará las bibliotecas principales necesarias.
| Plataforma | Bibliotecas 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 |
El proyecto debe agregar a **AdditionalDependencies** las bibliotecas de extensión que consume, ya que cada una de ellas es de tipo 'opt-in' (participación voluntaria).
| Plataforma | Bibliotecas 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 |
El proyecto también debe copiar en el diseño las DLL adicionales que usa. Esto se puede hacer mediante pasos de compilación personalizada (Custom Build), habituales en muchas integraciones de bibliotecas DLL, o editando el archivo vcxproj o agregando un archivo props para usar la lista de grupos de elementos **ReferenceCopyLocalPaths**. El siguiente código de MSBuild enumera todas las DLL posibles, pero cada proyecto solo necesitará algunas de ellas.
```xml theme={null}
$(GameDKCoreLatest)$(GameDKXboxLatest)
```
> [!NOTE]
>
> `GameDKLatest` solo lo establece el Microsoft GDK with XBOX Extensions. Por ello, introdujimos nuevas variables de entorno que admiten por completo la instalación en paralelo de ambas versiones del Microsoft GDK: `GameDKCoreLatest` lo establece el Microsoft GDK. `GameDKXboxLatest` lo establece el Microsoft GDK with XBOX Extensions.
### Uso de un archivo Directory.Build.props
Para validar rápidamente proyectos Gaming.\*.x64 del GDK existentes con el nuevo diseño, coloque el siguiente contenido en un archivo denominado Directory.Build.props en el árbol de código fuente. Esto habilita el nuevo diseño e incluye la mayoría o la totalidad de las bibliotecas de extensión, aunque el proyecto no las use.
> [!NOTE]
>
> Las reglas de MSBuild no usan la propiedad **GDKExtLibNames** al compilar con **GDKCrossPlatform** establecido en true. Como ya está presente para compilar con las reglas de MSBuild anteriores, se usa en este archivo props como forma de incluir algunas DLL adicionales en el diseño.
```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)
```
## Uso del nuevo diseño con la plataforma x64 de MSBuild
En lugar de usar la plataforma **Gaming.Desktop.x64**, puede usar la plataforma estándar **x64** para compilar para PC. En el diseño anterior, esto requería agregar instrucciones `` para las bibliotecas de extensión, como se detalla en [Uso de la plataforma x64 con el Microsoft Game Development Kit (GDK)](https://docs.xbox.com/es/tools/tools-pc/visualstudio/gr-vs-templates.md#using-the-x64-platform-with-the-microsoft-game-development-kit-gdk).
En el nuevo diseño, las instrucciones de integración se simplifican.
```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)
```
Agregue todas las bibliotecas de extensión necesarias a **AdditionalDependencies** junto con la lista original.
```xml theme={null}
xgameruntime.lib;gameinput.lib;d3d12.lib;dxgi.lib;dxguid.lib;uuid.lib;kernel32.lib;user32.lib;%(AdditionalDependencies)
```
Las DLL de las bibliotecas de extensión opcionales deben copiarse en el directorio binario, como se indicó anteriormente, mediante una acción de compilación personalizada (Custom Build) o con el grupo de elementos **ReferenceCopyLocalPaths** para el diseño final.
El resto de las instrucciones para **PreprocessorDefinitions** y para controlar el archivo .mgc con recursos de imagen no cambian.
## Uso del nuevo diseño con CMake
Al usar los generadores de Microsoft Visual Studio con CMake y las plataformas personalizadas de MSBuild **Gaming.\*.x64**, el nuevo diseño se habilita con lo siguiente.
```text theme={null}
set_property(TARGET ${PROJECT_NAME} PROPERTY VS_GLOBAL_GDKCrossPlatform "true")
```
En [CMakeGDKExample](https://github.com/microsoft/Xbox-GDK-Samples/tree/apr2025/Samples/Tools/CMakeGDKExample), quite el uso de `VS_GLOBAL_GDKExtLibNames` y reemplácelo por lo siguiente (suponiendo CMake 3.21 o posterior) para copiar en el diseño las DLL de extensión usadas.
```text theme={null}
add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD
COMMAND ${CMAKE_COMMAND} -E $>,copy,true>
$ $
COMMAND_EXPAND_LISTS
)
```
## Uso del nuevo diseño con sistemas de compilación personalizados
Compilar para Windows x64 con el GDK requiere lo siguiente.
```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%
```
Compilar para XBOX Series X|S (también conocida como *Gaming.Xbox.Scarlett.x64*) requiere:
```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%
```
Compilar para XBOX One (también conocida como *Gaming.Xbox.XboxOne.x64*) requiere:
```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%
```
## Uso del nuevo diseño para herramientas de contenido de PC
En el desarrollo para consolas, algunos tipos de 'cocinado' (cooking) de contenido se realizan en el PC de desarrollo mediante las API de XTF, la biblioteca de codificación XMA2 o herramientas personalizadas de Direct3D 12.X. Acceder a este contenido requiere una configuración de compilación específica:
Compilar herramientas de PC destinadas tanto a XBOX One como a XBOX Series X|S requiere:
```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%
```
Compilar herramientas de PC destinadas a los gráficos de XBOX Series X|S requiere:
```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%
```
Compilar herramientas de PC destinadas a los gráficos de XBOX One requiere:
```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%
```
## Lectura de la edición de compilación desde un archivo instalado
El nuevo diseño no contiene los archivos `grdk.ini` ni `gxdk.ini`. Para obtener la información de la edición analizando un archivo, use `grdk.h` o `gxdk.h`.
Este es un ejemplo en PowerShell que también funciona con versiones anteriores del 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)
```
## Compilación sin instalación (BWOI)
Los archivos de plataforma de compilación personalizada de MSBuild que en el diseño anterior se encontraban en `\flatDeployment` ahora se encuentran en `\xbox\build`, con rutas de acceso más cortas.
Por ejemplo, para configurar una carpeta de reglas de MSBuild para BWOI para VS 2022, use estos comandos.
```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
```
Después, en el archivo Directory.Build.props usado para BWOI, establezca las propiedades para que apunten a esta carpeta combinada.
```xml theme={null}
c:\temp\msbuildgdk\v170\c:\temp\msbuildgdk\v160\
```
## Related topics
- [Estructura de directorios de encabezados y bibliotecas del GDK](https://docs.xbox.com/es/build/gdk-and-engines/guides/gdk-directory-structure.md)
- [Novedades del Microsoft Game Development Kit (GDK)](https://docs.xbox.com/es/announcements/gdk/whats-new.md)
- [Implementación de Game Saves con el GDK de octubre de 2025](https://docs.xbox.com/es/services/playfab/player-progression/game-saves/october-2025-gdk-changes.md)
- [Índice de temas de NDA para el desarrollo de consolas con el GDK de XBOX](https://docs.xbox.com/es/nda/nda-overview.md)
- [Compilación y ejecución de su primer título de consola con GDKX](https://docs.xbox.com/es/home/build-first-title/first-console-title-walkthrough.md)