Skip to main content
Les types de problèmes identifiés par Submission Validator augmentent et évoluent au fil du temps. L’objectif est de faciliter le parcours de la soumission jusqu’à la mise sur le marché, en passant par la certification. Submission Validator exécute les contrôles de qualité suivants :

Version disponible

Submission Validator 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 de Submission Validator 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), Submission Validator vérifie que le GDK utilisé pour la création du package provient d’une version approuvée du GDK. Si la version ne figure ni dans la liste des versions approuvées ni dans celle des versions 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 a expiré et ne recevra plus de correctifs logiciels.
Si Submission Validator ne parvient 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 incorporé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 incorpore la version du GDK dans une section PE personnalisée nommée .xbld. Submission Validator 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, Submission Validator utilise à la place la version des outils de création de package comme version du GDK pour la soumission. Cette version peut ne pas refléter 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 par Submission Validator. Pour résoudre ce problème, configurez votre outil anti-falsification afin d’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 garde de chiffrement :
La section <exclude> empêche le chiffrement de .xbld.

Game OS approuvé

Submission Validator 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 une utilisation dans les titres publiés. Si la version ne figure ni dans la liste des versions approuvées ni dans celle des versions dépréciées, le journal du validateur inclut un échec, comme illustré dans la section suivante.
Si les versions des composants ne correspondent pas entre elles ou si la version ne figure ni dans la liste des versions approuvées ni dans celle des versions dépréciées, le journal du validateur inclut un échec, comme illustré dans la section suivante.
Submission Validator peut ne pas terminer ses contrôles de validation si le PC de développement sur lequel il s’exécute ne peut pas accéder aux informations en ligne. Par exemple, s’il n’a pas accès à Internet, s’il est bloqué par un pare-feu ou s’il n’a aucune connectivité réseau.

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

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

Fichiers Resources.pri supplémentaires

Submission Validator 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 situé à la racine est utilisé. Toutefois, la présence de plusieurs copies peut prêter à confusion quant à celle qui est correcte et à l’intention des développeurs concernant ces autres fichiers. Ce contrôle est similaire à celui effectué 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 illustré 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

Submission Validator vérifie désormais que les packages ne contiennent qu’une seule application non DevOnly par package.

Taille maximale du package

Lorsque vous distribuez sur disque, Submission Validator vérifie que la taille du package ne dépasse pas 49 900 000 000 octets. Ce contrôle fournit uniquement un message d’information, et non une erreur. Lorsque vous ne distribuez pas sur disque, Submission Validator 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 qui ne devraient pas faire partie d’un titre commercialisé. Le contrôle Foreign File Check utilise le fichier .xml de disposition pour vérifier tous les fichiers ajoutés au package de titre afin de détecter des noms de fichiers et des extensions qui ne sont pas autorisés dans le package. Ce contrôle se base 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 situés à la racine, ainsi que la liste complète des fichiers du système d’exploitation XBOX qui ne peuvent pas figurer dans les packages de titre. Ce contrôle 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 contrôles d’extensions. Si cette situation concerne votre titre, informez-en votre Partner Development Manager (PDM). Si vous estimez être dans un cas exceptionnel nécessitant l’inclusion dans votre package de titre d’un fichier pour lequel vous recevez un message d’échec dans le journal de Submission Validator, consultez votre PDM. L’exemple suivant montre la sortie du journal qui signale des échecs dans le contrôle Foreign File Check.

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 en code managé. Le contrôle Binary Scan Check examine chaque fichier .exe et .dll que vous incluez dans le package de titre et vérifie qu’il répond à ces exigences. Utilisez ce contrôle pour valider 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 plateforme, à PIXEvt.dll ou à XBOX Studio. L’exemple suivant montre la sortie du journal qui signale des échecs dans le contrôle Binary Scan Check. 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 en code natif non AMD64.
Les développeurs doivent s’assurer que ces dépendances axées sur le débogage sont exclues des versions de publication 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 sur le site des forums des développeurs XBOX répertorie ces fichiers et leurs versions approuvées. Submission Validator 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 le titre de partition exclusive intègre au XVC. Comparez les versions aux informations publiées sur les bibliothèques approuvées avant d’effectuer la soumission. Submission Validator extrait également les informations de version des fichiers DLL facultatifs Kinect et XBOX services, si votre titre les inclut. L’exemple suivant montre les informations de version qui apparaissent dans le fichier journal de Submission Validator.

Fichiers dépendants manquants

Lorsque vous effectuez une liaison dynamique avec des bibliothèques dépendantes et que ces bibliothèques sont manquantes, Submission Validator inclut 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. Submission Validator vérifie que le fichier MicrosoftGame.config référence correctement l’exécutable approprié.

Voir aussi

Submission Validator (SubmissionValidator.dll) Messages de Submission Validator Créer un package (makepkg.exe) Création de packages de titres, mises à jour de contenu et test de l’installation en streaming Exigences XBOX (XR) (XBOX Developer Downloads->Partner, Publishing, and Release Management Information->XGD Partner Documentation)
Last modified on October 6, 2026