XBOX Gaming Project Control

El GDK instala en el shell de Visual Studio una ventana de herramientas denominada XBOX Gaming Project Control. Esta ventana de herramientas proporciona una ubicación central en la que administrar todas las opciones de proyecto específicas de XBOX. Además de centralizar la administración de las opciones de proyecto de XBOX, el XBOX Gaming Project Control también ayuda a garantizar que las opciones sean correctas y den como resultado una implementación y una sesión de depuración correctas. Las opciones individuales se validan a medida que se especifican. También se señalan los casos en los que el valor de una opción es diferente entre configuraciones. La identificación de estas discrepancias tiene como objetivo ayudar a encontrar de antemano los casos en los que las opciones se establecieron inadvertidamente en valores diferentes en configuraciones distintas. Por ejemplo, el XBOX Gaming Project Control resaltará los casos en los que el método de implementación sea diferente entre sus configuraciones Debug, Release y Profile. Use el menú XBOX para acceder al XBOX Gaming Project Control. El menú XBOX se encuentra en el menú Extensions de Visual Studio, como se muestra en la siguiente figura. La página de información general identifica la configuración y la plataforma seleccionadas actualmente, y proporciona un conjunto de botones que se usan para acceder a las páginas de detalles con las que se configuran las siguientes opciones.

• Implementación
• Asignación de MicrosoftGameConfig.mgc
• Argumentos de comando
• Registro de cargas de módulos
• Interrupción por tiempo de espera de suspensión

Una lista desplegable Advanced Controls proporciona acceso a las páginas de edición de las propiedades Deploy from OutDir, OutDir, LayoutDir y LayoutExtensionFilter. Una marca de verificación verde en un botón de opciones indica que los valores de las opciones de esa categoría se han validado y son los mismos en todas las configuraciones. Un signo de exclamación rojo indica que hay un error en el valor de una opción o que los valores de una opción no son los mismos en todas las configuraciones. En la siguiente figura, las opciones de Command Arguments son válidas y coherentes, pero las opciones de Deployment no lo son. Tenga en cuenta que una opción cuyo valor varía según la configuración no siempre significa que la opción esté configurada incorrectamente. Por ejemplo, es bastante común tener diferentes argumentos de línea de comandos para diferentes configuraciones. En cambio, usar diferentes métodos de implementación por configuración es poco común y, por lo tanto, puede ser una indicación de que las opciones de implementación se descoordinaron inadvertidamente. La presencia de un signo de exclamación rojo es una indicación de que quizá quiera revisar sus opciones, más que una indicación absoluta de que las opciones son incorrectas. Los cambios realizados en las propiedades mediante el XBOX Gaming Project Control se escriben inmediatamente en el archivo del proyecto. No se necesita ninguna acción adicional en forma de botón Ok o Apply. Todas las ediciones están totalmente integradas con la pila de deshacer/rehacer de Visual Studio. Acceda a la pila de deshacer/rehacer mediante la barra de herramientas de Visual Studio o las secuencias de teclas estándar Ctrl-Z y Ctrl-Y. La siguiente figura muestra una pila de deshacer que contiene varias propiedades editadas con el XBOX Gaming Project Control. Las propiedades que se pueden editar mediante el XBOX Gaming Project Control también se pueden editar mediante la página de propiedades del proyecto de C++ de Visual Studio. Los valores de todas las propiedades se mantienen sincronizados entre las dos ventanas a medida que se realizan las ediciones.

​

Opciones de implementación

Use la página Deployment para especificar el método de implementación y las opciones específicas del método para la configuración y la plataforma activas. Elija un método de implementación seleccionando uno de los botones Push, RfPC o External. El método de implementación seleccionado actualmente se indica mediante un resaltado verde alrededor del botón del método de implementación correspondiente. Las opciones específicas de un método de implementación se muestran según el método seleccionado. En la siguiente figura, está seleccionado el método de implementación RfPC. Hay cuadros de edición disponibles para cambiar la cadena de inicio y para especificar credenciales opcionales. Si el método de implementación no es el mismo en todas las configuraciones, el motivo de las diferencias se muestra en un control situado a la derecha de los botones de método de implementación. En la siguiente figura, la página de implementación está editando actualmente las opciones de implementación de la configuración Profile, cuyo método de implementación está establecido en RfPC. Sin embargo, el método de implementación de la configuración Release está establecido en Push, como se indica en el control de diferencias de implementación. El botón Align se puede usar para sincronizar las opciones de implementación entre configuraciones, si lo desea. Al hacer clic en el botón Align en este caso, se cambiará el método de implementación de la configuración Release de Push al método usado en la configuración y la plataforma actuales, RfPC en este caso.

​

Opciones de MicrosoftGameConfig.mgc

El sistema de proyectos de Visual Studio y los archivos de msbuild incluyen compatibilidad para especificar diferentes archivos MicrosoftGameConfig.mgc para cada configuración de compilación. Los archivos MicrosoftGameConfig.mgc se renombran a MicrosoftGame.config cuando se copian en el directorio de salida al compilar un proyecto. Al hacer clic en el botón MicrosoftGame.config assigment, se abre una página que le permite especificar el archivo MicrosoftGameConfig.mgc que se usará para cada configuración de compilación. También se puede especificar un archivo MicrosftGameConfig.mgc predeterminado. Este archivo predeterminado se usará para todas las configuraciones a menos que se invalide explícitamente. Use la lista desplegable Project Default para especificar un archivo MicrosoftGameConfig.mgc predeterminado, como se muestra en la siguiente figura. Tenga en cuenta que, cuando un proyecto se crea por primera vez con una de las plantillas del Microsoft Game Development Kit (GDK), se establece implícitamente un MicrosoftGameConfig.mgc predeterminado. Las configuraciones cuyo valor de lista desplegable sea Unselected usarán el archivo MicrosoftGameConfig.mgc predeterminado. Seleccione un archivo de la lista desplegable para invalidar el archivo predeterminado para una configuración determinada, como se muestra en la siguiente figura.

​

Argumentos de comando

Use la página Command Arguments para editar los argumentos de cada configuración de compilación. Se proporcionan cuadros de edición separados para cada configuración.

​

Registro de cargas de módulos

Use el botón Logging of Module Loads para habilitar la salida de depuración detallada, que incluye información de carga de módulos. El control deslizante del propio botón alterna la propiedad para la configuración de compilación activa. Haga clic en el botón para abrir una página que le permite especificar valores para todas las configuraciones de compilación.

​

Interrupción por tiempo de espera de suspensión

Use el botón Break execution on suspend timeout para volver a habilitar el tiempo de espera de suspensión de 1 segundo cuando hay un depurador asociado. El control deslizante del propio botón alterna la propiedad para la configuración de compilación activa. Haga clic en el botón para abrir una página que le permite especificar valores para todas las configuraciones de compilación.

​

Controles avanzados

Use la lista desplegable Advanced controls para acceder a las páginas de edición de las propiedades Deploy from Outdir, LayoutDir, LayoutExtensionFilter y OutDir. Se proporcionan cuadros de edición individuales o controles deslizantes para editar los valores de las propiedades de cada configuración.

​

Consulte también

Visual Studio Propiedades de Visual Studio para el desarrollo de XBOX