Verify コマンド
verify コマンドと次の表に示すオプションを使用して、タッチ アダプテーション バンドルのコンテンツが有効であることを確認します。
| オプション | 説明 |
|---|---|
--takx--takx-file <takx-file> |
確認するタッチ アダプテーション バンドルのパス。 このパラメーターは必須です。 |
--log--log-file--out <log-file> |
検証結果を書き込むファイルのパス。 このパラメーターは必須です。 |
--default-layout <default-layout> |
予想される既定のレイアウトの名前を設定します。 このパラメーターが提供されている場合、既定のレイアウトが提供されているレイアウト名と異なる場合は、確認エラーが発生します。 |
--layout-version <layout-version> |
タッチ アダプテーション バンドルのすべてのレイアウトが準拠しなければならないセマンティック バージョンを指定します。 このパラメーターが指定されていない場合、すべてのレイアウトに有効なスキーマ バージョンが含まれていることだけが確認されます。 |
--manifest-version <manifest-version> |
マニフェスト スキーマ バージョンが対応している必要があるセマンティック バージョンを指定します。 このパラメーターが指定されていない場合、マニフェストに有効なスキーマ バージョンが含まれていることだけが確認されます。 |
バンドル検証レベル
verify コマンド (および pack と serve コマンドの検証段階) は、タッチ アダプテーション バンドルに問題がある場合は呼び出し側に通知します。 この検証プロセスでは、開発者が完全に機能するバンドルになるように導くために、以下のような問題の分類を導入しています。
エラー
検証におけるエラーは、バンドルに何らかの問題が発生したことを意味します。 バンドルの読み込みに失敗する可能性が極めて高くなります。 たとえば、不正確な JSON や解析不能な JSON、アセットがない、neutral 言語がないなどの項目が挙げられます。
--no-verify オプションを使用しない限り、いかなるエラーも pack および serve コマンドをブロックします。
Warning
検証の警告は、バンドルに問題がある可能性を示す項目ですが、pack および serve コマンドをブロックするものではありません。 たとえば、バンドルに含まれているものの、どのレイアウトからも参照されていないアセットがある場合は、開発者がリリースされていないアセットを含んだことを示す警告が表示されますが、開発者が新しいアセットを試行している途中で、まだすべてのレイアウトを構築していない、あるいは allowedStateValues ブロックを更新する必要があることを示す場合もあります。
注意
警告は、マイクロソフト アカウント担当者がバンドルを送信する機能をブロックします。
例
次のコード例を使用して、タッチ アダプテーション バンドルの有効性を確認します。
タッチ アダプテーション バンドルを検証し、エラーがないことを確認する
C:\>tak verify --takx-file C:\tmp\MyGameLayouts.takx
Verifying touch adaptation bundle 'C:\tmp\MyGameLayout.takx'.
Verification complete. 0 error(s) and 0 warning(s) found.
タッチ アダプテーション バンドルを検証し、予想される既定のレイアウトを指定すると、既定のレイアウトが存在しない場合にエラーが発生する
C:\>tak verify --takx-file C:\tmp\MyGameLayouts.takx --default-layout initialLayout
Verifying touch adaptation bundle 'C:\tmp\MyGameLayout.takx'.
ERROR: takxmanifest.json(1): error : Actual default layout 'menu_ui' isn't the expected default layout 'initialLayout'.
Verification complete. 1 error(s) and 0 warning(s) found.