Élément MicrosoftGame.config - Executable
Spécifie les détails d’un exécutable spécifique. Les attributs de cette section comprennent le nom de l’exécutable (Name), l’appareil pour lequel il est conçu (TargetDeviceFamily), son ID d’application (Id), s’il s’agit d’un exécutable réservé au développement (IsDevOnly), si le nom d’affichage du nœud ShellVisuals doit être substitué (OverrideDisplayName), si le Logo du nœud ShellVisuals doit être substitué (OverrideLogo), si le Square480x480Logo du nœud ShellVisuals doit être substitué (OverrideSquare480x480Logo), si le Square44x44Logo du nœud ShellVisuals doit être substitué (OverrideSquare44x44Logo), si le SplashScreenImage du nœud ShellVisuals doit être substitué (OverrideSplashScreenImage), et si l’exécutable possède un alias (actuellement pour le bureau seulement).Parent
Le parent de cet élément est l’élément ExecutableList.Exigence
Cet élément doit obligatoirement être défini.Plateforme
Cet élément s’applique au PC et à la console.Comportement
- Les attributs sont :
- Name
- TargetDeviceFamily
- Architecture
- Id
- IsDevOnly
- OverrideDisplayName
- OverrideLogo
- OverrideSquare480x480Logo
- OverrideSquare44x44Logo
- OverrideSplashScreenImage
- Alias
- Les valeurs par défaut sont :
- L’attribut Name n’a pas de valeur par défaut.
- La valeur par défaut de l’attribut TargetDeviceFamily est l’appareil sur lequel vous exécutez le titre.
- La valeur par défaut d’Architecture est x64
- L’attribut Id a une valeur par défaut basée sur l’attribut Name. Si l’attribut Name ne permet pas de générer un Id valide, la valeur de repli Game0 sera utilisée.
- L’attribut IsDevOnly a une valeur par défaut de false.
- L’attribut OverrideDisplayName a comme valeur par défaut celle de l’attribut correspondant dans ShellVisuals.
- L’attribut OverrideLogo a comme valeur par défaut celle de l’attribut correspondant dans ShellVisuals.
- L’attribut OverrideSquare480x480Logo a comme valeur par défaut celle de l’attribut correspondant dans ShellVisuals.
- L’attribut OverrideSquare44x44Logo a comme valeur par défaut celle de l’attribut correspondant dans ShellVisuals.
- L’attribut OverrideSplashScreenImage a comme valeur par défaut celle de l’attribut correspondant dans ShellVisuals.
- Alias n’a pas de valeur par défaut.
- Valeurs autorisées :
- La valeur autorisée de Name est l’exécutable dans un chemin relatif à partir de la racine du jeu.
- Les valeurs autorisées de TargetDeviceFamily sont XboxOne, Scarlett, PC.
- Les valeurs autorisées d’Architecture sont x64 et ARM64
- La valeur autorisée d’Id est une chaîne ASCII d’au plus 64 caractères.
- Les valeurs autorisées d’IsDevOnly sont true ou false.
- La valeur autorisée d’OverrideDisplayName est une chaîne d’au plus 256 caractères.
- La valeur autorisée d’OverrideLogo est un chemin de fichier relatif vers un fichier .png.
- La valeur autorisée d’OverrideSquare480x480Logo est un chemin de fichier relatif vers un fichier .png.
- La valeur autorisée d’OverrideSquare44x44Logo est un chemin de fichier relatif vers un fichier .png.
- La valeur autorisée d’OverrideSplashScreenImage est un chemin de fichier relatif vers un fichier .png.
- La valeur autorisée d’Alias est un nom d’exécutable (identique à Name, mais sans chemin).
Remarques
- L’attribut Name est obligatoire.
- L’attribut TargetDeviceFamily est obligatoire pour la création de packages.
- Lorsque vous incluez un exécutable avec Architecture = ARM64, vous devez également inclure un exécutable avec Architecture = x64. Si vous n’incluez pas de binaire x64, la génération du package échouera avec l’erreur 0x89245212 E_GAMEPACKAGE_CONFIG_x64_EXECUTABLE_REQUIRED
Executable et TargetDeviceFamily
L’élément Executable vise à définir les attributs de l’exécutable de votre titre. Cet élément ne s’applique pas à la configuration des packages DLC. Pendant le développement, n’importe quel nombre d’éléments Executable peut être défini dans l’élément ExecutableList pour le déploiement de fichiers non compressés. Lors de la création du package avant la soumission du package final, plusieurs éléments Executable sont pris en charge et tous les éléments Executable ayant l’attribut IsDevOnly seront inclus dans le package. Toutefois, lors de la soumission du package final pour le mastering et la certification, tout exécutable ayant l’attribut IsDevOnly doit être retiré manuellement du fichier MicrosoftGame.config et du contenu du package. Avant le GDK de mars 2024, les exécutables isDevOnly étaient automatiquement supprimés lors de la génération du package chiffré (signé avec MakePkg.exe pack /lk ou /l). Submission Validator continuera de signaler un ÉCHEC (FAILURE) si un exécutable isDevOnly est trouvé. Lorsque vous spécifiez un élément Executable dans l’élément ExecutableList, vous pouvez fournir un attribut appelé TargetDeviceFamily. Celui-ci vise à préciser l’appareil cible pour lequel l’exécutable est conçu. Les valeurs autorisées de l’attribut TargetDeviceFamily sont XBOX One, Scarlett et PC. La création de packages utilisera par défaut le TargetDeviceFamily XboxOne si aucun Executable n’a l’attribut TargetDevieFamily défini lors de l’exécution de MakePkg pack pour les consoles XBOX. Lorsque vous spécifiez l’indicateur /pc à MakePkg pack, la création de packages utilisera par défaut le TargetDeviceFamily PC si aucun Executable n’a l’attribut TargetDeviceFamily défini. MakePkg.exe exige que tous les exécutables du MicrosoftGame.config utilisent la même spécification TargetDeviceFamily pour générer correctement un package pour votre titre. Vous obtiendrez l’erreur suivante si vous tentez d’exécuter MakePkg.exe alors que deux attributs TargetDeviceFamily différents ou plus sont présents dans votre élément 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
L’attribut Alias de l’élément Executable peut être utilisé pour tirer parti de la fonctionnalité ExecutionAlias afin de lancer votre titre PC à partir de l’invite de commandes par son nom d’alias et avec l’identité du titre. L’attribut Alias doit être défini sur le nom de l’exécutable pour garantir que le titre est inscrit et que l’identité est correcte lors de l’utilisation d’un alias. Si l’alias est utilisé dans le répertoire courant de l’exécutable, Windows se rabattra directement sur le nom de l’exécutable plutôt que sur l’alias; les avantages de l’inscription et de l’identité appropriée ne fonctionneront donc pas dans ce scénario. Si le répertoire courant de l’exécutable figure dans la variable d’environnement %PATH% du PC local, Windows se rabattra également sur l’exécutable plutôt que sur l’alias. Lorsque vous exécutez un alias d’exécution dans une invite de commandes, vous pouvez fournir des arguments au titre au moyen de la syntaxe<ExecutionAlias> [launch args].
Pour plus d’informations sur le lancement de votre titre sur PC, consultez Utilisation des outils du Microsoft Game Development Kit pour installer et lancer votre titre PC.