- Utilisation du validateur de soumission
- Problèmes détectés par le validateur de soumission
- Comprendre le journal des résultats
- Mise à jour du validateur de soumission
- Notes de version du validateur de soumission
Utilisation du validateur de soumission
Le validateur de soumission n’est pas un outil autonome utilisé par le développeur. Il est plutôt appelé automatiquement pour vérifier une application lorsque la commande makepkg pack est utilisée. Pour plus d’informations sur la syntaxe et l’utilisation en ligne de commande, consultez la page de référence makepkg. Le validateur de soumission s’exécute après la création du package de titre. Les échecs de validation sont consignés dans le journal de validation, qui est écrit à l’emplacement de sortie spécifié dans la ligne de commande makepkg. Il s’agit du même emplacement de sortie que celui où le package de titre final est créé. Une version localisée de la sortie est également offerte (en plus de la sortie en anglais) au même emplacement si le paramètre/validationlanguage est défini dans makepkg. La langue de validation supplémentaire actuellement prise en charge est ja-jp.
Un sous-ensemble des tests du validateur de soumission peut être exécuté avant la création du package de titre au moyen de la ligne de commande makepkg validate. Nous recommandons de l’exécuter pour détecter les problèmes avant la création du package.
Problèmes détectés par le validateur de soumission
Les types de problèmes que le validateur de soumission détecte augmenteront et évolueront au fil du temps afin de faciliter le parcours de la soumission à la mise en marché, en passant par la certification. Pour obtenir la liste actuelle des problèmes détectés par le validateur de soumission, consultez Vérifications de qualité du validateur de soumission.Comprendre le journal des résultats
Une fois le processusmakepkg terminé, le fichier XVC du titre apparaît dans le dossier de sortie. Le journal de validation se trouve dans ce même dossier. Vous pouvez le reconnaître à son nom, de la forme « Validator_[identificateur du titre et du package].xml ». Vous devriez examiner ce journal pour repérer les échecs ou les avertissements. En plus des échecs et avertissements déjà présentés dans les sections précédentes, toute balise <failure> désigne une condition qui entraînera le rejet de votre soumission au cours de la phase d’ingestion du contenu, de matriçage et de certification. Bien que rien ne vous empêche de soumettre un tel package, cela vous fera perdre du temps et des efforts. Il est de loin préférable de corriger les problèmes détectés jusqu’à ce que le journal ne contienne plus aucune balise <failure>.
Vous pourriez aussi voir des balises <warning> dans le journal. Celles-ci indiquent généralement des problèmes pouvant nécessiter une exception. Si vous avez des questions sur les avertissements détectés, communiquez avec votre gestionnaire de compte de développeur (DAM). Même si une exception est accordée pour votre titre, la balise <warning> apparaît toujours dans le fichier journal. Pour obtenir la liste complète des messages du journal, consultez Messages du validateur de soumission.
La section <validatorrun> se trouve à la fin du journal, comme illustré ci-dessous. Cette section contient une balise <result> qui indique le résultat global, Fail ou Success, des tests du validateur de soumission. Tout échec dans une section entraîne un échec global.
Mise à jour du validateur de soumission
Le validateur de soumission est implémenté sous la forme d’un fichier SubmissionValidator.dll distinct qui se trouve dans le répertoire\Bin du Microsoft Game Development Kit (GDK). Les mises à jour du validateur de soumission ne correspondent pas toujours au cycle de publication du Microsoft Game Development Kit (GDK). La version actuelle du validateur de soumission peut toujours être téléchargée à partir de developer.microsoft.com/games/resources -> téléchargements. Téléchargez le fichier compressé (.zip), ouvrez-le et placez le fichier SubmissionValidator.dll mis à jour dans le répertoire \Bin du Microsoft Game Development Kit (GDK), en remplaçant la version précédente du validateur de soumission. La page des outils de certification indique également le numéro et la date de la version actuelle. Le fichier compressé contient un fichier texte avec les notes de version de la version actuelle, y compris les problèmes connus et des informations sur les modifications apportées aux vérifications effectuées par le validateur de soumission qui diffèrent des descriptions du présent article.
À partir du GDK d’octobre 2025, makepkg prend en charge l’option /updatesubval, qui vérifie s’il existe une version plus récente de SubmissionValidator.dll. Si une mise à jour est offerte, l’option télécharge et installe la DLL dans le répertoire qui contient makepkg.exe, soit le répertoire \Bin du GDK par défaut. Si /validationpath est spécifié, la DLL est plutôt installée dans ce répertoire. Si la mise à jour échoue, la création du package ou la validation se poursuit avec la version actuellement installée de SubmissionValidator.dll.
À partir du GDK d’octobre 2026, utilisez la commande autonome makepkg updatesubval pour mettre à jour SubmissionValidator.dll sans créer, valider ni téléverser de package. Contrairement à l’option /updatesubval, la commande autonome retourne un code de sortie non nul si la mise à jour échoue.
Lorsqu’une application, un titre ou un package de contenu est soumis à Microsoft, la version actuelle du validateur de soumission est utilisée pour vérifier cette soumission. Avant de soumettre votre application, votre titre ou votre package de contenu, nous vous recommandons de vous assurer que la version actuelle du validateur de soumission est installée sur le PC de développement sur lequel le package de soumission est généré.