> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Submission Validator (SubmissionValidator.dll)

> Submission Validator (SubmissionValidator.dll)

Submission Validator は、タイトルまたはアプリ パッケージに対して一連の基本的な品質チェックを実行する Microsoft Game Development Kit (GDK) のコンポーネントです。Submission Validator は、Microsoft のコンテンツ取り込みおよび認定プロセス中にタイトルの失敗の原因となる一般的な問題に対処するため、開発者にフィードバックを提供します。タイトル パッケージが提出されると、最新バージョンの Submission Validator を使用して、タイトルの拒否につながる可能性のある障害を検出します。Submission Validator の総合的な目標は、これらのチェックを自動化し、プロセスのできるだけ早い段階に押し進めて、パートナーが認定のためにタイトル パッケージを提出する前に、問題を自己診断して修正できるようにすることです。

* [Submission Validator の使用](#using-submission-validator)
* [Submission Validator が識別する問題](#problems-identified-by-submission-validator)
* [結果ログの理解](#understanding-the-results-log)
* [Submission Validator の更新](#updating-submission-validator)
* [Submission Validator のリリース ノート](#submission-validator-release-notes)

## Submission Validator の使用

Submission Validator は開発者が単独で使用するツールではありません。むしろ、[makepkg pack](/build/core-features/common/packaging/deployment/makepkg) コマンドが使用されたときにアプリをチェックするために自動的に呼び出されます。構文とコマンドラインの使用については、[makepkg](/build/core-features/common/packaging/deployment/makepkg) のリファレンス ページを参照してください。

Submission Validator は、タイトル パッケージが作成された後に実行されます。検証の失敗は検証ログに記録され、[makepkg](/build/core-features/common/packaging/deployment/makepkg) のコマンドラインで指定された出力場所に書き込まれます。これは、完成したタイトル パッケージが作成される同じ出力場所です。[makepkg](/build/core-features/common/packaging/deployment/makepkg) で `/validationlanguage` パラメーターが設定されている場合、同じ場所に (英語の出力に加えて) ローカライズされたバージョンの出力も利用できます。現在サポートされている追加の検証言語は ja-jp です。

Submission Validator のテストのサブセットは、[makepkg validate](/build/core-features/common/packaging/deployment/makepkg) コマンドラインを実行することで、タイトル パッケージ作成前に実行できます。パッケージ作成前に問題を検出するために、これを実行することを推奨します。

## Submission Validator が識別する問題

Submission Validator が識別する問題の種類は、提出、認定、市場までの道のりを円滑にするという目標に向けて、時間とともに増加し、進化します。Submission Validator が検出する問題の最新リストについては、[Submission Validator の品質チェック](/build/core-features/common/packaging/subval/submissionvalidator-tests) を参照してください。

## 結果ログの理解

`makepkg` プロセスが完了すると、タイトル XVC が出力フォルダーに表示されます。検証ログは同じフォルダー内にあります。*「Validator\_\[title and package identifier].xml」* の形式の名前で識別できます。このログで失敗や警告を確認する必要があります。以前のセクションで既に示された失敗や警告に加えて、任意の `<failure>` タグは、コンテンツ取り込み、マスタリング、および認定フェーズの一環として提出が拒否される原因となる状態を示します。そのようなパッケージの提出は妨げられませんが、それを行うと時間と労力の無駄となります。ログに `<failure>` タグが含まれなくなるまで、識別された問題を修正するほうがはるかによいでしょう。

ログには `<warning>` タグも表示されることがあります。これらは通常、例外が必要になる可能性のある問題を示します。識別された警告について質問がある場合は、開発者アカウント マネージャー (DAM) にお問い合わせください。タイトルに対する例外が認められた場合でも、ログ ファイルには `<warning>` タグが表示されます。ログ メッセージの完全なリストについては、[Submission Validator メッセージ](/build/core-features/common/packaging/subval/submissionvalidator-messages) を参照してください。

`<validatorrun>` セクションはログの最後にあります。以下に示します。このセクションには、Submission Validator テストの全体的な Fail または Success を示す `<result>` タグが含まれます。いずれかのセクションでの失敗は、全体的な失敗をもたらします。

```xml theme={null}
<validatorrun>
  <starttime>Sep 23 2019 16:43:41</starttime>
  <endtime>Sep 23 2019 16:43:41</endtime>
  <result>Fail</result>
</validatorrun>  
```

テストに使用されている Submission Validator のバージョン番号は、ログ ファイルの最上部にあります。次の例は、ログ ファイル内のこのバージョン番号を示しています。

```xml theme={null}
<XboxOneSubmissionValidator>
  <engineversion>10.0.18362.7198</engineversion>  
```

提出物が Microsoft に到着すると、最新バージョンの Submission Validator を使用してテストされます。タイトルの提出準備を進めるにあたり、使用している Submission Validator のバージョンを定期的に更新することを強く推奨します。詳細については、次のセクションを参照してください。

## 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](https://aka.ms/currentsubvalzip) からいつでもダウンロードできます。圧縮 (.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`](/build/core-features/common/packaging/deployment/makepkg#updatesubval) コマンドを使用します。`/updatesubval` オプションとは異なり、スタンドアロン コマンドは更新に失敗するとゼロ以外の終了コードを返します。

アプリ、タイトル、またはコンテンツ パッケージが Microsoft に提出されると、その提出をチェックするために現在のバージョンの Submission Validator が使用されます。アプリ、タイトル、またはコンテンツ パッケージを提出する前に、提出パッケージがビルドされる開発 PC に現在のバージョンの Submission Validator があることを確認することを推奨します。

## Submission Validator のリリース ノート

Submission Validator の各リリースでの変更内容の詳細については、XBOX Developer Forums の [Submission Validator の更新](https://aka.ms/subvalupdates) フィードを参照してください。

## Submission Validator のトピック

[Submission Validator の品質チェック](/build/core-features/common/packaging/subval/submissionvalidator-tests)

Submission Validator によって実行される品質チェックについて説明します。

[Submission Validator メッセージ](/build/core-features/common/packaging/subval/submissionvalidator-messages)

Submission Validator によって生成されるメッセージ (警告、エラー、および通知) について説明します。

## 関連トピック

[Make package (makepkg.exe)](/build/core-features/common/packaging/deployment/makepkg)

[タイトル パッケージング、コンテンツ更新、およびストリーミング インストールのテスト](/build/core-features/common/packaging/title-packaging-streaming-install-testing)

XBOX 要件 (XRs) [(XBOX Developer Downloads->Partner, Publishing, and Release Management Information->XGD Partner Documentation)](https://aka.ms/xgddl)
