Skip to main content
Microsoft Game Development Kit (GDK) incluye páginas de propiedades personalizadas de Visual Studio que se usan para configurar proyectos de XBOX.

Para acceder a las páginas de propiedades de XBOX

  1. En el Explorador de soluciones, haga clic con el botón derecho en el nombre del proyecto y, a continuación, seleccione Propiedades.
  2. Expanda Propiedades de configuración.
  3. Observe las páginas de propiedades XBOX General, XBOX Deploy, XBOX Layout y Depuración.
Están disponibles las siguientes páginas de propiedades de XBOX y páginas relacionadas.

XBOX General

La página de propiedades XBOX General contiene las siguientes propiedades.
  • Gaming Edition Target. Especifica la edición del GDK con la que se compilará el proyecto. De forma predeterminada, es la versión más alta del GDK instalada en su PC de desarrollo.
  • Gaming Extension Libraries. Especifica el conjunto de bibliotecas de extensión de juegos que se van a usar (como Xbox.Services.API.C).
  • Alternate Binary Subdirectory. Esta propiedad opcional se usa para especificar un subdirectorio para los archivos binarios y las dependencias de CRT bajo la raíz del juego. Se usa para reflejar la estructura de la carpeta Layout y el depurador la utilizará para encontrar el ejecutable durante la depuración. Al especificar un subdirectorio, el archivo MicrosoftGame.config debe seguir estando en la raíz del título. Cualquier cambio en las rutas de acceso de la ubicación del ejecutable dentro de MicrosoftGame.config también debe actualizarse.
  • Remote IP Address. Especifica el nombre o la dirección IP de la consola remota. Esta es la consola en la que se implementan, ejecutan y depuran los proyectos compilados. Si esta propiedad se deja en blanco, o se establece en blanco, se usa la consola remota predeterminada especificada por Connect (xbconnect.exe), XBOX Manager o Windows Device Portal.
  • Package Localization Dir. Especifica un directorio opcional relativo al directorio del proyecto para usarlo al crear recursos de shell localizados. Consulte Localización de MicrosoftGame.config para obtener información adicional sobre cómo agregar recursos localizados a su proyecto.
Figura 1. La página de propiedades XBOX General Página de propiedades General
También es posible especificar la dirección IP remota dentro de un archivo project.vcxproj.user, almacenado junto con project.vcxproj en el directorio del proyecto. Ese archivo debe tener el siguiente formato.
En el ejemplo anterior, 10.10.10.10 se reemplaza por la dirección de su consola remota.

XBOX Deploy

La página de propiedades XBOX Deploy permite seleccionar cada método de implementación. Según la selección, la página de propiedades incluirá diferentes opciones. Para obtener más información sobre la implementación, consulte Implementación de su título en su kit de desarrollo de XBOX.

Método de implementación de XBOX: Push (ejecutar desde el kit de desarrollo)

Este método de implementación implementa el título en una carpeta del kit de desarrollo (xD:\Titles de forma predeterminada). Este método de implementación contiene las siguientes propiedades.
  • Deployment folder path override. Propiedad opcional que se usa para invalidar la ruta de implementación predeterminada en el kit de desarrollo.
  • Remove extra files from target device. Propiedad opcional que, cuando está marcada, elimina los archivos encontrados en la consola que no forman parte de la salida de compilación del proyecto (archivos huérfanos).

Método de implementación de XBOX: External (Visual Studio no se usa para la implementación)

Este método de implementación delega la implementación en un mecanismo externo e independiente. Este método de implementación contiene las siguientes propiedades.
  • Title launch string. Cadena de inicio que se usa para iniciar el título cuando comienza la depuración (F5).
  • Target devkit titles. Seleccione de una lista de títulos que coinciden con el proyecto actual en el kit de desarrollo de destino para rellenar la cadena de inicio del título.

Método de implementación de XBOX: Run from PC (registrar recurso compartido de red)

Este método de implementación ejecuta el título desde el PC de desarrollo mediante un recurso compartido de red accesible para el kit de desarrollo.
  • Network share path override. Propiedad opcional que se usa para invalidar la ruta predeterminada del recurso compartido de red para la implementación Run From PC.
  • Network share username. Propiedad opcional que se usa para acceder a ubicaciones de recursos compartidos de red que requieren credenciales (recurso compartido de red SMB).
  • Network share password. Propiedad opcional que se usa para acceder a ubicaciones de recursos compartidos de red que requieren credenciales (recurso compartido de red SMB).
precauciónPRECAUCIÓN: Este nombre de usuario y contraseña se pasan como texto sin formato y se almacenan localmente como texto sin formato. Para mayor seguridad, deje este campo en blanco y administre sus credenciales como se muestra en XBOX Device Portal (Windows Device Portal en XBOX) o Developer Home en la consola (Dev Home).
Figura 2. Las páginas de propiedades XBOX Deploy según el método de implementación Página de propiedades Deploy para Push

XBOX Layout

La página de propiedades XBOX Layout contiene las siguientes propiedades.
  • Layout Directory. Especifica el directorio local donde se disponen los resultados de la compilación. Es desde este directorio desde donde se implementa la aplicación en la consola remota.
  • Exclusion Filter. Especifica los archivos y tipos de archivo que no se copiarán del directorio de salida de compilación al directorio de diseño. Tenga en cuenta que esta propiedad no se puede usar para excluir archivos que residen fuera del directorio de salida de compilación.
  • Isolate Configurations. Cuando se establece en , Visual Studio trata cada configuración de compilación como una salida independiente para determinar la lista de archivos copiados al directorio de diseño. El valor predeterminado es No.
  • Game OS. Especifica la ruta al Game OS que se proporcionará con el diseño de archivos sueltos de un título.
  • Deploy from Outdir. Cuando se establece en , Visual Studio implementará el contenido del directorio de salida de compilación en lugar de copiar los archivos al directorio de diseño antes de la implementación. Se ignorarán los valores de las propiedades Layout Directory, Exclusion Filter e Isolate Configurations.
Figura 3. La página de propiedades XBOX Layout Página de propiedades Layout

Depuración

La página de propiedades Depuración contiene las siguientes propiedades.
  • Debugger to launch: Para proyectos de XBOX, seleccione XBOX Game Core Debugger.
  • Debugger Type. Especifica el tipo de depurador que se va a usar. Cuando se establece en Auto, el tipo de depurador se selecciona según el contenido del archivo .exe.
  • Command Arguments. Los argumentos de línea de comandos que se pasan a la aplicación.
  • Log Module Loading. Habilita la salida de depuración detallada, que incluye información de carga de módulos. La opción Log Module Loading es útil para depurar problemas de tipo “dependent dll was not found”.
Figura 4. La página de propiedades Depuración Página de propiedades Depuración

Páginas de propiedades relacionadas

Hay propiedades adicionales que, aunque no son exclusivas de XBOX, tienen configuraciones obligatorias o recomendadas para las aplicaciones de XBOX. Estas configuraciones garantizan el funcionamiento correcto y óptimo de las aplicaciones de XBOX y son las siguientes. RandomizedBaseAddress: Debe establecerse en , que es el valor predeterminado para un proyecto de GDK. Esta configuración es necesaria para que funcione la selección aleatoria del diseño del espacio de direcciones (ASLR). Las aplicaciones de XBOX requieren ASLR. No establezca RandomizedBaseAddress en No ni intente deshabilitar ASLR. RandomizedBaseAddress se establece en la página de propiedades Vinculador/Avanzadas.

Búsqueda de dependencias del juego

Al especificar una dependencia del juego dentro de su proyecto, se buscará en la ruta local, además de en la raíz del juego G: y en todos los subdirectorios, para encontrar los archivos dependientes.

Consulte también

Application Management (xbapp.exe) Connect (xbconnect.exe) Implementación de su título en su kit de desarrollo de XBOX Cómo: implementar archivos de recursos del juego mediante Visual Studio
Última modificación el 28 de agosto de 2026