Saltar al contenido principal
En este documento se describe el proceso para obtener un Microsoft Game Development Kit (GDK) extraído que se puede usar sin instalación. En esta sección se proporcionan instrucciones sobre cómo hacerlo para el GDK y para el SDK de Windows. Este proceso está destinado a usuarios avanzados.
Este proceso no reemplaza la necesidad de instalar el Microsoft Game Development Kit (GDK) en la mayoría de los escenarios. El proceso permite los siguientes escenarios:
  1. Extraer encabezados y bibliotecas para usarlos en el proceso de compilación.
  2. Extraer la carpeta Sideload para que xbprovision (tema con NDA) se pueda ejecutar desde un Microsoft Game Development Kit (GDK) determinado sin instalar ese Microsoft Game Development Kit (GDK) completo.
Es posible ejecutar algunas de las herramientas del Microsoft Game Development Kit (GDK) después de extraer la carga de instalación de esta forma; sin embargo, hacerlo no es compatible oficialmente y podría encontrar problemas.

Descarga del Microsoft Game Development Kit extraído

El Microsoft Game Development Kit (GDK) extraído, una opción disponible para usuarios avanzados, permite integrar archivos específicos en un sistema de compilación sin instalar el Microsoft Game Development Kit (GDK) completo. El Microsoft Game Development Kit (GDK) extraído está disponible como una opción de descarga independiente en el sitio de Descargas para desarrolladores de XBOX. La opción de descarga aparece con la palabra Extracted en el título para diferenciarla de la opción de descarga del instalador del GDK.
Usar esta opción de descarga le permitirá omitir el proceso de extracción manual del Microsoft Game Development Kit. Esta es la opción recomendada.

Extracción manual del Microsoft Game Development Kit

Como alternativa a descargar el Microsoft Game Development Kit (GDK) extraído, puede extraer manualmente los archivos del instalador normal del Microsoft Game Development Kit (GDK). Después de descargar el Microsoft Game Development Kit (GDK) normal, puede usar Windows Installer (msiexec.exe) para extraer cada paquete del instalador y acceder a sus archivos individuales.
En los siguientes procedimientos se muestra un uso específico de Windows Installer (msiexec.exe). Para obtener más información sobre msiexec.exe, consulte Windows Installer.

Extracción del contenido de todos los MSI del Microsoft Game Development Kit (GDK) (con ExtractXboxOneDKs.ps1)

  1. Descargue el instalador del Microsoft Game Development Kit en el sitio de Descargas para desarrolladores de XBOX. O bien, descargue el instalador público del Microsoft Game Development Kit (GDK) desde el repositorio de GitHub (solo admite el desarrollo para PC). El archivo que descargue tendrá un nombre como GDK_03_2022.zip. Anote su ubicación en el equipo.
  2. Extraiga el contenido del archivo .zip local.
  3. Abra un símbolo del sistema de PowerShell y vaya al directorio SetupScripts dentro de la carpeta en la que se extrajo el contenido (por ejemplo, C:\GDKDownload\SetupScripts)
    • El script ExtractXboxOneDKs.ps1 de este directorio se puede usar para extraer el GDK. Su uso es:
      • .\ExtractXboxOneDKs.ps1 -SourcePath <MSI_Source_Folder> -TargetDirectory <Target_Directory>
      • Por ejemplo, SourcePath es la ubicación en la que se extrajo el archivo .zip (por ejemplo, C:\GDKDownload). TargetDirectory es la ubicación a la que irá el contenido extraído (por ejemplo, C:\ExtractedGDK\220300)
  4. Después de ejecutar el script ExtractXboxOneDKs.ps1, los archivos extraídos estarán en el directorio de destino (por ejemplo, C:\ExtractedGDK\220300)
  5. Vaya al directorio de destino y copie los archivos extraídos del GDK en la ubicación que requiera su sistema de compilación.
El directorio de destino incluye un conjunto de archivos .msi y una carpeta Windows Kits como parte de la extracción. Estos se deben omitir y se pueden eliminar. La carpeta Microsoft GDK es la única carpeta del directorio de destino de la extracción que es necesario conservar.

Extracción del contenido de todos los MSI del Microsoft Game Development Kit (GDK) (manual)

  1. Después de descomprimir el GDK (pasos 1-2 de la sección anterior), puede usar Windows Installer (msiexec.exe) para extraer cada paquete del instalador y acceder a sus archivos individuales.
  2. En una ventana del símbolo del sistema, vaya a la carpeta con los archivos extraídos del archivo .zip y ejecute la siguiente línea de comandos:
    donde installation_folder es la ruta de acceso a los archivos descargados del GDK y msi_extraction_path especifica la carpeta en la que desea extraer los archivos de Windows Installer (.msi). Por ejemplo:
    Si este ejemplo de código se usa en un script en lugar de directamente desde la línea de comandos, %G debe reemplazarse por %%G.
  3. Vaya a msi_extraction_path y copie los archivos extraídos del GDK en la ubicación que requiera su sistema de compilación.

Extracción del SDK de Windows

La extracción manual de la carga de instalación del SDK de Windows, una opción disponible para usuarios avanzados, permite integrar archivos específicos en un sistema de compilación sin instalar el SDK de Windows completo. Este paso no es necesario para usar un Microsoft Game Development Kit (GDK) extraído, siempre que el SDK de Windows esté instalado en el sistema.

Extracción del contenido de todos los MSI del SDK de Windows (con ExtractXboxOneDKs.ps1)

A partir del GDK de octubre de 2023, el GDK requiere el SDK de Windows 11 (versión 10.0.22000.0) o posterior.
  1. Descargue el instalador del SDK de Windows desde el Centro de desarrollo de Windows. El archivo que descargue tendrá un nombre como winsdksetup.exe. Anote su ubicación en el equipo.
  2. Abra un símbolo del sistema y ejecute winsdksetup.exe /layout C:\WinSDKDownload en el directorio en el que se descargó el archivo .exe (esto extraerá los archivos .msi del .exe).
  3. Avance por la interfaz de usuario, deje todas las casillas activadas y deje que descargue todos los archivos.
  4. Vaya a C:\WinSDKDownload para confirmar que los archivos .msi están presentes.
    Como alternativa, puede descargar el archivo .ISO del SDK de Windows y montarlo. Contiene los mismos archivos .msi que se obtienen con los pasos 1-4.
  5. Con el script mencionado anteriormente en Extracción del contenido de todos los MSI del Microsoft Game Development Kit (GDK) (con ExtractXboxOneDKs.ps1), indique la carpeta de los archivos .msi (por ejemplo, C:\WinSDKDownload) como SourcePath y otra carpeta (por ejemplo, C:\ExtractedWinSDK) como TargetDirectory, a la que irá el contenido extraído.
    Debido a las rutas de acceso largas de los archivos incluidos, se recomienda limitar los directorios de origen y de destino (solo para la extracción) a 45 caracteres (incluida la letra de unidad). Después, se pueden mover una vez completada la extracción. Superar los 45 caracteres en la ruta de acceso de la carpeta provocará errores de extracción debido a que se supera la longitud máxima de la ruta de acceso de archivo.
  6. Después de ejecutar el script ExtractXboxOneDKs.ps1, los archivos extraídos estarán en el directorio de destino (por ejemplo, C:\ExtractedWinSDK)
  7. Vaya al directorio de destino y copie los archivos extraídos del SDK de Windows en la ubicación que requiera su sistema de compilación.
    Después de esta extracción, habrá muchos archivos y carpetas en el directorio de destino. La carpeta Windows Kits\10 es la que se usa en este ejemplo como referencia para el sistema de compilación. Es posible que se necesiten otras carpetas en función de la acción deseada.

Extracción del contenido de todos los MSI del SDK de Windows (manual)

  1. Después de obtener un conjunto de archivos .msi a partir de winsdksetup.exe (pasos 1-4 de la sección anterior), puede usar Windows Installer (msiexec.exe) para extraer cada paquete del instalador y acceder a sus archivos individuales.
  2. En una ventana del símbolo del sistema, vaya a la carpeta con los archivos extraídos del archivo .zip y ejecute la siguiente línea de comandos:
    donde installation_folder es la ruta de acceso a los archivos descargados del SDK de Windows y msi_extraction_path especifica la carpeta en la que desea extraer los archivos de Windows Installer (.msi). Por ejemplo:
    Si este ejemplo de código se usa en un script en lugar de directamente desde la línea de comandos, %G debe reemplazarse por %%G.
  3. Vaya a msi_extraction_path y copie los archivos extraídos del SDK de Windows en la ubicación que requiera su sistema de compilación.
Al extraer el Microsoft Game Development Kit, se supone que esta carpeta residirá en una ubicación compartida o en un sistema de control de código fuente para acceder a ella al compilar el título. Puede darse un escenario en el que se deseen varias versiones del Microsoft Game Development Kit (GDK). En este escenario, nuestra recomendación con respecto al diseño de varias versiones extraídas del Microsoft Game Development Kit (GDK) es la siguiente:
  • …\ExtractedGDK\211000\Microsoft GDK…
  • …\ExtractedGDK\220300\Microsoft GDK…
Esto permite que la carga completa esté presente para cada versión. Recomendamos usar una variable de entorno de compilación para cambiar entre versiones y definir cuál se usa durante el proceso de compilación.

Consulte también

Configuración del entorno de compilación sin instalar el Microsoft Game Development Kit (GDK) Uso del Microsoft Game Development Kit (GDK) sin instalación
Última modificación el 6 de noviembre de 2026