打包命令

pack 命令用于将布局打包为触摸适配捆绑包 (takx)。

此捆绑包可通过 服务 命令进行本地测试,或由 Microsoft 帐户代表通过 Xbox 游戏流式处理提交给用户。

下表显示了pack命令可使用的不同选项。

选项 说明
--layout-path <layout-path> 要包含在捆绑包中的根布局目录的路径。 此参数是必需的。
--out
--output-path <output-path>
指定打包的触摸适配捆绑包的输出文件。 通常为 .takx 文件。 此参数是必需的。
--asset-path <asset-path> 想包含在捆绑包中的资产根目录的路径。 如果捆绑包中没有资产,则不需要此参数。
--context file <context-file> 想包含在捆绑包中的上下文文件的路径。 如果捆绑包中没有上下文,则不需要此参数。
--default-layout <default-layout> 默认布局的名称。 该名称应与布局路径中一个文件的名称相匹配。
--version <version> 触摸适配捆绑的内容版本,如 1.0.0.0。 针对游戏提交给 Microsoft 的每个触控适配捆绑包的版本号必须比之前提交的任何触控适配捆绑包都大。 takx-version 命令可用于检查现有捆绑包的版本。 可以通过调用 XGameStreamingGetTouchBundleVersion 获取流式传输游戏时使用的触控适配捆绑包的版本号
--version-name <version-name> 触摸适配捆绑的内容版本名称,如 “DLC 1”。 与版本号不同,版本名称是可选的,其格式没有要求。 takx-version 命令可用于检查现有捆绑包的版本。 可以通过调用 XGameStreamingGetTouchBundleVersion 获取流式传输游戏时使用的触控适配捆绑包的版本名称
--no-asset-optimization 确保不优化高效存储和通信的资产。 如果已设置,则不修改资产。
--no-verify 确保产生的触摸适配捆绑是有效的,并且未经验证。
--language <language> 想包含在生产的捆绑包中语言的IETF语言标签。 如果多次指定该参数,则包括所有提供的语言。 如果未指定参数,则所有在源目录中找到的布局和资产都会包含在捆绑包中。

示例

使用以下代码示例将布局打包到触摸适应捆绑包中。


将布局路径中的所有布局打包到 1.0.0.0 版本的单个触摸适配捆绑包中

C:\>tak pack --layout-path C:\tmp\layouts --out C:\tmp\MyGameLayouts.takx --version 1.0.0.0
Building touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'
Verifying touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'.
Verification complete. 0 error(s) and 0 warning(s) found.

将布局路径中的所有布局打包到单个触摸适配捆绑包中。 将布局 introLayout 设置为在游戏发出特定布局请求之前将提供给用户的布局

C:\>tak pack --layout-path C:\tmp\layouts --out C:\tmp\MyGameLayouts.takx --default-layout introLayout
Building touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'
Verifying touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'.
Verification complete. 0 error(s) and 0 warning(s) found.

仅将布局路径中的 en-us 布局打包到单个触摸适配捆绑包中,而无需任何资产优化

C:\>tak pack --layout-path C:\tmp\layouts --out C:\tmp\MyGameLayouts.takx --language en-us --no-asset-optimization
Building touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'
Verifying touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'.
Verification complete. 0 error(s) and 0 warning(s) found.

仅将布局路径中的 en-us 和 es-us 布局打包到单个触摸适配捆绑包中。

C:\>tak pack --layout-path C:\tmp\layouts --out C:\tmp\MyGameLayouts.takx --language en-us --language es-us
Building touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'
Verifying touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'.
Verification complete. 0 error(s) and 0 warning(s) found.

另请参阅

触控适配套件命令行工具 (tak.exe)