> ## 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.

# Pack 命令

> Pack 命令

`pack` 命令用于将布局打包到触控适配包 (takx) 中。

此适配包可通过 [serve](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command) 命令用于本地测试，或者由您的 Microsoft 客户代表通过 XBOX 游戏串流为用户提交。

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

| 选项                                         | 说明                                                                                                                                                                                                                                                                                                                                                                                   |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `--layout-path <layout-path>`              | 您要包含在适配包中的根布局目录的路径。此参数为必需。                                                                                                                                                                                                                                                                                                                                                           |
| `--out`<br />`--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](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-takx-version-command) 命令检查现有适配包的版本。游戏在串流时使用的触控适配包的版本号可通过调用 [XGameStreamingGetTouchBundleVersion](/reference/system/xgamestreaming/functions/xgamestreaminggettouchbundleversion) 获得。 |
| `--version-name <version-name>`            | 触控适配包内容版本的名称，例如 "DLC 1"。与版本号不同，版本名称是可选的，且对其格式没有要求。可以使用 [takx-version](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-takx-version-command) 命令检查现有适配包的版本。游戏在串流时使用的触控适配包的版本名称可通过调用 [XGameStreamingGetTouchBundleVersion](/reference/system/xgamestreaming/functions/xgamestreaminggettouchbundleversion) 获得。                         |
| `--no-asset-optimization`                  | 确保用于高效存储和通信的资源不被优化。如果设置，资源将不被修改。                                                                                                                                                                                                                                                                                                                                                     |
| `--no-verify`                              | 确保生成的触控适配包有效并且不被验证。                                                                                                                                                                                                                                                                                                                                                                  |
| `--language <language>`                    | 您要包含在所生成的适配包中的语言的 IETF 语言标签。如果多次指定此参数，则会包含所有提供的语言。如果未指定该参数，则源目录中找到的所有布局和资源都会包含在适配包中。                                                                                                                                                                                                                                                                                                 |

### 示例

使用以下代码示例将布局打包到触控适配包中。

***

将 layout-path 中的所有布局打包为一个版本为 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.
```

***

将 layout-path 中的所有布局打包为一个单个触控适配包。将布局 `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.
```

***

仅将 layout-path 中的 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.
```

***

仅将 layout-path 中的 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.
```

***

## 另请参阅

[Touch Adaptation Kit 命令行工具 (tak.exe)](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line)


## Related topics

- [Touch Adaptation Kit (TAK) 命令行工具参考](/zh-CN/build/core-features/common/game-streaming/tak-command-line-tool/index.md)
- [游戏打包、更新与流式安装测试](/zh-CN/build/core-features/common/packaging/title-packaging-streaming-install-testing.md)
- [Submission Validator (SubmissionValidator.dll)](/zh-CN/build/core-features/common/packaging/subval/submissionvalidator.md)
- [包（经典体验）](/zh-CN/publishing/game-publishing/concepts/packages-overview.md)
- [发布触控布局](/zh-CN/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-publishing-layouts.md)
