Огляд інтерфейсу користувача розширення VEX VS Code

У цій статті наведено огляд інтерфейсу користувача розширення VEX Visual Studio Code. Розширення підтримує розробку проектів на C++ та Python для платформ VEX IQ 2-го покоління, EXP та V5.

Макет інтерфейсу користувача розширення VEX VS Code

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

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

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

Поширені піктограми, що використовуються для розробки 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, будь ласка, ознайомтеся з цією статтею

VEX View

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

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

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

  

  
  Ця категорія вказує на тип підключеного пристрою VEX та відображає інформацію про систему Brain, послідовний порт, завантажену програму та пристрої, підключені до інтелектуальних портів VEX Brain. Це дозволяє нам: зробити скріншот екрана VEX Brain, переглянути журнал подій VEX Brain, використовувати V5 Battery Medic, встановити
  мозку та номер команди , тастерти користувацьку програму з 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, будь ласка, дивіться цю статтю.
  
  

Перегляд дослідника

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

Редактор

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

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

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

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

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

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

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

  

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

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

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

Примітка: Панель інструментів активна лише тоді, коли у 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 та вибравши відповідні елементи в меню.

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

• Канал контролера (лише для контролера V5) - Встановлює радіоканал контролера V5 на Завантаження або Яма. Цей параметр застосовується лише до радіоканалу VEXnet.

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

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