提交验证器 (SubmissionValidator.dll)

项目
05/10/2023

提交验证器是 Microsoft 游戏开发工具包 (GDK) 的一个组件，可以针对游戏或应用程序包运行一系列基本质量检查。提交验证器可以向开发者提供反馈，以使他们能够解决在 Microsoft 内容引入和认证过程中导致游戏失败的常见问题。当提交游戏包时，提交验证器的最新版本用于检测任何可能导致游戏被拒绝的错误。提交验证器的总体目标是自动执行这些检查并尽可能早地将它们推送到进程中，以确保合作伙伴能够自行诊断和纠正问题，然后再提交游戏包以进行认证。

使用提交验证器
提交验证器识别的问题
了解结果日志
更新提交验证器
提交验证程序发行说明

使用提交验证器

提交验证器不是由开发者使用的独立工具。相反，只要使用 makepkg pack 命令，就会自动调用提交验证器来检查应用程序。有关语法和命令行用法的详细信息，请参阅 makepkg 参考页。

提交验证器将在游戏包创建之后运行。验证失败将被记录在验证日志中，该日志将被写入 makepkg 命令行的指定输出位置。这是在其中创建完成的游戏包的同一输出位置。如果在 makepkg 上设置了 /validationlanguage 参数，则输出的本地化版本（以及英语输出）也在同一位置。当前其他受支持的验证语言为 ja-jp。

通过运行 makepkg validate 命令行，可在创建游戏包之前运行提交验证器测试的子集。我们建议运行该命令行以在创建包之前找出问题。

提交验证器识别的问题

提交验证器识别的问题类型将随着时间的推移而发展和演变，以实现从提交到认证再到市场的平滑过渡。有关提交验证器所检出问题的当前列表，请参阅提交验证器质量检查。

了解结果日志

makepkg 过程完成后，游戏 XVC 将显示在“输出”文件夹中。验证日志位于相同的文件夹中。可以通过 "Validator_[title and package identifier].xml." 形式的名称来识别它，应检查此日志是否有任何故障或警告。除了之前部分中已显示的失败和警告外，任何 <failure> 标签都指定了一个条件，该条件将导致你的提交在内容摄取、掌控和认证阶段中被拒绝。虽然没有什么可以阻止您提交这样一个包，但是这样做会浪费您的时间和精力。最好纠正所有检测到的问题，直到日志中不再包含 <failure> 标签。

你可能还会在日志中看到 <warning> 标签。这些通常指示可能需要设置例外情形的问题。如果你对所标识的任何警告有疑问，请与你的开发者客户经理 (DAM) 联系。即使你为你的游戏授权了例外情形，<warning> 标签仍将显示在日志文件中。有关日志消息的完整列表，请参阅提交验证程序消息。

<validatorrun> 部分位于日志结尾处，如下所示。此部分包含一个 <result> 标签，该标签指示提交验证器测试的整体失败或成功。任何部分中的任何失败都将导致整体失败。

<validatorrun>
  <starttime>Sep 23 2019 16:43:41</starttime>
  <endtime>Sep 23 2019 16:43:41</endtime>
  <result>Fail</result>
</validatorrun>

用于测试的提交验证器的版本号位于日志文件的顶部。下面的示例显示了日志文件中的此版本编号。

<XboxOneSubmissionValidator>
  <engineversion>10.0.18362.7198</engineversion>

当 Microsoft 收到提交信息后，将使用最新版本的提交验证器测试提交信息。我们强烈建议你在准备提交你的游戏时定期更新正在使用的提交验证器版本。有关详细信息，请参阅以下部分。

更新提交验证器

提交验证器是作为一个单独的 SubmissionValidator.dll 实现的，该文件可在 Microsoft 游戏开发工具包 (GDK) 的\Bin目录中找到。提交验证器的更新并不总是与 Microsoft 游戏开发工具包 (GDK) 的发布周期相对应。始终可以从“Xbox 开发人员下载->GDK->提交验证程序”下载当前版本的提交验证器。下载压缩 (.zip) 文件，打开它，然后将更新的 SubmissionValidator.dll 放入 Microsoft 游戏开发工具包 (GDK) 的 \Bin 目录中并覆盖以前版本的提交验证器。认证工具页还包含当前发布的版本号和日期。在压缩文件中，有一个包含当前版本的发布说明的文本文件，其中包括与本主题中描述不同的、提交验证器所执行的检查的已知问题和更改信息。

将应用程序、游戏或 Content Package（内容包）提交到 Microsoft 后，将使用当前版本的提交验证器检查该提交。在提交应用程序、游戏或 Content Package（内容包）之前，我们建议你确保在生成提交包的开发电脑上装有最新版本的提交验证器。

提交验证程序发行说明

有关每个版本的提交验证程序的更改的详细信息，请参阅 Xbox 开发人员论坛上的提交验证程序更新源。

本部分内容

提交验证器质量检查
描述由提交验证器执行的质量检查。

提交验证程序消息描述了提交验证程序输出的消息（警告、错误、建议）。

另请参阅

生成包 (makepkg.exe)

游戏打包、内容更新和流式安装测试

Xbox 要求 (XR) (Xbox 开发人员下载->合作伙伴、发布和发布管理信息->XGD 合作伙伴文档)

通过