Skip to main content
Les types de problèmes que le validateur de soumission détecte augmentent et évoluent au fil du temps. L’objectif est de faciliter le parcours de la soumission à la mise en marché, en passant par la certification. Le validateur de soumission effectue les vérifications de qualité suivantes :

Version disponible

Le validateur de soumission vérifie que la version que vous avez installée est la version la plus récente et la bonne version. Si ce n’est pas le cas, le journal de sortie du validateur de soumission indique un échec. Le message d’échec, présenté dans la section suivante, contient un lien permettant de télécharger la bonne version.

Version du GDK approuvée

Lorsque vous créez un package GDK pour PC (msixvc), le validateur de soumission vérifie que le GDK utilisé pour créer le package provient d’une version du GDK approuvée. Si la version ne figure pas dans la liste des versions approuvées ou dépréciées, le journal du validateur indique un échec.
Si la version figure dans la liste des versions dépréciées, le journal du validateur affiche un message d’information. Ce message indique que la version est expirée et ne recevra plus de correctifs.
Si le validateur de soumission ne peut pas déterminer la version du GDK à partir des fichiers inclus dans le package, par exemple parce que les fichiers sont chiffrés, il affiche le message suivant.

Comment la version du GDK est intégrée dans les exécutables de jeu

Lorsque vous compilez un exécutable de jeu à l’aide d’un GDK qui inclut XGameRuntime.h, le compilateur intègre la version du GDK dans une section PE personnalisée nommée .xbld. Le validateur de soumission lit cette section pour déterminer quelle version du GDK a été utilisée pour générer les binaires du titre. Si la section .xbld est manquante ou illisible, le validateur de soumission utilise plutôt la version des outils de création de packages comme version du GDK pour la soumission. Cette version pourrait ne pas représenter fidèlement la version du GDK utilisée pour compiler vos binaires. Cause courante : logiciel anti-falsification Les outils anti-falsification et de chiffrement des données qui traitent votre exécutable peuvent chiffrer ou supprimer la section .xbld. Cette action rend la section illisible pour le validateur de soumission. Pour résoudre ce problème, configurez votre outil anti-falsification pour exclure la section .xbld du traitement.

Themida

Ajoutez l’option avancée suivante (séparée par des virgules) à votre fichier de configuration Themida pour exclure la section .xbld de la protection :

GuardIT

Pour exclure la section .xbld du chiffrement des données dans GuardIT, ajoutez une entrée <exclude> à la configuration de votre protection par chiffrement :
La section <exclude> empêche le chiffrement de .xbld.

Game OS approuvé

Le validateur de soumission vérifie que le Game OS et tous les composants facultatifs du Microsoft Game Development Kit (GDK) proviennent de la même version du Microsoft Game Development Kit (GDK) et qu’il s’agit d’une version approuvée pour les titres publiés. Si la version ne figure pas dans la liste des versions approuvées ou dépréciées, le journal du validateur indique un échec, comme le montre la section suivante.
Si les versions des composants ne correspondent pas entre elles ou si la version ne figure pas dans les listes des versions approuvées ou dépréciées, le journal du validateur indique un échec, comme le montre la section suivante.
Le validateur de soumission pourrait ne pas terminer ses vérifications si le PC de développement sur lequel il s’exécute ne peut pas accéder aux informations en ligne. Par exemple, il n’a pas accès à Internet, il est bloqué par un pare-feu ou il n’a aucune connectivité réseau.

Marqueur de lancement dans le bloc final pour le contenu (contenu téléchargeable (DLC))

Pour garantir un fonctionnement adéquat dans tous les scénarios, les packages de contenu doivent marquer le bloc final avec l’attribut de marqueur de lancement. Si le bloc final n’inclut pas le marqueur de lancement, il est possible que le package soit testé correctement, mais qu’il cause des problèmes aux utilisateurs finaux dans certains cas. Le message d’échec est présenté ci-dessous.

Fichiers Resources.pri supplémentaires

Le validateur de soumission vérifie qu’aucun fichier Resources.pri supplémentaire n’existe dans d’autres répertoires de la disposition. Comme pour MicrosoftGame.config, seul celui qui se trouve à la racine est utilisé. Toutefois, la présence de plusieurs copies pourrait créer de la confusion quant à savoir laquelle est la bonne et quelle est l’intention des développeurs à l’égard de ces autres fichiers. Cette vérification est semblable à celle effectuée pour les copies supplémentaires de MicrosoftGame.config. Dans ce cas, les copies supplémentaires entraînent un échec dans la section Foreign Files Check du journal, comme ci-dessous.

Fichier Resources.pri manquant

Les applications n’ont pas besoin d’être localisées. Toutefois, si une application n’inclut pas de fichier Resources.pri à la racine (au même emplacement que MicrosoftGame.config), l’avertissement suivant apparaît dans la section Foreign Files Check du journal de sortie.

Une application par package

Le validateur de soumission vérifie maintenant que les packages ne contiennent qu’une seule application non DevOnly par package.

Taille maximale du package

Lorsque vous distribuez sur disque, le validateur de soumission vérifie que la taille du package ne dépasse pas 49 900 000 000 octets. Cette vérification ne fournit qu’un message d’information, et non une erreur. Lorsque vous ne distribuez pas sur disque, le validateur de soumission vérifie que la taille du package ne dépasse pas 500 Go. Il fournit également un message d’avertissement lorsque la taille du package dépasse 450 Go. Les messages sont les suivants :

Fichier étranger

L’un des problèmes rencontrés lors de l’examen des soumissions pour le programme XBOX 360 est l’inclusion, généralement accidentelle, de divers fichiers dans la soumission qui ne devraient pas faire partie d’un titre commercial. La vérification des fichiers étrangers (Foreign File Check) utilise le fichier .xml de disposition pour vérifier si tous les fichiers intégrés au package de titre comportent des noms de fichiers et des extensions qui ne sont pas autorisés dans le package. Cette vérification repose uniquement sur les noms de fichiers, et non sur leur contenu. Les fichiers non autorisés comprennent les extensions liées aux fichiers sources et de débogage, Thumb.db, les fichiers d’inscription superflus autres que ceux de la racine, ainsi que la liste complète des fichiers du système d’exploitation XBOX qui ne peuvent pas apparaître dans les packages de titres. Cette vérification valide l’exigence XBOX XR-003 : Title Quality for Submission. Le tableau suivant présente les types de fichiers et les extensions qui ne sont pas autorisés dans le package de titre soumis. Un titre peut légitimement utiliser presque n’importe quelle extension de fichier imaginable, ce qui peut entraîner des conflits potentiels avec les vérifications des extensions. Si cette situation touche votre titre, avisez votre gestionnaire du développement des partenaires (PDM). Si vous estimez avoir un cas exceptionnel qui nécessite l’inclusion dans votre package de titre d’un fichier pour lequel vous recevez un message d’échec dans le journal du validateur de soumission, consultez votre PDM. L’exemple suivant montre la sortie du journal qui signale des échecs dans la vérification des fichiers étrangers.

Analyse des binaires

Les fichiers binaires de console XBOX (.exe et .dll) doivent être générés pour AMD64 et ne contenir que du code natif. Actuellement, la plateforme ne prend pas en charge les binaires de code managé. La vérification Binary Scan examine chaque fichier .exe et .dll que vous incluez dans le package de titre et s’assure qu’il respecte ces exigences. Utilisez cette vérification pour valider l’exigence XR-003 : Title Quality for Submission. Dans la section Binary Scan, chaque fichier .exe et .dll est vérifié afin de détecter les dépendances bloquées pour des raisons de sécurité sur les consoles commerciales. En général, ce blocage prend la forme d’une liaison à une version de débogage d’un fichier de la plateforme, à PIXEvt.dll ou à XBOX Studio. L’exemple suivant montre la sortie du journal qui signale des échecs dans la vérification Binary Scan. Les deux premiers échecs résultent d’un fichier .exe lié à deux fichiers qui ne sont pas autorisés sur les consoles commerciales. Le troisième échec concerne un fichier .exe managé. Le dernier échec concerne un fichier .dll de code natif non AMD64.
Les développeurs doivent s’assurer que ces dépendances axées sur le débogage sont exclues des versions commerciales des binaires à inclure dans un package de soumission.

Versions des composants Microsoft

Le Game OS couvre une grande partie de la surface de la plateforme XBOX. Toutefois, les titres redistribuent un ensemble de binaires fournis par Microsoft. La page Approved Libraries du site des forums des développeurs XBOX répertorie ces fichiers et leurs versions approuvées. Le validateur de soumission vérifie les versions de ces fichiers pour s’assurer que les fichiers DLL facultatifs ont des versions correspondantes. Il capture également l’ID de version du Game OS que les packages de titre de la partition exclusive intègrent dans le fichier XVC. Comparez les versions aux informations publiées sur les bibliothèques approuvées avant de soumettre. Le validateur de soumission extrait également les informations de version des fichiers DLL facultatifs de Kinect et des services XBOX, si votre titre les inclut. L’exemple suivant montre les informations de version qui apparaissent dans le fichier journal du validateur de soumission.

Fichiers dépendants manquants

Lorsque vous effectuez une liaison dynamique à des bibliothèques dépendantes et que ces bibliothèques sont manquantes, le validateur de soumission indique l’échec suivant :

Binaires ARM64

Vous pouvez inclure des binaires ARM64 dans votre package de jeu pour PC, en plus de vos exécutables compilés x64 existants. Le validateur de soumission vérifie que le fichier MicrosoftGame.config référence correctement l’exécutable approprié.

Voir aussi

Validateur de soumission (SubmissionValidator.dll) Messages du validateur de soumission Créer un package (makepkg.exe) Création de packages de titres, mises à jour de contenu et tests d’installation en continu Exigences XBOX (XR) (XBOX Developer Downloads->Partner, Publishing, and Release Management Information->XGD Partner Documentation)
Last modified on October 6, 2026