Обзор пользовательского интерфейса расширения VEX VS Code – Библиотека VEX

В данной статье представлен обзор пользовательского интерфейса расширения VEX Visual Studio Code. Расширение поддерживает разработку проектов C++ и Python для платформ VEX IQ (2-го поколения), EXP и V5.

Макет пользовательского интерфейса расширения VEX VS Code

Пользовательский интерфейс расширения VEX Visual Studio Code разделен на пять основных областей: панель действий, боковая панель, редактор, панель терминала и панель инструментов.

Скриншот, показывающий полную компоновку пользовательского интерфейса VEX VS Code. Панель активности и боковая панель находятся на левой стороне экрана, панель инструментов и терминал — на нижней стороне экрана, а редактор заполняет остальную часть экрана.

Панель активности

Панель активности содержит набор значков, которые позволяют переключаться между представлениями и предоставляют дополнительные контекстно-зависимые индикаторы для разработки проекта VEX.

Панель активности VS Code с установленным расширением VEX Robotics. На панели активности расположены значки, которые обеспечивают полезные быстрые действия, такие как поиск, управление расширениями, контроль версий и многое другое.

Распространенные значки, используемые при разработке проекта VEX в VS Code:

Значок представления обозревателя - При щелчке представление обозревателя открывается на боковой панели.
Значок представления расширений - При щелчке на боковой панели открывается представление расширений.
Значок VEX View - При щелчке VEX View открывается на боковой панели.

Боковая панель

Боковая панель содержит различные представления, позволяющие использовать интегрированные инструменты VS Code. Распространенными представлениями боковой панели, используемыми для выполнения задач по разработке проектов VEX, являются Extension View, VEX Viewи Explorer View.

Расширенный вид

Extension View используется для установки и управления расширениями в VS Code. Для разработки программного обеспечения на платформах VEX IQ (2-го поколения), EXP и V5 нам необходимо установить расширение VEX, расширение C/C++ и расширение Python.

Пошаговые инструкции по установке расширения VEX, расширения C/C++и расширения Python в VS Code см. в этой статье.

VS Code Extension View, показывающий список установленных расширений. Каждое расширение имеет меню настроек, которое можно открыть здесь, а также строку поиска для поиска и загрузки новых расширений.

VEX View

VEX View позволяет нам разрабатывать проекты для VEX IQ (2-го поколения), EXP и V5 в VS Code. В представление VEX включены три категории: ДЕЙСТВИЯ ПРОЕКТА, ИНФОРМАЦИЯ ОБ УСТРОЙСТВЕ VEX, и ОБРАТНАЯ СВЯЗЬ VEX.

VS Code VEX View, в котором вверху показаны параметры создания и импорта проектов, ниже — меню информации об устройстве VEX и внизу — меню обратной связи.

ДЕЙСТВИЯ ПРОЕКТА
Кнопки под ДЕЙСТВИЯМИ ПРОЕКТА используются для создания нового проекта VEX или импорта существующего проекта VEXcode.
Подробные инструкции по созданию проекта VEX в VS Code см. в этой статье для V5, этой статье для EXPи этой статье для IQ (2nd gen).

Раздел «Действия проекта» в представлении расширения VEX. В этом разделе есть две кнопки: «Новый проект» и «Импорт проекта».

ИНФОРМАЦИЯ ОБ УСТРОЙСТВЕ VEX
Категория ИНФОРМАЦИЯ ОБ УСТРОЙСТВЕ VEX предоставляет нам обзор подключенного устройства VEX — VEX Brain или VEX Controller.

В этой категории указывается тип подключенного устройства VEX и отображается информация о системе Brain, последовательном порте, загруженной программе и устройствах, подключенных к интеллектуальным портам VEX Brain. Это позволяет нам делать снимки экрана VEX Brain, просматривать журнал
VEX Brain, задавать имя мозга и номер команды, а также стирать пользовательскую программу из VEX Brain.
Когда VEX Brain подключен к компьютеру, категория VEX DEVICE INFO показывает, подключен ли контроллер VEX к VEX Brain, и позволяет нам обновить VEXos для VEX Brain, если версия VEXos VEX Brain устарела.

Когда контроллер VEX подключен к компьютеру, категория ИНФОРМАЦИЯ ОБ УСТРОЙСТВЕ VEX показывает, связан ли VEX Brain с контроллером VEX, и позволяет нам обновить VEXos для контроллера VEX, если версия VEXos контроллера VEX устарела.

Для полного описания информации об устройстве и того, как использовать функции в разделе ИНФОРМАЦИЯ ОБ УСТРОЙСТВЕ VEX, пожалуйста, ознакомьтесь этой статьей.

ОБРАТНАЯ СВЯЗЬ VEX
Мы можем отправить отзыв в VEX, введя сообщение в текстовое поле под ОБРАТНАЯ СВЯЗЬ VEX и нажав кнопку ОТПРАВИТЬ
Полезную информацию об использовании VEX FEEDBACK в VS Code см. в этой статье.

Раздел «Обратная связь VEX» в представлении расширения VEX. В этом разделе представлена форма с вариантами отправки отзыва в VEX.

Вид обозревателя

Explorer View используется для просмотра, открытия и управления файлами и папками проекта VEX в VS Code.

Вид обозревателя VS Code, позволяющий пользователю перемещаться по папкам и файлам в проекте VEX. Файлы имеют соответствующие значки и типы файлов, в этом примере выбран файл Python, а заголовок — main.py.

Редактор

Редактор — это основная область редактирования файлов в VS Code. Расширение VEX VS Code включает Intellisense/Linting для C/C++ и Python в области редактора, чтобы помочь нам при разработке программы.

Редактор VS Code с файлом Python, открытым как часть проекта VEX. Здесь можно писать и редактировать код Python или C/C++ для создания программ робототехники VEX при подключении к VEX Brain.

В области редактора мы можем получить полезную информацию о конкретной функции, наведя указатель мыши на текст функции или используя VEX Command Help для доступа к документации по этой функции, включенной в C++ и Python API (интерфейс прикладного программирования).

Подробные инструкции по использованию VEX Command Help в VS Code см. в этой статье.

Терминальная панель

Расширение VEX VS Code при запуске предоставляет два терминала: терминал журнала и интерактивный терминал.

Log Terminal — Log Terminal отображает выходные данные сборки, ошибки сборки и результаты загрузки.

Терминал журнала VS Code VEX открывается и отображает пустое состояние по умолчанию с единственным выведенным сообщением: Log.

Интерактивный терминал - Интерактивный терминал имеет две функции: отображение журналов печати и отправку необработанных нажатий клавиш обратно в пользовательскую программу.

Примечание: Чтобы использовать интерактивный терминал, мозг или контроллер должны быть подключены к компьютеру, на котором запущено расширение VEX VS Code.
Примечание: Вывод интерактивного терминала очищается по умолчанию после сборки и загрузки пользовательской программы.

Панель инструментов

Панель инструментов содержит набор значков, которые позволяют быстро взаимодействовать с проектами расширения VEX VS Code, VEX Brains и VEX Controllers.

Панель инструментов VS Code со значками расширения VEX, которые можно использовать для быстрого взаимодействия с подключенными устройствами и проектами VEX. Функции VEX включают в себя выбор устройства, выбор слота, значок загрузки сборки & , значок воспроизведения, значок остановки, выбор проекта и выбор файла Python.

Примечание: Панель инструментов активна только в том случае, если в VS Code открыт допустимый проект VEX.

Примечание: Допустимый проект VEX — это проект, созданный или импортированный расширением. Проекты VEXcode или VEXcode Pro, открытые в редакторе, не будут считаться допустимыми проектами VEX и должны быть импортированы.

На панели инструментов представлены следующие значки:

Выбор устройства - Выбор устройства отображает значок подключенного устройства VEX (значок мозга или значок контроллера )
Примечание: Если контроллер подключен к компьютеру, но не имеет радиосвязи с мозгом, то рядом со значком контроллера не будет отображаться название мозга.

Значок выбора слота - Значок выбора слота позволяет нам выбрать, в какой слот расширение VEX будет загружать или воспроизводить пользовательскую программу, щелкнув по нему и выбрав один из восьми доступных слотов в VEX Brain из списка выбора.
Сборка & Значок загрузки - Если подключено устройство VEX, на панели инструментов отобразится Значок загрузки. После нажатия проект будет собран и, в случае успеха, загружен на подключенное устройство VEX.
Значок воспроизведения - При нажатии на значок воспроизведения запускается загруженная пользовательская программа в выбранном слоте VEX Brain.
Значок остановки - При нажатии на значок остановки останавливается выполнение пользовательской программы на VEX Brain.
Селектор проектов - Селектор проектов отображает имя выбранного проекта. Значок выбора проекта позволяет нам переключаться между проектами VEX, если в рабочей области их несколько, щелкнув по нему и выбрав проект из списка.
Селектор файлов Python (только Python) — при выборе проекта VEX Python на панели инструментов появится Селектор файлов Python. Селектор файлов Python отображает имя выбранного файла Python. В настоящее время Python для VEX поддерживает только загрузку отдельных файлов.

Полезную информацию об использовании функций панели инструментов в VS Code можно встатье.

Настройки пользователя VEX

Настройки пользователя VEX позволяют нам настраивать расширение VEX в соответствии с нашими собственными требованиями. Настройки пользователя — это глобальные настройки, применяемые к каждому проекту расширения VEX VS Code. Доступ к настройкам пользователя можно получить, щелкнув значок «Настройки» в VS Code и выбрав соответствующие пункты в меню.

Настройки пользователя VS Code открываются в категории VEX, где можно настроить поведение расширения VEX Robotics.

Пользовательские настройки VEX для настройки расширения VEX VS Code:

Путь к цепочке инструментов Cpp — задает путь для цепочки инструментов CPP.
Включить пользовательский терминал— включает или выключает возможность расширения открывать и отображать данные из пользовательского порта.
Записей журнала — устанавливает количество записей журнала для загрузки из VEX Brain.
Тип сборки проекта — устанавливает, как расширение будет собирать проект C++.
Project Home — задает местоположение по умолчанию для новых проектов.
Запустить после загрузки — устанавливает, должна ли пользовательская программа запускаться после ее загрузки в VEX Brain.
Автоматическое восстановление системы DFU — устанавливает, должен ли мозг автоматически восстанавливаться при обнаружении мозга IQ (2-го поколения) или EXP в режиме DFU.
Включить сервер Websocket — включает или выключает расширение для запуска сервера Websocket.
Адрес хоста сервера Websocket — задает адрес хоста сервера Websocket.
Порт сервера Websocket — задаёт номер порта сервера Websocket

Полезную информацию о том, как получить доступ к настройкам пользователя VEX и настроить их, можно в этой.