次の方法で共有

サブミッション バリデーター (SubmissionValidator.dll)

  • [アーティクル]

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

サブミッション バリデーターの使用方法

サブミッション バリデーターは、開発者が使用するスタンドアロン ツールではありません。 むしろ、makepkg pack コマンドを使用するたびに、自動的に呼び出されてアプリをチェックします。 構文およびコマンド ラインの使用方法の詳細については、makepkg のリファレンス ページを参照してください。

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

makepkg validate コマンド ラインを実行し、タイトル パッケージ作成の前にサブミッション バリデーター テストのサブセットを実行できます。 パッケージを作成する前にそれを実行して問題を検出することをお勧めします。

サブミッション バリデーターで識別される問題

提出から認証を経てマーケット リリースに至るまでの過程をスムーズにするという目標に向けて取り組むために、サブミッション バリデーターが識別する問題の種類は徐々に成長し、進化しています。 サブミッション バリデーターが検出する問題の最新のリストについては、「サブミッション バリデーターによる品質チェック」をご覧ください。

結果ログについて

makepkg プロセスが完了すると、タイトル XVC が出力フォルダー内に出現します。 検証ログは、この同じフォルダーにあります。 " Validator_[タイトルとパッケージ識別子].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 で受理されると、最新バージョンのサブミッション バリデーターを使用してテストされます。 タイトルの提出準備をする時に使用するサブミッション バリデーターのバージョンを、定期的に更新することを強くお勧めします。 詳しくは、次のセクションをご覧ください。

サブミッション バリデーターの更新

サブミッション バリデーターは、Microsoft Game Development Kit (GDK) の \Bin ディレクトリにある独立した SubmissionValidator.dll として実装されています。 サブミッション バリデーターの更新は、必ずしも Microsoft Game Development Kit (GDK) のリリース サイクルに対応するとは限りません。 現在のバージョンのサブミッション バリデーターは、常に Xbox Developer Downloads-GDK-Submission>> Validator からダウンロードできます。 圧縮 (.zip) ファイルをダウンロードして開き、更新された SubmissionValidator.dll を Microsoft Game Development Kit (GDK) の \Bin ディレクトリに配置し、以前のバージョンのサブミッション バリデーターを上書きします。 [認定ツール] のページには、現在のリリースのバージョン番号と日付も含まれます。 圧縮ファイル内には、最新バージョンのリリース ノートを含むテキスト ファイルがあり、既知の問題や、本トピックの説明とは異なるサブミッション バリデーターによって実行されるチェックの変更に関する情報が含まれています。

アプリ、タイトル、またはコンテンツ パッケージを Microsoft に提出すると、サブミッション バリデーターの最新バージョンを使用してその提出物がチェックされます。 アプリ、タイトル、またはコンテンツ パッケージを提出する前に、サブミッション バリデーターの最新バージョンが、サブミッション パッケージのビルドに使用する開発用 PC にインストールされていることを確認することをお勧めします。

サブミッション バリデーター リリース ノート

サブミッション バリデーターの各リリースでの変更点の詳細については、Xbox デベロッパー フォーラムの サブミッション バリデーターの更新フィード を参照してください。

このセクションの内容

サブミッション バリデーターによる品質チェック
サブミッション バリデーターによって実行される品質チェックについて説明します。

サブミッション バリデーター メッセージサブミッション バリデーターによって出力されるメッセージ (警告、エラー、およびアドバイザリ) について説明します。

関連項目

パッケージの作成 (makepkg.exe)

タイトルのパッケージ化、コンテンツ アップデート (CU)、ストリーミングインストールのテスト

Xbox の要件 (XRs) ([Xbox 開発者ダウンロード]>[パートナー]、[公開]、[リリース管理情報]>[XGD パートナー ドキュメント] の順に移動)