- Submission Validator の使用
- Submission Validator が識別する問題
- 結果ログの理解
- Submission Validator の更新
- Submission Validator のリリース ノート
Submission Validator の使用
Submission Validator は開発者が単独で使用するツールではありません。むしろ、makepkg pack コマンドが使用されたときにアプリをチェックするために自動的に呼び出されます。構文とコマンドラインの使用については、makepkg のリファレンス ページを参照してください。 Submission Validator は、タイトル パッケージが作成された後に実行されます。検証の失敗は検証ログに記録され、makepkg のコマンドラインで指定された出力場所に書き込まれます。これは、完成したタイトル パッケージが作成される同じ出力場所です。makepkg で/validationlanguage パラメーターが設定されている場合、同じ場所に (英語の出力に加えて) ローカライズされたバージョンの出力も利用できます。現在サポートされている追加の検証言語は ja-jp です。
Submission Validator のテストのサブセットは、makepkg validate コマンドラインを実行することで、タイトル パッケージ作成前に実行できます。パッケージ作成前に問題を検出するために、これを実行することを推奨します。
Submission Validator が識別する問題
Submission Validator が識別する問題の種類は、提出、認定、市場までの道のりを円滑にするという目標に向けて、時間とともに増加し、進化します。Submission Validator が検出する問題の最新リストについては、Submission Validator の品質チェック を参照してください。結果ログの理解
makepkg プロセスが完了すると、タイトル XVC が出力フォルダーに表示されます。検証ログは同じフォルダー内にあります。「Validator_[title and package identifier].xml」 の形式の名前で識別できます。このログで失敗や警告を確認する必要があります。以前のセクションで既に示された失敗や警告に加えて、任意の <failure> タグは、コンテンツ取り込み、マスタリング、および認定フェーズの一環として提出が拒否される原因となる状態を示します。そのようなパッケージの提出は妨げられませんが、それを行うと時間と労力の無駄となります。ログに <failure> タグが含まれなくなるまで、識別された問題を修正するほうがはるかによいでしょう。
ログには <warning> タグも表示されることがあります。これらは通常、例外が必要になる可能性のある問題を示します。識別された警告について質問がある場合は、開発者アカウント マネージャー (DAM) にお問い合わせください。タイトルに対する例外が認められた場合でも、ログ ファイルには <warning> タグが表示されます。ログ メッセージの完全なリストについては、Submission Validator メッセージ を参照してください。
<validatorrun> セクションはログの最後にあります。以下に示します。このセクションには、Submission Validator テストの全体的な Fail または Success を示す <result> タグが含まれます。いずれかのセクションでの失敗は、全体的な失敗をもたらします。
Submission Validator の更新
Submission Validator は、Microsoft Game Development Kit (GDK) の\Bin ディレクトリにある個別の SubmissionValidator.dll として実装されています。Submission Validator への更新は、常に Microsoft Game Development Kit (GDK) のリリース サイクルと一致するわけではありません。Submission Validator の最新版は、developer.microsoft.com/games/resources -> downloads からいつでもダウンロードできます。圧縮 (.zip) ファイルをダウンロードして展開し、以前のバージョンの Submission Validator を上書きして、更新された SubmissionValidator.dll を Microsoft Game Development Kit (GDK) の \Bin ディレクトリに配置します。Certification Tools ページには、現在のリリース バージョン番号と日付も含まれています。圧縮ファイル内には、現在のバージョンのリリース ノートを含むテキスト ファイルがあり、既知の問題やこの記事の説明と異なる Submission Validator が実行するチェックへの変更に関する情報が含まれています。
2025 年 10 月 GDK 以降、makepkg は /updatesubval オプションをサポートしており、これは SubmissionValidator.dll の新しいバージョンをチェックします。更新が利用可能な場合、このオプションは DLL をダウンロードして、makepkg.exe を含むディレクトリ (既定では GDK の \Bin ディレクトリ) にインストールします。/validationpath が指定されている場合、DLL は代わりにそのディレクトリにインストールされます。更新に失敗した場合は、パッケージング、または検証は、現在インストールされているバージョンの SubmissionValidator.dll を使用して続行されます。
2026 年 10 月 GDK 以降、パッケージを作成、検証、またはアップロードせずに SubmissionValidator.dll を更新するには、スタンドアロンの makepkg updatesubval コマンドを使用します。/updatesubval オプションとは異なり、スタンドアロン コマンドは更新に失敗するとゼロ以外の終了コードを返します。
アプリ、タイトル、またはコンテンツ パッケージが Microsoft に提出されると、その提出をチェックするために現在のバージョンの Submission Validator が使用されます。アプリ、タイトル、またはコンテンツ パッケージを提出する前に、提出パッケージがビルドされる開発 PC に現在のバージョンの Submission Validator があることを確認することを推奨します。