Огляд VS Code UI для V5 – Бібліотека VEX

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

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні розробникам для покращення досвіду програмування.

Компоненти інтерфейсу користувача

Є 3 основні компоненти VEX VS Code Extension.

Панель інструментів
Панель активності та бічна панель
Термінальна панель

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

Панель інструментів дає користувачам швидкий спосіб взаємодії з проектами розширення VEX VS Code VEX Brains і контролерами VEX. Панель інструментів активна лише тоді, коли дійсний проект VEX відкрито в VS Code. Дійсний проект VEX – це проект, створений або імпортований розширенням. Відкриття проекту VEXcode або VEXcode Pro недійсне, і його потрібно імпортувати.

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні для розробників, із виділеними розділами для зручності навігації та використання.

Вибір пристрою

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні користувачам для покращення досвіду розробки.

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

Знімок екрана інтерфейсу V5 VS Code Extension, що демонструє функції та інструменти, доступні для розробників, які використовують платформу VEX Robotics.

По-друге, коли клацнути піктограму списку пристроїв, з’явиться список швидкого вибору з усіма підключеними пристроями VEX. Користувач може вибрати, до якого пристрою підключатиметься розширення.
Поточний підключений пристрій завжди відображатиметься у верхній частині списку, а потім усі інші пристрої, відсортовані за типом пристрою (Мозок або Контролер) і платформою (IQ 2-го покоління, EXP і V5).

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні для покращення робочих процесів розробки.

Кожен елемент пристрою містить назву мозку, платформу, тип пристрою та інформацію про шлях до пристрою.

Знімок екрана розширення VS Code для V5, що демонструє інтерфейс і функції, призначені для підвищення ефективності кодування та підтримки розробки V5.

Знімок екрана інтерфейсу розширення VS Code для V5, що демонструє функції та інструменти, доступні для розробників, включаючи фрагменти коду, параметри налагодження та функції керування проектами.

важливо

Якщо контролер під’єднано до комп’ютера, але не має радіозв’язку з мозком, ім’я мозку не відображатиметься поруч із елементом списку або значком рядка стану списку пристроїв.

Селектор слотів

Знімок екрана інтерфейсу V5 VS Code Extension, що демонструє функції та інструменти, доступні для розробки V5, включаючи фрагменти коду та параметри налагодження.

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

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні для розробки V5, включаючи фрагменти коду та параметри керування проектами.

Коли клацнути піктограму вибору слота, з’являється список швидкого вибору з доступними слотами програми користувача 1-8.

Збірка/завантаження

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні для розробників, з акцентом на підвищення продуктивності та керування кодом. Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні для розробників, зокрема параметри редагування коду та функції керування проектами.

Значок збірки/завантаження змінює функції, якщо підключено VEX Brain або контролер VEX.

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

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні для розробників, зокрема параметри редагування коду та функції керування проектами.

Якщо під’єднано пристрій VEX, відображається значок завантаження. Якщо натиснути, проект буде створено та в разі успіху буде завантажено на пристрій VEX.

грати

Знімок екрана розширення коду VS для версії 5, що демонструє його інтерфейс користувача та функції, зокрема інструменти редагування коду та інтеграцію робототехніки VEX.

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

СТІЙ

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні для розробників, які використовують платформу V5.

Після натискання піктограми зупинки програма користувача зупиняється.

Вибрана робоча область

Знімок екрана розширення коду VS для версії 5, що демонструє його користувальницький інтерфейс і функції, включаючи інструменти редагування коду та параметри категорії V5, призначені для покращення досвіду розробки.

VS Code підтримує проекти з декількома робочими просторами. Селектор проектів дозволяє користувачам перемикатися між проектами VEX, якщо в робочому просторі існує кілька.

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та функції, пов’язані з описом категорії V5, включаючи інструменти редагування коду та параметри для розробників.

Коли клацнути піктограму вибору проектів, з’явиться список швидкого вибору з усіма дійсними проектами.

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

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні для розробників, включаючи параметри редагування коду та налагодження.

Селектор файлів Python (лише Python)
Коли вибрано проект VEX python, селектор файлів python з’явиться на панелі інструментів. Наразі Python для VEX підтримує завантаження лише одного файлу.

Після натискання піктограми з’являється список швидкого вибору з усіма файлами python, розташованими в каталозі робочої області.
Селектор файлів Python дозволяє користувачеві перемикатися між вихідними файлами Python (.py)

Панель активності та бічна панель VEX

Знімок екрана розширення VS Code для V5, що демонструє його інтерфейс користувача та функції, пов’язані з описом категорії V5, включаючи інструменти редагування коду та параметри навігації.

Проекти Дії

Знімок екрана інтерфейсу V5 VS Code Extension, що демонструє функції та функції для покращення кодування за допомогою робототехніки VEX.

Панель активності vex містить перегляд дій проекту та перегляд інформації про пристрій VEX.

Перегляд дій проекту використовується для створення нового проекту або імпорту існуючого проекту VEXcode або VEXcode Pro.

Щоб дізнатися більше про створення нового проекту, перегляньте цю статтю!

Інформація про версію також відображається в нижньому лівому та правому кутах перегляду.

Важливо
Якщо проект VEXcode або VEXcode Pro відкрито в редакторі, він не вважатиметься дійсним проектом VEX, проект потрібно імпортувати за допомогою кнопки «Імпорт» на бічній панелі VEX.

Інформація про пристрій VEX

Знімок екрана розширення коду VS для V5, що демонструє його інтерфейс і функції, включно з інструментами редагування коду та специфічними функціями V5. Знімок екрана інтерфейсу VEX V5 Code Extension у Visual Studio Code, що демонструє ключові функції та параметри, доступні для програмування робототехнічних систем V5.

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

Інформація про систему

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні для розробників у категорії V5.

Системна інформація містить короткий огляд підключеного пристрою VEX. Це включає версію VEXos пристрою, назву Brain, номер команди, ідентифікатор Brain ID та інформацію про версію середовища виконання python.

Інформація про послідовний порт

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні для розробників, включаючи фрагменти коду та параметри налагодження.

Інформація про послідовний порт відображає шлях до кожного порту, доступного для пристрою VEX. Більшість пристроїв VEX називаються двома послідовними портами. Послідовний порт зв'язку використовується для завантаження програм і керування функціями мозку. Послідовний порт користувача використовується для передачі даних між програмою користувача, що працює на Brain, і головним комп’ютером, під’єднаним через USB. Контролер V5 — це єдиний пристрій VEX, який має лише послідовний порт зв’язку та не має послідовного порту користувача.

Інформація про програми

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні для розробників, які працюють із проектами V5.

Інформація про програму відображає список усіх завантажених програм користувача на VEX Brain.

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні для розробників, включаючи фрагменти коду та параметри інтеграції.

Кожен пункт списку програм можна розширити, щоб показати додаткову інформацію про кожну програму користувача, таку як розташування слота, ім’я файлу, тип мови, розмір файлу та час завантаження.

Інформація про пристрої

Знімок екрана інтерфейсу V5 VS Code Extension, що демонструє функції та інструменти, доступні для розробки V5, включаючи фрагменти коду та параметри конфігурації.

Інформація про пристрої показує список усіх пристроїв розумного порту, підключених до VEX Brain. Кожен елемент списку показує номер смарт-порту та тип пристрою.

Кожен пункт списку пристроїв можна розгорнути, щоб відобразити інформацію про версію мікропрограми для кожного пристрою з інтелектуальним портом.

При підключенні до VEX Brain Device відображається статус підключення контролера.

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні для розробників, що працюють з VEX Robotics, включаючи параметри редагування коду та налагодження.

VEX Brain підключено до контролера VEX

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та функції, важливі для розробників, які використовують платформу V5.

VEX Brain не підключено до контролера VEX

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє ключові функції та інструменти, доступні розробникам для покращення досвіду програмування.

Контролер VEX V5 прив’язаний до VEX V5 Brain

Скріншоти

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє різні функції та інструменти, доступні розробникам для покращення досвіду програмування.

Натиснувши піктограму камери, користувач може зробити та завантажити знімок екрана з VEX Brain.
Знімки екрана доступні лише за умови безпосереднього підключення до VEX Brain через USB

Battery Medic (лише V5 Brain)

Знімок екрана розширення коду VS для V5, що демонструє його інтерфейс і функції, зокрема інструменти редагування коду та параметри інтеграції робототехніки VEX.

Якщо натиснути на піктограму серця, розширення завантажить і запустить програму користувача battery medic.

Встановіть назву мозку

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

Натиснувши піктограму олівця поруч із назвою системи>, користувач може встановити назву для VEX Brain.

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні для програмування робототехніки VEX, включаючи параметри редагування коду та налагодження.

Після натискання піктограми олівця у верхній частині редактора коду VS з’явиться поле введення. Введіть нову назву мозку в поле введення та натисніть клавішу Enter, щоб встановити.

Встановіть номер команди

Натиснувши піктограму олівця біля команди system->, користувач може встановити номер команди для VEX Brain.

Знімок екрана розширення VS Code для V5, що демонструє інтерфейс користувача та функції, пов’язані з розробкою категорії V5, включаючи інструменти редагування коду та параметри інтеграції.

Після натискання піктограми олівця у верхній частині редактора коду VS з’явиться поле введення. Введіть новий номер команди в полі введення та натисніть Enter, щоб встановити.

Стерти програму користувача

Натиснувши піктограму Trashcan поруч із назвою проекту programs->, користувач може стерти програму в певному слоті. ВАЖЛИВО, після видалення програми її неможливо відновити. Використовуючи цю функцію, будьте обережні.

Попередження щодо інформації про пристрій

Оновлення VEXos

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні для розробників, включаючи параметри редагування коду та можливості інтеграції.

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

Щоб усунути це попередження, користувач повинен оновити VEXos для свого VEXos Brain.

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та функціональні можливості для покращення досвіду кодування, включаючи меню та параметри інструментів.

VEXos можна оновити, клацнувши стрілку вгору біля значка VEX Brain.

Знімок екрана розширення коду VS для версії 5, що демонструє його користувальницький інтерфейс і функції, зокрема інструменти редагування коду та параметри інтеграції для покращеного досвіду розробки.

Крім того, у нижньому правому куті редактора VS Code з’явиться вікно сповіщень, коли VEXos застарів. Користувач може розпочати оновлення VEXos, натиснувши кнопку «Оновити», або натиснути кнопку «Ігнорувати», щоб пропустити оновлення VEXos.

Мозок не підключений до підключеного контролера

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні для розробників, включаючи фрагменти коду та параметри керування проектами.

Піктограма контролера VEX стане жовтою, коли контролер VEX підключено до комп’ютера, але не під’єднано до VEX Brain.

Щоб усунути це попередження, користувач повинен підключити контролер VEX до VEX Brain

Термінальна панель

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

Журнал Термінал

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні для розробки V5, включаючи параметри редагування коду та налагодження.

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

Інтерактивний термінал

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні для розробки робототехніки VEX, включаючи параметри редагування коду та налагодження.

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

Налаштування користувача

Параметри користувача — це параметри глобальних параметрів, які код Visual Studio пропонує для кожного розширення. Налаштування користувача застосовуються до кожного проекту розширення VEX VS Code.

Як отримати доступ до налаштувань користувача VEX

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та опції, доступні користувачам для покращення досвіду кодування за допомогою робототехніки VEX.

Натисніть значок шестірні в лівому куті VS Code, і з’явиться контекстне меню

У контекстному меню клацніть пункт «Налаштування», з’явиться сторінка налаштувань.

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні для розробників, включаючи параметри редагування коду та специфічні функції VEX.

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

Натисніть на пункт списку «VEX».

Знімок екрана розширення коду VS для версії 5, на якому відображено функції та функції, пов’язані з описом категорії V5, включаючи елементи інтерфейсу користувача та фрагменти коду.

Параметри користувача VEX з’являться на правій панелі.

Огляд налаштувань

Канал контролера (лише контролер V5)

Налаштування Controller Channel керує типом каналу радіозв’язку між V5 Brain і V5 Controller.
Цей параметр застосовується лише тоді, коли VS Code підключено до контролера V5 через USB, а контролер підключено до V5 Brain через VEXnet. Користувач може вибрати між Download і Pit канали. Якщо встановлено значення Download, радіостанція перейде до каналу VEXnet для завантаження після початку завантаження програми користувача. Канал завантаження забезпечує вищу швидкість передачі даних і більш ефективне завантаження. Якщо встановлено значення Pit, радіо залишатиметься на каналі pit, і завантаження триватиме набагато довше. За замовчуванням для цього параметра встановлено значення Завантажити.

Домашня сторінка Cpp Project SDK

НЕ РЕДАГУЙТЕ ЦЕ НАЛАШТУВАННЯ.

Шлях ланцюжка інструментів Cpp

Cpp Toolchain Path встановлює шлях для інструментального ланцюга, який використовується під час створення проекту C++ VEX VS Code.

Знімок екрана інтерфейсу VS Code Extension для V5, що демонструє функції та інструменти, доступні для розробників, зокрема фрагменти коду, параметри налагодження та інструменти керування проектами.

Увімкнути термінал користувача

Налаштування Enable User Terminal дозволяє розширенню відкривати послідовний порт користувача, коли розширення виявляє VEX Brain або VEX Controller. Єдиний виняток стосується контролера V5, який не нумерує послідовний порт користувача.

Enable дозволяє розширенню підключатися до порту користувача під час запуску та створює інтерактивний термінал. Якщо під час роботи розширення вибрано параметр «Увімкнути», розширення намагатиметься відкрити порт користувача, якщо пристрій підключено.
Вимкнути запобігає підключенню розширення до порту користувача під час запуску та не створює інтерактивний термінал. Якщо під час роботи розширення вибрано «Вимкнути», розширення закриє порт користувача та видалить інтерактивний термінал.

Тип збірки проекту

Тип збірки проекту встановлює, як розширення створюватиме проект C++. Користувач може встановити тип побудови: Build або Rebuild.
Build збирає проект лише тоді, коли Make виявляє будь-які зміни у вихідному коді проекту.
Rebuild очищає каталог збірки проекту, а потім збирає проект. Цей варіант зазвичай набагато повільніший.

Знімок екрана розширення VS Code для V5, що демонструє його інтерфейс і функції, призначені для підвищення ефективності кодування та спрощення процесів розробки для користувачів, які працюють із проектами V5.

Головна сторінка проекту

Домашня сторінка проекту встановлює домашній каталог за замовчуванням для нового проекту після завершення роботи майстра нового проекту.

Запустити після завантаження

Запуск після завантаження коли ввімкнено, запускає програму користувача після її завантаження на VEX Brain.

Знімок екрана розширення коду VS для версії 5, що демонструє його користувальницький інтерфейс і функції, зокрема інструменти редагування коду та специфічні функції VEX.

Домашня сторінка Python SDK

НЕ РЕДАГУЙТЕ ЦЕ НАЛАШТУВАННЯ.

Знімок екрана інтерфейсу V5 VS Code Extension, що демонструє функції та інструменти, доступні для розробки V5, включаючи фрагменти коду та параметри керування проектами.

Довідка про команди VEX

Довідка VEX Command надає доступ до документації для певних функцій, які входять до C++ і Python API (інтерфейс прикладного програмування). Документація стосується кожної платформи VEX (IQ 2-го покоління, EXP, V5).

Знімок екрана розширення коду VS для V5, що демонструє його інтерфейс користувача та функції, зокрема інструменти редагування коду та параметри інтеграції для програмування VEX robotics.

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

Клацніть правою кнопкою миші на виділеному тексті, і з’явиться контекстне меню.
Далі Натисніть довідку команди VEX, щоб отримати доступ до документації.

Знімок екрана інтерфейсу VS Code Extension для V5, на якому відображено функції та інструменти, доступні для розробників, зокрема фрагменти коду та параметри керування проектами.

Якщо довідка VEX Command знайде точний збіг, з’явиться нове веб-перегляд із відповідною документацією.

Якщо виділеному тексту відповідає декілька документів, з’явиться розкривний список із відфільтрованим списком відповідної документації.