在 TAK 编辑器中创建捆绑包和布局

本文介绍如何开始使用 TAK 编辑器创建新的触控适配捆绑包 (TAB) 和布局。 假定已安装并设置了扩展。 可以在前面的文章中找到安装和设置说明。

创建新捆绑包

  1. 启动命令面板 (Ctrl+Shift+PCmd+Shift+P)。

  2. 搜索“创建”并选择“触摸适配套件:创建新捆绑包”

    命令面板的屏幕截图,其中选择了“创建新捆绑包”命令

  3. 将出现一系列提示,要求提供将定义捆绑包的参数。 输入请求的信息,并在每个提示后按 Enter。 下表汇总了提示。

    Prompt 说明
    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。 上下文文件的名称。 此文件位于捆绑包的根目录中。 详细了解上下文文件
    Languages 默认值:无。 以逗号分隔的 IETF Langauge 标记列表 (例如捆绑 en-US, ja-JP, fr-CA 包将支持) 。 添加对多种语言的支持时,将在布局和资产目录中创建一个专用于每种语言的子目录。 详细了解触控适配捆绑包本地化。 请注意,无论此处提供的语言标记如何,都会在布局目录下创建目录 neutral
    Templates 默认:blank。 选择任意数量的模板作为新捆绑包的起点。 此处提供捆绑包呈现方式的预览。 请注意,对于所选的每个模板,将在布局目录下 的每个 语言子目录中创建一个布局。

注意

除了 WorkspaceName 提示之外,所有其他提示都具有默认值,可以通过按 Enter 而不输入任何文本来接受这些默认值。

创建新布局

与创建捆绑包类似,创建新布局的过程是通过命令面板完成的。

重要

在 VS Code 中打开的工作区文件夹 () 中必须至少存在一个捆绑包才能创建捆绑包。

步骤如下:

  1. 启动命令面板 (Ctrl+Shift+PCmd+Shift+P)。

  2. 搜索“创建”并选择“触摸适配套件:为现有捆绑包创建新布局”

    命令面板的屏幕截图,其中选择了“创建新布局”命令

  3. 将出现一系列提示,要求提供将定义布局的参数。 输入请求的信息,并在每个提示后按 Enter。 下表汇总了提示。

    Prompt 说明
    Bundle 这将显示为在打开的工作区文件夹中找到的所有捆绑包的下拉列表, () 。 选择应在其中创建布局的捆绑包。 仅当工作区中有多个捆绑包时,才会显示此情况。 如果只有一个捆绑包,将自动选择它并跳过提示。
    Template 默认:blank。 选择要用作新布局起点的模板。 此处提供捆绑包呈现方式的预览。
    Name 默认值:模板名称。 新布局的名称。 这只能是一个简单名称 (例如 main-menu ,) ,不能是嵌套相对路径。 这必须是唯一的,以便捆绑包中没有同名的其他布局。
    All Languages 默认:No。 如果选择 Yes 了 ,则会在所选捆绑包的布局目录下 的每个 语言子目录中创建一个布局。 如果选择 No 了 ,则只会在 neutral 目录中创建布局。 如果选择 Yes 了 ,则 Languages 跳过 参数。
    Languages 默认值:无。 IETF 语言标记的逗号分隔列表 (例如, en-US, ja-JP, fr-CA 应为其创建布局) 。 如果 All Languages 设置为 Yes,则跳过此提示。 如果提供了语言标记,而所选捆绑包的布局目录中不存在子目录,则会创建该标记。
    Make Layout Default 默认:No。 如果选择 Yes ,则布局将设置为捆绑包的默认布局。 这发生在捆绑包文件中的更改时 takxconfig.json

下一步