本文提供了设置 TAK 编辑器时必须遵循的步骤。 我们假定你已安装 Visual Studio Code,下载了最新的 TAK CLI,并安装了 TAK 编辑器扩展。 如果尚未执行此操作,请参阅概述页面了解详细信息。
在高级别上,设置过程涉及以下步骤:
- 在扩展中设置 TAK CLI 路径。
- 在 Visual Studio Code 中打开文件夹或工作区
- 这是创建和编辑捆绑包的位置。
注意
此扩展的大部分功能都可以通过在 VS Code 命令面板中执行的命令来进行访问。 命令面板可以通过按 Ctrl+Shift+P
(在 Windows 上)或 Cmd+Shift+P
(在 macOS 上)来访问。 建议熟悉此界面,因为本指南中会经常用到它。
设置 TAK CLI 路径
在计算机上下载 TAK CLI 后,必须在扩展设置中设置其路径。 该扩展将在后台启动 TAK CLI 以执行各种操作,例如创建捆绑包。
这可以通过在 VS Code 中执行命令来完成,也可以通过在 VS Code 用户设置(设置 ID:TAK.editor.commandLineTool.path
)中手动设置路径来完成。
通过命令设置路径:
通过
Ctrl+Shift+P
(在 Windows 上)或Cmd+Shift+P
(在 macOS 上)打开命令面板。搜索“设置 TAK CLI”并选择“触摸适配套件: 设置 TAK 命令行工具(TAK CLI)路径”命令。
此时将打开一个文件选取器。 导航到下载 TAK CLI 的目标位置,选择可执行文件
tak.exe
(在 Windows 上)或tak
(在 macOS 上):
打开文件夹或工作区
必须在 Visual Studio Code 中打开文件夹或工作区才能处理捆绑包。 请将此视为将包含游戏捆绑包的父目录。
若要打开文件夹,请点按窗口左上角的“文件”菜单,然后选择“打开文件夹”。 导航到要在其中创建捆绑包的位置(或包含捆绑包的现有文件夹),然后点按“选择文件夹”。
若要打开工作区,请点按“文件”,然后选择“从文件打开工作区”。 请注意,这需要计算机上存在现有工作区文件(扩展名为 .code-workspace
)。 如果没有工作区文件,可以通过从“文件”菜单中选择“将文件夹添加到工作区...”并添加所需的文件夹来创建一个工作区文件。 然后,可以通过点按“文件”并选择“将工作区另存为...”来保存工作区。
故障排除
状态栏项(带有标签“TAK 编辑器”)将显示在窗口的左下角,以指示扩展的状态。 这使你可以快速确定 TAK CLI 路径设置是否正确,以及扩展是否能够与 CLI 通信。
如果一切设置正确,状态栏项将显示复选标记,并显示工作区中找到的触摸适配捆绑包的数量(如有)。
如果状态栏项显示错误,则可以将鼠标悬停其上以查看有关该错误的更多详细信息。 这通常伴随着一个通知,该通知显示在窗口的右下角,其中包含详细信息。
常见问题包括:
未设置 TAK CLI 路径
如果未在扩展设置中设置 CLI 路径,则会发生这种情况。 事实上,首次安装扩展时,这是默认状态。 若要解决此问题,请按照上一部分中的步骤设置路径。
还可以点按通知中的“设置 TAK CLI”按钮,或点按状态栏项并选择“设置 TAK 命令行工具”选项来设置路径。
TAK CLI 路径不存在
如果提供的路径不存在,则会发生此情况。 如果 CLI 已从最初进行设置的位置移走或删除,或者是在设置中手动键入的并且存在拼写错误,则可能会发生这种情况。 若要解决此问题,请按照上一部分中的步骤重新分配路径。
TAK CLI 不可执行
如果提供的路径不是可执行文件,则会发生这种情况。 如果在文件选取器中选择了错误的文件,或者该文件未标记为可执行文件(例如,在 macOS 上没有执行权限),则可能会发生这种情况。 若要解决此问题,请重新分配路径。
macOS:如果路径设置正确,但 CLI 未标记为可执行文件,则必须对文件分配执行权限。 为了使扩展识别该更改,可能需要重启 VS Code。
TAK CLI 版本未确定
如果扩展无法启动 CLI 并确定其版本(原因可能是 CLI 版本太旧,或者选择了错误的可执行文件作为 CLI),则可能会发生这种情况。 若要解决此问题,请确保下载最新版本的 CLI 并重置路径。
TAK CLI 版本已过时
如果扩展能够启动并验证 CLI 的版本,但版本已过期,则会发生这种情况。 如果扩展最近进行了更新,并且需要较新版本的 TAK CLI,则可能会发生这种情况。 若要解决此问题,请下载最新版本的 CLI 并重置路径。