Огляд інтерфейсу користувача розширення 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, це Подання розширення, Подання VEXта Подання оглядача.

Вид розширення

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

Щоб отримати покрокові інструкції щодо встановлення розширення VEX, розширення C/C++та розширення Python у VS Code, будь ласка, ознайомтеся з цією статтею

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

VEX View

VEX View дозволяє нам розробляти проекти для VEX IQ (2-го покоління), EXP та V5 у VS Code. У вікні VEX є три категорії: ДІЇ ПРОЄКТУ, ІНФОРМАЦІЯ ПРО ПРИСТРІЙ VEX, та ЗВОРОТНІЙ ЗВОРОТНІЙ ЗВ’ЯЗОК VEX.

VS Code VEX View, що показує опції для створення та імпорту проектів вище, меню VEX Device Info нижче та меню зворотного зв'язку внизу.

ДІЇ НАД ПРОЄКТОМ
Кнопки в розділі ДІЇ НАД ПРОЄКТОМ використовуються для створення нового проєкту VEX або імпорту існуючого проєкту VEXcode.
Для отримання детальних інструкцій щодо створення проєкту VEX у VS Code див. цю статтю для V5, цю статтю для EXPта цю статтю для IQ (2-го покоління).

Розділ «Дії проєкту» у вікні перегляду розширення VEX. У цьому розділі є дві кнопки з написами «Новий проект» та «Імпорт проекту».

ІНФОРМАЦІЯ ПРО ПРИСТРІЙ VEX
Категорія ІНФОРМАЦІЯ ПРО ПРИСТРІЙ VEX надає нам огляд підключеного пристрою VEX – VEX Brain або VEX Controller.

Ця категорія вказує на тип підключеного пристрою VEX та відображає інформацію про систему Brain, послідовний порт, завантажену програму та пристрої, підключені до інтелектуальних портів VEX Brain. Це дозволяє нам зробити скріншот екрана VEX Brain, переглянути журнал подій VEX Brain, встановити назву мозку та номер команди, а також видалити користувацьку програму з VEX Brain.

Коли VEX Brain підключено до комп’ютера, категорія ІНФОРМАЦІЯ ПРО ПРИСТРІЙ VEX показує, чи підключено контролер 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 Explorer, який дозволяє користувачеві переміщатися між папками та файлами у своєму VEX-проєкті. Файли мають відповідні значки та типи файлів, у цьому прикладі вибрано файл Python, а заголовок має вигляд main.py.

Редактор

Редактор – це основна область для редагування файлів у VS Code. Розширення VEX VS Code дозволяє використовувати Intellisense/Linting як для C/C++, так і для Python в області редактора, щоб допомогти нам під час розробки програми.

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

В області редактора ми можемо отримати доступ до корисної інформації про певну функцію, навівши курсор миші на текст функції або скориставшись Довідкою з команд VEX для доступу до документації до цієї функції, що входить до складу API (інтерфейсу прикладного програмування) C++ та Python.

Докладні інструкції щодо використання довідки з команд VEX у VS Code див. у цій статті

Панель терміналів

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

Термінал журналу – Термінал журналу відображає вивід збірки, помилки збірки та результати завантаження.

Термінал журналу VEX VS Code відкривається та відображає порожній стан за замовчуванням, лише з одним надрукованим повідомленням з текстом «Журнал».

Інтерактивний термінал - Інтерактивний термінал має дві функції: відображення журналів друку та надсилання необроблених натискань клавіш назад до користувацької програми.

Примітка: Щоб використовувати інтерактивний термінал, до комп’ютера з розширенням VEX VS Code Extension необхідно підключити Brain або Controller.
Примітка: Інтерактивний вивід терміналу очищається за замовчуванням після збірки та завантаження користувацької програми.

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

Панель інструментів містить набір значків, які надають нам швидкий спосіб взаємодії з проектами розширення 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. Ми можемо отримати доступ до налаштувань користувача VEX , натиснувши значок налаштувань у VS Code та вибравши відповідні елементи в меню.

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

Налаштування користувача VEX для налаштування розширення коду VEX VS:

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

Щоб отримати корисну інформацію про те, як отримати доступ до налаштувань користувача VEX та налаштувати їх, ознайомтеся цією статтею.