本文概述了 VEX Visual Studio Code 扩展 UI(用户界面)。 该扩展支持为 VEX IQ(第二代)、EXP 和 V5 平台开发 C++ 和 Python 项目。

VEX VS 代码扩展 UI 布局

VEX Visual Studio Code 扩展 UI 分为五个主要区域:活动栏、侧边栏、编辑器、终端面板和工具栏。

活动栏

活动栏具有一系列图标,让我们可以在视图之间切换,并为我们提供有关 VEX 项目开发的额外特定于上下文的指标。

在 VS Code 中开发 VEX 项目常用的图标是:

  • Visual Studio Code 中 VEX V5 代码扩展界面的屏幕截图,展示了可用于编程 VEX 机器人的各种功能和工具。 资源管理器视图图标 - 单击后, 资源管理器视图 将在侧栏中打开。
  • Visual Studio Code 中 VEX V5 代码扩展界面的屏幕截图,展示了可用于编程 VEX 机器人的功能和工具。 扩展视图图标 - 单击后, 扩展视图 将在侧栏中打开。
  • 该图表说明了 VEX V5 VS 代码扩展的特性和功能,重点介绍了用于编程 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 设备信息
    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 Device Picker showing icons for connected VEX devices, including a Brain icon and a Controller icon, as part of the V5 Category Description in the VS Code Extension section. 或控制器图标 Icon of a controller representing the V5 category in the context of the VS Code Extension, illustrating functionality related to programming and controlling VEX robotics.
    注意: 如果控制器连接到计算机,但没有与大脑的无线电链路,则控制器图标旁边不会显示大脑名称。
  • Visual Studio Code 中 VEX V5 代码扩展界面的屏幕截图,展示了用户可用于开发和管理 VEX 机器人项目的各种编程功能和工具。 插槽选择器图标 - 插槽选择器图标 允许我们选择 VEX 扩展将下载或在哪个插槽上播放用户程序,方法是单击它并从选择列表中选择 VEX Brain 上的八个可用插槽之一。
  • Visual Studio Code 中 VEX V5 代码扩展界面的屏幕截图,展示了用于编程 VEX 机器人的功能和工具。 构建 & 下载图标 - 如果连接了 VEX 设备,则 下载图标 将显示在工具栏上。 单击后,项目将构建,如果成功,则会下载到连接的 VEX 设备。
  • VEX V5 VS Code Extension 界面的屏幕截图,显示了用于编程 VEX 机器人的代码编辑功能和工具。 该图突出显示了为提高编码效率而设计的用户友好布局和功能。 播放图标 - 单击后, 播放图标 将在 VEX Brain 上选定的插槽中运行下载的用户程序。
  • VEX V5 代码扩展界面截图展示了 Visual Studio Code 中用于机器人编程的代码编辑功能和工具。 停止图标 - 单击时, 停止图标 停止在 VEX Brain 上运行用户程序。
  • VS Code 中 VEX V5 代码扩展界面的屏幕截图,展示了用于编程 VEX 机器人的功能和工具,包括代码编辑、调试选项和项目管理。 项目选择器 - 项目选择器 显示所选项目的名称。 当工作区内存在多个 VEX 项目时, 项目选择器图标 允许我们通过单击它并从选择列表中选择一个项目来在 VEX 项目之间切换。
  • V5 的 VS Code 扩展界面的屏幕截图,展示了可供开发人员使用的功能和工具,包括代码编辑、调试选项和集成功能。 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 用户设置的有用信息,请查看 本文

For more information, help, and tips, check out the many resources at VEX Professional Development Plus

Last Updated: