Élément MicrosoftGame.config - Executable
Spécifie les détails d’un exécutable spécifique. Les attributs de cette section incluent 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 remplacé (OverrideDisplayName), si le logo (Logo) du nœud ShellVisuals doit être remplacé (OverrideLogo), si le Square480x480Logo du nœud ShellVisuals doit être remplacé (OverrideSquare480x480Logo), si le Square44x44Logo du nœud ShellVisuals doit être remplacé (OverrideSquare44x44Logo), si le SplashScreenImage du nœud ShellVisuals doit être remplacé (OverrideSplashScreenImage), et si l’exécutable possède un alias (actuellement Desktop uniquement).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 concerne le 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 secours Game0 est utilisée.
- L’attribut IsDevOnly a la valeur par défaut false.
- L’attribut OverrideDisplayName a pour valeur par défaut celle de l’attribut correspondant dans ShellVisuals.
- L’attribut OverrideLogo a pour valeur par défaut celle de l’attribut correspondant dans ShellVisuals.
- L’attribut OverrideSquare480x480Logo a pour valeur par défaut celle de l’attribut correspondant dans ShellVisuals.
- L’attribut OverrideSquare44x44Logo a pour valeur par défaut celle de l’attribut correspondant dans ShellVisuals.
- L’attribut OverrideSplashScreenImage a pour 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 pour Name est l’exécutable, sous forme de chemin relatif à partir de la racine du jeu.
- Les valeurs autorisées pour TargetDeviceFamily sont XboxOne, Scarlett, PC.
- Les valeurs autorisées pour Architecture sont x64 et ARM64
- La valeur autorisée pour Id est une chaîne ASCII de 64 caractères maximum.
- Les valeurs autorisées pour IsDevOnly sont true ou false.
- La valeur autorisée pour OverrideDisplayName est une chaîne de 256 caractères maximum.
- La valeur autorisée pour OverrideLogo est un chemin de fichier relatif vers un fichier .png.
- La valeur autorisée pour OverrideSquare480x480Logo est un chemin de fichier relatif vers un fichier .png.
- La valeur autorisée pour OverrideSquare44x44Logo est un chemin de fichier relatif vers un fichier .png.
- La valeur autorisée pour OverrideSplashScreenImage est un chemin de fichier relatif vers un fichier .png.
- La valeur autorisée pour 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 est destiné à 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, un nombre quelconque d’éléments Executable peut être défini dans l’élément ExecutableList pour le déploiement de fichiers libres. Lors de la création de packages avant la soumission du package final, plusieurs éléments Executable sont pris en charge, et tous les éléments Executable dotés de l’attribut IsDevOnly seront inclus dans le package. Cependant, lors de la soumission du package final pour le mastering et la certification, tout exécutable doté de l’attribut IsDevOnly doit être supprimé 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 détecté. Lorsque vous spécifiez un élément Executable dans l’élément ExecutableList, vous pouvez fournir un attribut appelé TargetDeviceFamily. Celui-ci est destiné à spécifier 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 utilise par défaut le TargetDeviceFamily XboxOne si aucun Executable ne définit l’attribut TargetDevieFamily lors de l’exécution de MakePkg pack pour les consoles XBOX. Lorsque l’indicateur /pc est spécifié pour MakePkg pack, la création de packages utilise par défaut le TargetDeviceFamily PC si aucun Executable ne définit l’attribut TargetDeviceFamily. 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 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 permet de bénéficier de la fonctionnalité ExecutionAlias pour lancer votre titre PC depuis 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 afin de 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 actif de l’exécutable, Windows utilisera directement le nom de l’exécutable plutôt que l’alias ; les avantages de l’inscription et d’une identité correcte ne fonctionneront donc pas dans ce scénario. Si le répertoire actif de l’exécutable figure dans la variable d’environnement %PATH% du PC local, Windows utilisera également l’exécutable plutôt que l’alias. Lors de l’exécution d’un alias d’exécutable dans une invite de commandes, vous pouvez fournir des arguments au titre via 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.