Elemento de MicrosoftGame.config - Executable
Especifica los detalles de un ejecutable concreto. Los atributos de esta sección incluyen el nombre del ejecutable (Name), el dispositivo para el que está compilado (TargetDeviceFamily), su identificador de aplicación (Id), si es un ejecutable solo para desarrollo (IsDevOnly), si se debe invalidar el nombre para mostrar del nodo ShellVisuals (OverrideDisplayName), si se debe invalidar el Logo del nodo ShellVisuals (OverrideLogo), si se debe invalidar el Square480x480Logo del nodo ShellVisuals (OverrideSquare480x480Logo), si se debe invalidar el Square44x44Logo del nodo ShellVisuals (OverrideSquare44x44Logo), si se debe invalidar el SplashScreenImage del nodo ShellVisuals (OverrideSplashScreenImage) y si el ejecutable tiene un alias (actualmente solo en escritorio).Elemento primario
El elemento primario de este elemento es el elemento ExecutableList.Requisito
Es obligatorio establecer este elemento.Plataforma
Este elemento se aplica a PC y consola.Comportamiento
- Los atributos son:
- Name
- TargetDeviceFamily
- Architecture
- Id
- IsDevOnly
- OverrideDisplayName
- OverrideLogo
- OverrideSquare480x480Logo
- OverrideSquare44x44Logo
- OverrideSplashScreenImage
- Alias
- Los valores predeterminados son:
- El atributo Name no tiene un valor predeterminado.
- El valor predeterminado del atributo TargetDeviceFamily es el dispositivo en el que se ejecuta el título.
- El valor predeterminado de Architecture es x64.
- El atributo Id tiene un valor predeterminado basado en el atributo Name. Si el atributo Name no puede generar un Id válido, se usará el valor de reserva Game0.
- El atributo IsDevOnly tiene un valor predeterminado de false.
- El atributo OverrideDisplayName tiene como valor predeterminado el de su atributo correspondiente en ShellVisuals.
- El atributo OverrideLogo tiene como valor predeterminado el de su atributo correspondiente en ShellVisuals.
- El atributo OverrideSquare480x480Logo tiene como valor predeterminado el de su atributo correspondiente en ShellVisuals.
- El atributo OverrideSquare44x44Logo tiene como valor predeterminado el de su atributo correspondiente en ShellVisuals.
- El atributo OverrideSplashScreenImage tiene como valor predeterminado el de su atributo correspondiente en ShellVisuals.
- Alias no tiene valor predeterminado.
- Valores permitidos:
- El valor permitido de Name es el ejecutable en una ruta de acceso relativa desde la raíz del juego.
- Los valores permitidos de TargetDeviceFamily son XboxOne, Scarlett y PC.
- Los valores permitidos de Architecture son x64 y ARM64.
- El valor permitido de Id es una cadena ASCII de hasta 64 caracteres.
- Los valores permitidos de IsDevOnly son true o false.
- El valor permitido de OverrideDisplayName es una cadena de hasta 256 caracteres.
- El valor permitido de OverrideLogo es una ruta de acceso de archivo relativa a un archivo .png.
- El valor permitido de OverrideSquare480x480Logo es una ruta de acceso de archivo relativa a un archivo .png.
- El valor permitido de OverrideSquare44x44Logo es una ruta de acceso de archivo relativa a un archivo .png.
- El valor permitido de OverrideSplashScreenImage es una ruta de acceso de archivo relativa a un archivo .png.
- El valor permitido de Alias es un nombre de ejecutable (igual que Name, pero no puede incluir una ruta de acceso).
Comentarios
- El atributo Name es obligatorio.
- El atributo TargetDeviceFamily es obligatorio para el empaquetado.
- Al incluir un ejecutable con Architecture = ARM64, también debe incluir un ejecutable con Architecture = x64. Si no incluye un binario x64, el paquete no se compilará y se producirá el error 0x89245212 E_GAMEPACKAGE_CONFIG_x64_EXECUTABLE_REQUIRED
Executable y TargetDeviceFamily
El elemento Executable está pensado para establecer atributos para el ejecutable del título. Este elemento no es aplicable a la configuración de paquetes de DLC. Durante el desarrollo, es válido definir cualquier número de elementos Executable en el elemento ExecutableList para la implementación de archivos sueltos. Al empaquetar antes del envío del paquete final, se admiten varios elementos Executable y cualquier número de elementos ejecutables con el atributo IsDevOnly se incluirá en el paquete. Sin embargo, durante el envío del paquete final para la creación de la versión maestra y la certificación, cualquier ejecutable con el atributo IsDevOnly debe eliminarse manualmente del archivo MicrosoftGame.config y del contenido del paquete. Antes de la versión del GDK de marzo de 2024, los ejecutables isDevOnly se eliminaban automáticamente como parte de la generación de paquetes cifrados (firmados con MakePkg.exe pack /lk o /l). Submission Validator seguirá emitiendo un error (FAILURE) si se encuentra un ejecutable isDevOnly. Al especificar un elemento Executable en el elemento ExecutableList, puede proporcionar un atributo denominado TargetDeviceFamily. Está pensado para especificar el dispositivo de destino para el que está compilado el ejecutable. Los valores permitidos del atributo TargetDeviceFamily son XBOX One, Scarlett y PC. El empaquetado usará de forma predeterminada el TargetDeviceFamily XboxOne si ningún Executable tiene definido el atributo TargetDevieFamily al ejecutar MakePkg pack para consolas XBOX. Al especificar la marca /pc en MakePkg pack, el empaquetado usará de forma predeterminada el TargetDeviceFamily PC si ningún Executable tiene definido el atributo TargetDeviceFamily. MakePkg.exe requiere que todos los ejecutables del archivo MicrosoftGame.config usen la misma especificación de TargetDeviceFamily para generar correctamente un paquete para el título. Obtendrá el siguiente error al intentar ejecutar MakePkg.exe con dos o más atributos TargetDeviceFamily presentes en el elemento ExecutableList. Error: All executables must have the same value for TargetDeviceFamily in the MicrosoftGame.config file when building a package. (found XboxOne and Scarlett)ExecutionAlias
El atributo Alias del elemento Executable se puede usar para beneficiarse de la funcionalidad ExecutionAlias para iniciar el título de PC desde el símbolo del sistema por su nombre de alias y con la identidad del título. El atributo Alias debe establecerse en el nombre del ejecutable para garantizar que el título quede registrado y que la identidad sea correcta al usar un alias. Si el alias se usa en el directorio actual del ejecutable, Windows recurrirá directamente al nombre del ejecutable en lugar del alias y, por tanto, las ventajas del registro y de la identidad correcta no funcionarán en este escenario. Si el directorio actual del ejecutable está en la variable de entorno %PATH% del PC local, también recurrirá al ejecutable en lugar del alias. Al ejecutar un alias de ejecutable en un símbolo del sistema, puede proporcionar argumentos al título mediante el uso de<ExecutionAlias> [launch args].
Para obtener más información sobre cómo iniciar el título en PC, consulte Utilizar las herramientas de Microsoft Game Development Kit para instalar e iniciar el título de PC.