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

# 在 TAK 编辑器中创建适配包和布局

> 在 TAK 编辑器中创建适配包和布局

本文是关于如何使用 TAK 编辑器开始创建新的触控适配包 (TAB) 和布局的指南。假定已经安装并设置了扩展。您可以在之前的文章中找到[安装](/build/core-features/common/game-streaming/tak-editor/game-streaming-tak-editor)和[设置](/build/core-features/common/game-streaming/tak-editor/game-streaming-tak-editor-setup)说明。

## 创建新的适配包

1. 启动命令面板（`Ctrl+Shift+P` 或 `Cmd+Shift+P`）。
2. 搜索 "create" 并选择 "Touch Adaptation Kit: Create new Bundle"

   <img src="https://mintcdn.com/microsoft-4404708b/CwRBzaXvHw9zaPoe/images/gdk/features/common/tak-editor-create-bundle-command.png?fit=max&auto=format&n=CwRBzaXvHw9zaPoe&q=85&s=affe1d24385c9d3c55fb9718143a0eae" alt="选择了 create new bundle 命令的命令面板屏幕截图" width="604" height="94" data-path="images/gdk/features/common/tak-editor-create-bundle-command.png" />
3. 会出现一系列提示，询问定义适配包的参数。输入所请求的信息，并在每个提示后按 `Enter`。下表总结了这些提示。

   | 提示                       | 说明                                                                                                                                                                                                                                                           |
   | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
   | `Workspace`              | 仅当 VS Code 中打开了多个工作区文件夹时才会出现。如果只有一个根工作区文件夹，将自动选择它并跳过提示。如果有多个工作区文件夹，则必须选择用于放置适配包的文件夹。                                                                                                                                                                         |
   | `Name`                   | 新适配包的名称。这可以是简单名称（例如 `test-game-1`）或嵌套相对路径。例如，如果所选的根工作区文件夹名为 `bundles`，并提供了相对路径 `role-playing-games/test-game-1`，则创建的适配包将放置在 `path/to/bundles/role-playing-games/test-game-1`。                                                                                |
   | `Layouts Directory Name` | 默认：`layouts`。适配包中存储布局的目录名称。                                                                                                                                                                                                                                  |
   | `Assets Directory Name`  | 默认：`assets`。适配包中存储资源的目录名称。                                                                                                                                                                                                                                   |
   | `Context File Name`      | 默认 `context`。上下文文件的名称。此文件放置在适配包的根目录中。[阅读有关上下文文件的更多信息](/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-bundle#context-and-state)。                                                                                            |
   | `Languages`              | 默认：无。适配包将支持的以逗号分隔的 IETF 语言标签列表（例如 `en-US, ja-JP, fr-CA`）。添加对多种语言的支持时，将在 layouts 和 assets 目录中为每种语言创建专用的子目录。[了解有关触控适配包本地化的更多信息](/build/core-features/common/game-streaming/game-streaming-tak-localization)。请注意，无论此处提供的语言标签如何，layouts 目录下始终会创建一个 `neutral` 目录。 |
   | `Templates`              | 默认：`blank`。选择任意数量的模板作为新适配包的起点。[此处](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-templates)提供了适配包渲染方式的预览。请注意，对于所选的每个模板，都将在 layouts 目录下的*每个*语言子目录中创建一个布局。                                                  |

<Note>除了 `Workspace` 和 `Name` 提示之外，所有其他提示都有可通过不输入任何文本按 `Enter` 接受的默认值。</Note>

## 创建新布局

与创建适配包类似，创建新布局的过程通过命令面板完成。

<Info>创建布局时，在 VS Code 中打开的工作区文件夹中必须至少存在一个适配包。</Info>

步骤如下：

1. 启动命令面板（`Ctrl+Shift+P` 或 `Cmd+Shift+P`）。
2. 搜索 "create" 并选择 "Touch Adaptation Kit: Create new layout for existing bundle"

   <img src="https://mintcdn.com/microsoft-4404708b/CwRBzaXvHw9zaPoe/images/gdk/features/common/tak-editor-create-layout-command.png?fit=max&auto=format&n=CwRBzaXvHw9zaPoe&q=85&s=f0a25cbb973c310fe2f634cd1523dc1f" alt="选择了 create new layout 命令的命令面板屏幕截图" width="607" height="98" data-path="images/gdk/features/common/tak-editor-create-layout-command.png" />
3. 会出现一系列提示，询问定义布局的参数。输入所请求的信息，并在每个提示后按 `Enter`。下表总结了这些提示。

   | 提示                    | 说明                                                                                                                                                      |
   | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | `Bundle`              | 这显示为在打开的工作区文件夹中找到的所有适配包的下拉列表。选择创建布局的适配包。仅当工作区中有多个适配包时才会出现。如果只有一个适配包，它将被自动选择并跳过提示。                                                                       |
   | `Template`            | 默认：`blank`。选择要用作新布局起点的模板。[此处](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-templates)提供了适配包渲染方式的预览。 |
   | `Name`                | 默认：模板名称。新布局的名称。这只能是简单名称（例如 `main-menu`），不能是嵌套相对路径。此名称必须唯一，以使适配包中没有其他同名布局。                                                                               |
   | `All Languages`       | 默认：`No`。如果选择 `Yes`，将在所选适配包的 layouts 目录下的*每个*语言子目录中创建布局。如果选择 `No`，仅在 `neutral` 目录中创建布局。如果选择 `Yes`，则跳过 `Languages` 参数。                                    |
   | `Languages`           | 默认：无。以逗号分隔的 IETF 语言标签列表（例如 `en-US, ja-JP, fr-CA`），用于要为其创建布局的语言。如果 `All Languages` 设为 `Yes`，则跳过此提示。如果为其提供的语言标签在所选适配包的 layouts 目录下不存在子目录，则将创建它。           |
   | `Make Layout Default` | 默认：`No`。如果选择 `Yes`，则将布局设置为适配包的默认布局。这将作为适配包 `takxconfig.json` 文件中的更改而发生。                                                                                 |

## 下一步

> \[!div class="nextstepaction"]
> [预览布局](/build/core-features/common/game-streaming/tak-editor/game-streaming-tak-editor-preview-layouts)


## Related topics

- [适用于 Visual Studio Code 的 Touch Adaptation Kit (TAK) 编辑器](/zh-CN/build/core-features/common/game-streaming/tak-editor/index.md)
- [使用 TAK 编辑器打包触控适配包](/zh-CN/build/core-features/common/game-streaming/tak-editor/game-streaming-tak-editor-pack-bundles.md)
- [TAK 编辑器设置](/zh-CN/build/core-features/common/game-streaming/tak-editor/game-streaming-tak-editor-setup.md)
- [预览触控适配布局](/zh-CN/build/core-features/common/game-streaming/tak-editor/game-streaming-tak-editor-preview-layouts.md)
- [什么是 Touch Adaptation Kit 编辑器？](/zh-CN/build/core-features/common/game-streaming/tak-editor/game-streaming-tak-editor.md)
