本文概述了 VEX Visual Studio Code 扩展 UI(用户界面)。 该扩展支持为 VEX IQ(第二代)、EXP 和 V5 平台开发 C++ 和 Python 项目。
VEX VS 代码扩展 UI 布局
VEX Visual Studio Code 扩展 UI 分为五个主要区域:活动栏、侧边栏、编辑器、终端面板和工具栏。
活动栏
活动栏具有一系列图标,让我们可以在视图之间切换,并为我们提供有关 VEX 项目开发的额外特定于上下文的指标。
在 VS Code 中开发 VEX 项目常用的图标是:
- 资源管理器视图图标 - 单击后, 资源管理器视图 将在侧栏中打开。
- 扩展视图图标 - 单击后, 扩展视图 将在侧栏中打开。
- VEX 视图图标 - 单击后, VEX 视图 将在侧边栏中打开。
侧边栏
侧边栏包含不同的视图,使我们能够使用 VS Code 中的集成工具。 用于执行 VEX 项目开发任务的常见侧边栏视图是 扩展视图VEX 视图 和 资源管理器
扩展视图
扩展视图 用于安装和管理 VS Code 中的扩展。 为了在 VEX IQ(第二代)、EXP 和 V5 平台上开发软件,我们需要安装 VEX 扩展、C/C++ 扩展和 Python 扩展。
有关如何在 VS Code 中安装 VEX 扩展、 C/C++ 扩展和 Python 扩展 分步说明,请查看 本文。
VEX 视图
VEX View 使我们能够在 VS Code 中为 VEX IQ(第二代)、EXP 和 V5 开发项目。 VEX 视图包含三个类别: 项目操作、VEX 设备信息、 和 VEX 反馈。
-
项目操作
项目操作 下 按钮用于创建新的 VEX 项目或导入现有的 VEXcode 项目。
有关在 VS Code 中创建 VEX 项目的详细指导,请参阅 针对 V5 的本文、 针对 EXP 的本文和 针对 IQ (第二代) 的本文。
-
VEX 设备信息
VEX 设备信息 类别为我们提供了所连接的 VEX 设备 - VEX Brain 或 VEX 控制器的概述。
此类别指示所连接的 VEX 设备类型并显示 Brain 系统、串行
、下载的程序以及连接到 VEX Brain 智能端口的设备的信息。 它允许我们截取 VEX Brain 屏幕的屏幕截图、查看 VEX Brain 事件日志、设置大脑名称和团队编号以及从 VEX Brain 中删除用户程序。
当 VEX Brain 连接到计算机时, VEX DEVICE INFO 类别会显示 VEX 控制器是否链接到 VEX Brain,并使我们能够 更新 VEX Brain 的 VEXos 如果 VEX Brain 的 VEXos 版本已过期。
当 VEX 控制器连接到计算机时, VEX DEVICE INFO 类别会显示 VEX Brain 是否链接到 VEX 控制器,并使我们能够 更新 VEX 控制器的 VEXos 如果 VEX 控制器的 VEXos 版本已过期。
有关设备信息的全面描述以及如何使用 VEX DEVICE INFO下的功能,请查看 本文。
-
VEX 反馈
我们可以通过在 VEX 反馈 下的文本框中输入消息并点击 发送 按钮来向 VEX 提交反馈。
有关在 VS Code 中使用 VEX 反馈 有用信息,请参阅 本文。
资源管理器视图
Explorer View 用于浏览、打开和管理 VS Code 中的 VEX 项目文件和文件夹。
编辑
编辑器是 VS Code 中编辑文件的主要区域。 VEX VS Code 扩展在编辑器区域为 C/C++ 和 Python 启用 Intellisense/Linting,以协助我们开发程序。
在编辑器区域,我们可以通过将鼠标悬停在函数文本上或使用 VEX 命令帮助 来访问 C++ 和 Python API(应用程序编程接口)中包含的该函数的文档,从而获取有关特定函数的有用信息。
有关在 VS Code 中使用 VEX 命令帮助 详细说明,请参阅 本文。
终端面板
VEX VS Code 扩展在启动时提供两个终端:日志终端和交互式终端。
-
日志终端 - 日志终端显示构建输出、构建错误和下载结果。
-
交互式终端 - 交互式终端具有两个功能 - 显示打印日志和将原始击键发送回用户程序。
注意: 要使用交互式终端,必须将 Brain 或控制器连接到运行 VEX VS Code Extension 的计算机。
注意: 构建和下载用户程序后,交互式终端输出默认被清除。
工具栏
工具栏具有一系列图标,为我们提供了一种与 VEX VS Code 扩展项目、VEX Brains 和 VEX 控制器进行交互的快捷方式。
注意: 仅当在 VS Code 中打开有效的 VEX 项目时,工具栏才处于活动状态。
注意: 有效的 VEX 项目是由扩展创建或导入的项目。 在编辑器中打开的 VEXcode 或 VEXcode Pro 项目将不被视为有效的 VEX 项目,需要导入。
工具栏上的图标包括:
-
设备选择器 - 设备选择器显示所连接的 VEX 设备的图标(大脑图标 或控制器图标 )
注意: 如果控制器连接到计算机,但没有与大脑的无线电链路,则控制器图标旁边不会显示大脑名称。
- 插槽选择器图标 - 插槽选择器图标 允许我们选择 VEX 扩展将下载或在哪个插槽上播放用户程序,方法是单击它并从选择列表中选择 VEX Brain 上的八个可用插槽之一。
- 构建 & 下载图标 - 如果连接了 VEX 设备,则 下载图标 将显示在工具栏上。 单击后,项目将构建,如果成功,则会下载到连接的 VEX 设备。
- 播放图标 - 单击后, 播放图标 将在 VEX Brain 上选定的插槽中运行下载的用户程序。
- 停止图标 - 单击时, 停止图标 停止在 VEX Brain 上运行用户程序。
- 项目选择器 - 项目选择器 显示所选项目的名称。 当工作区内存在多个 VEX 项目时, 项目选择器图标 允许我们通过单击它并从选择列表中选择一个项目来在 VEX 项目之间切换。
- Python 文件选择器(仅限 Python) - 当选择 VEX Python 项目时, Python 文件选择器 将出现在工具栏中。 Python 文件选择器 显示所选 Python 文件的名称。 Python for VEX 目前仅支持单个文件下载。
有关如何在 VS Code 中使用工具栏功能的有用信息,请查看 这篇文章。
VEX 用户设置
VEX 用户设置允许我们根据自己的要求配置 VEX 扩展。 用户设置是应用于每个 VEX VS Code 扩展项目的全局设置。 我们可以通过单击 VS Code 中的设置图标并选择菜单中的相应项目来访问 VEX 用户设置。
用于配置 VEX VS 代码扩展的 VEX 用户设置包括:
- Cpp 工具链路径 - 设置 CPP 工具链的路径。
- 启用用户终端- 启用或禁用扩展程序打开并显示来自用户端口的数据。
- 日志条目 - 设置从 VEX Brain 上传的日志条目数。
- 项目构建类型 - 设置扩展如何构建 C++ 项目。
- 项目主页 - 设置新项目的默认位置。
- 下载后运行 - 设置用户程序下载到 VEX Brain 后是否运行。
- 系统 DFU 自动恢复 - 设置在 DFU 模式下检测到 IQ(第二代)或 EXP 大脑时大脑是否应自动恢复。
- Websocket 服务器启用 - 启用或禁用扩展以启动 Websocket 服务器。
- Websocket 服务器主机地址 - 设置 Websocket 服务器的主机地址。
- Websocket 服务器端口 - 设置 Websocket 服务器端口号
有关如何访问和设置 VEX 用户设置的有用信息,请查看 本文。