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

В данной статье представлен обзор пользовательского интерфейса расширения VEX Visual Studio Code. Расширение поддерживает разработку проектов C++ и Python для платформ VEX IQ 2nd Generation, 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 2nd Generation, EXP и V5 нам необходимо установить расширение VEX, расширение C/C++ и расширение Python.

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

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

VEX Вид

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

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

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

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

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

В этой категории указывается тип подключенного устройства VEX и отображается информация о системе Brain, последовательном порте, загруженной программе и устройствах, подключенных к интеллектуальным портам VEX Brain. Это позволяет нам: сделать снимок экрана VEX Brain Screen, просмотреть журнал событий VEX Brain Log, использовать V5 Battery Medic, задать имя мозга и номер командыи стереть пользовательскую программу из 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, и его заголовок — VEXcode Project.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 Terminal открыт экран, на котором отображается пустое поле по умолчанию и только одно сообщение: Log.

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

Примечание: Для использования интерактивного терминала необходимо подключить модуль управления (Brain) или контроллер (Controller) к компьютеру, на котором запущено расширение 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 Extension.

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

Канал контроллера (только для контроллера V5) — устанавливает радиоканал контроллера V5 на Загрузка или Пит. Этот параметр применяется только к радиоканалу VEXnet.

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

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