使用 verify
命令通过如下表所示的选项验证触控适配工具包的内容是否有效。
选项 | 说明 |
---|---|
--takx --takx-file <takx-file> |
要验证的触摸适配包的路径。 此参数是必需的。 |
--log --log-file --out <log-file> |
要将验证结果写入的文件的路径。 此参数是必需的。 |
--default-layout <default-layout> |
设置预期默认布局的名称。 如果提供此参数,则如果默认布局与提供的布局名称不一样,即会出现验证错误。 |
--layout-version <layout-version> |
指定触控适配捆绑包中的每个布局都必须与之兼容的语义版本。 如果未指定此参数,则所有布局都需要进行的唯一验证是拥有有效的架构版本。 |
--manifest-version <manifest-version> |
指定语义版本,清单架构版本必须与之兼容。 如果未指定此参数,则唯一需要的验证是清单有一个有效的架构版本。 |
捆绑包验证级别
验证命令(以及 pack
和 serve
命令的验证阶段)会通知调用方触摸适配捆绑包的任何问题。 此验证过程采用以下问题分类来帮助指导开发人员实现完全正常运行的捆绑包。
错误
验证中的错误意味着捆绑包出现问题。 加载捆绑包极有可能失败。 例子包括错误或无法分析的 JSON、缺少资产或缺少 neutral
语言等。 任何错误都将阻止 pack
和 serve
命令,除非使用了 --no-verify
选项。
警告
验证警告是指示捆绑包可能存在问题的项,但它不会阻止 pack
或 serve
命令。 例如,处于捆绑包中但未被任何布局引用的资产将生成警告,因为这可能表示开发人员无意中包括了未发布的资产,但也可能表明开发人员正在测试新资产,并且尚未生成所有布局,或者需要更新 allowedStateValues
块。
注意
警告将阻止 Microsoft 客户代表提交捆绑包的能力。
示例
使用以下代码示例验证触控适配捆绑包的有效性。
验证触控适配捆绑包且无错误
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.