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:
- Extraer encabezados y bibliotecas para usarlos en el proceso de compilación.
- 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.
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.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.Extracción del contenido de todos los MSI del Microsoft Game Development Kit (GDK) (con ExtractXboxOneDKs.ps1)
- 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.
- Extraiga el contenido del archivo .zip local.
- 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)
- El script ExtractXboxOneDKs.ps1 de este directorio se puede usar para extraer el GDK. Su uso es:
- Después de ejecutar el script ExtractXboxOneDKs.ps1, los archivos extraídos estarán en el directorio de destino (por ejemplo, C:\ExtractedGDK\220300)
- 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)
- 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.
-
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. - 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.
- 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.
- 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).
- Avance por la interfaz de usuario, deje todas las casillas activadas y deje que descargue todos los archivos.
- Vaya a C:\WinSDKDownload para confirmar que los archivos .msi están presentes.
-
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.
- Después de ejecutar el script ExtractXboxOneDKs.ps1, los archivos extraídos estarán en el directorio de destino (por ejemplo, C:\ExtractedWinSDK)
-
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)
- 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.
-
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. - 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.
Diseño recomendado para admitir varias versiones extraídas del Microsoft Game Development Kit (GDK)
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…
