Přehled uživatelského rozhraní rozšíření kódu VEX VS – Knihovna VEX

Tento článek poskytuje přehled uživatelského rozhraní (UI) rozšíření VEX Visual Studio Code. Rozšíření podporuje vývoj projektů v C++ a Pythonu pro platformy VEX IQ (2. generace), EXP a V5.

Rozvržení uživatelského rozhraní rozšíření kódu VEX VS

Uživatelské rozhraní rozšíření VEX Visual Studio Code je rozděleno do pěti hlavních oblastí: Panel aktivit, Boční panel, Editor, Panel terminálu a Panel nástrojů.

Snímek obrazovky zobrazující kompletní rozvržení uživatelského rozhraní VEX VS Code. Panel aktivit a postranní panel se nacházejí na levé straně obrazovky, panel nástrojů a terminál na spodní straně obrazovky a zbytek obrazovky vyplňuje editor.

Panel aktivit

Panel aktivit obsahuje řadu ikon, které nám umožňují přepínat mezi zobrazeními a poskytují nám další kontextově specifické indikátory pro vývoj projektu VEX.

Panel aktivit VS Code s nainstalovaným rozšířením VEX Robotics. Panel aktivit obsahuje ikony, které umožňují užitečné rychlé akce, jako je vyhledávání, správa rozšíření, správa verzí a další.

Běžné ikony používané pro vývoj VEX projektu ve VS Code jsou:

Ikona zobrazení Průzkumníka - Po kliknutí se v postranním panelu otevře Zobrazení Průzkumníka.
Ikona zobrazení rozšíření - Po kliknutí se v bočním panelu otevře Zobrazení rozšíření.
Ikona zobrazení VEX - Po kliknutí se v postranním panelu otevře zobrazení VEX .

Boční panel

Postranní panel obsahuje různá zobrazení, která nám umožňují používat integrované nástroje ve VS Code. Běžná zobrazení postranního panelu používaná k provádění úkolů při vývoji projektů VEX jsou Zobrazení rozšíření, Zobrazení VEXa Zobrazení průzkumníka.

Zobrazení rozšíření

Zobrazení Extension View se používá k instalaci a správě rozšíření ve VS Code. Pro vývoj softwaru na platformách VEX IQ (2. generace), EXP a V5 musíme nainstalovat rozšíření VEX, rozšíření C/C++ a rozšíření Python.

Podrobné pokyny k instalaci rozšíření VEX, rozšíření C/C++a rozšíření Python ve VS Code naleznete

Zobrazení rozšíření VS Code, které zobrazuje seznam nainstalovaných rozšíření. Každé rozšíření má nabídku nastavení, kterou lze otevřít zde, a je zde vyhledávací panel pro nalezení a stažení nových rozšíření.

Zobrazení VEX

VEX View od nám umožňuje vyvíjet projekty pro VEX IQ (2. generace), EXP a V5 ve VS Code. V zobrazení VEX jsou zahrnuty tři kategorie: AKCE PROJEKTU, INFORMACE O ZAŘÍZENÍ VEX, a ZPĚTNÁ VAZBA VEX.

Zobrazení VEX ve VS Code, které výše zobrazuje možnosti pro vytváření a import projektů, níže nabídku Informace o zařízení VEX a dole nabídku zpětné vazby.

AKCE PROJEKTU
Tlačítka v části AKCE PROJEKTU se používají k vytvoření nového projektu VEX nebo k importu existujícího projektu VEXcode.
Podrobné pokyny k vytvoření projektu VEX ve VS Code naleznete tomto článku pro V5, tomto článku pro EXPa tomto článku pro IQ (2. generace).

Sekce Akce projektu v zobrazení rozšíření VEX. Tato sekce obsahuje dvě tlačítka s nápisy Nový projekt a Importovat projekt.

INFORMACE O ZAŘÍZENÍ VEX
Kategorie INFORMACE O ZAŘÍZENÍ VEX nám poskytuje přehled připojeného zařízení VEX – mozku VEX nebo ovladače VEX.

Tato kategorie označuje typ připojeného zařízení VEX a zobrazuje informace o systému Brain, sériovém portu, staženém programu a zařízeních připojených k inteligentním portům zařízení VEX Brain. Umožňuje nám pořídit snímek obrazovky VEX Brain, zobrazit protokol událostí VEX Brain, nastavit název mozku a číslo týmu a vymazat uživatelský program z VEX Brain.

Když je VEX Brain připojen k počítači, kategorie INFORMACE O ZAŘÍZENÍ VEX ukazuje, zda je k VEX Brain připojen ovladač VEX, a umožňuje nám aktualizovat VEXos pro VEX Brain, pokud je verze VEXos pro VEX Brain zastaralá.

Když je k počítači připojen ovladač VEX, kategorie INFORMACE O ZAŘÍZENÍ VEX ukazuje, zda je k ovladači VEX připojen VEX Brain, a umožňuje nám aktualizovat VEXos pro ovladač VEX, pokud je verze VEXos ovladače VEX zastaralá.

Úplný popis informací o zařízení a způsob používání funkcí uvedených v INFORMACE O ZAŘÍZENÍ VEXnaleznete tomto článku.

ZPĚTNÁ VAZBA K VEXU
Zpětnou vazbu můžeme do VEXu odeslat napsáním zprávy do textového pole pod ZPĚTNÁ VAZBA K VEXU a kliknutím na tlačítko ODESLAT
Užitečné informace o používání funkce VEX FEEDBACK ve VS Code naleznete tomto článku.

Sekce VEX Feedback v zobrazení VEX Extension. Tato sekce obsahuje formulář s možnostmi pro odeslání zpětné vazby společnosti VEX.

Zobrazení Průzkumníka

Zobrazení Průzkumníka se používá k procházení, otevírání a správě souborů a složek projektu VEX ve VS Code.

Zobrazení VS Code Explorer, které umožňuje uživateli procházet složky a soubory v jeho projektu VEX. Soubory mají zobrazené odpovídající ikony a typy souborů, v tomto příkladu je vybrán soubor Pythonu a jeho název zní main.py.

Editor

Editor je hlavní oblastí pro úpravu souborů ve VS Code. Rozšíření VEX VS Code Extension umožňuje v editoru používat Intellisense/Linting pro C/C++ i Python, což nám pomáhá při vývoji programu.

Editor kódu VS se souborem Pythonu otevřeným jako součást projektu VEX. Zde lze psát a upravovat kód v Pythonu nebo C/C++ a vytvářet tak robotické programy VEX po připojení k VEX Brain.

V oblasti Editoru můžeme zobrazit užitečné informace o konkrétní funkci tak, že najedeme myší na text funkce, nebo pomocí nápovědy k příkazům VEX která je součástí API (Application Programming Interface) jazyků C++ a Python.

Podrobné pokyny k používání nápovědy k příkazům VEX ve VS Code naleznete tomto článku.

Terminálový panel

Rozšíření VEX VS Code nabízí při spuštění dva terminály, terminál protokolování a interaktivní terminál.

Terminál protokolu – Terminál protokolu zobrazuje výstup sestavení, chybu sestavení a výsledky stahování.

Terminál protokolu VEX kódu VS se otevře a zobrazuje výchozí prázdný stav s pouze jednou vytištěnou zprávou s textem Log.

Interaktivní terminál - Interaktivní terminál má dvě funkce – zobrazení tiskových protokolů a odesílání nezpracovaných stisků kláves zpět do uživatelského programu.

: Pro použití interaktivního terminálu musí být k počítači s programem VEX VS Code Extension připojen mozek nebo ovladač.
Poznámka: Interaktivní výstup terminálu se po sestavení a stažení uživatelského programu standardně vymaže.

Panel nástrojů

Panel nástrojů obsahuje řadu ikon, které nám umožňují rychlý způsob interakce s rozšiřujícími projekty VEX VS Code, VEX Brains a VEX Controllers.

Panel nástrojů VS Code s ikonami rozšíření VEX, které lze použít k rychlé interakci s připojenými zařízeními a projekty VEX. Mezi funkce VEX patří Výběr zařízení, Výběr slotů, Ikona stahování Build & , Ikona přehrávání, Ikona zastavení, Výběr projektu a Výběr souborů Pythonu.

Poznámka: Panel nástrojů je aktivní pouze tehdy, když je ve VS Code otevřen platný projekt VEX.

Poznámka: Platný projekt VEX je projekt, který je vytvořen nebo importován rozšířením. Projekty VEXcode nebo VEXcode Pro otevřené v editoru nebudou považovány za platný projekt VEX a bude nutné je importovat.

Mezi ikony zobrazené na panelu nástrojů patří:

Výběr zařízení - Výběr zařízení zobrazuje ikonu připojeného zařízení VEX (ikonu mozku nebo ikonu řadiče )
Poznámka: Pokud je řadič připojen k počítači, ale nemá rádiové spojení s mozkem, vedle ikony řadiče se nezobrazí žádný název mozku.

Ikona výběru slotu - Ikona výběru slotu nám umožňuje vybrat, na kterém slotu rozšíření VEX stáhne nebo přehraje uživatelský program, kliknutím na něj a výběrem jednoho z osmi dostupných slotů na VEX Brainu ze seznamu.
Ikona stahování sestavení & - Pokud je připojeno zařízení VEX, zobrazí se na panelu nástrojů Ikona stahování. Po kliknutí se projekt sestaví a v případě úspěchu se stáhne do připojeného zařízení VEX.
Ikona přehrávání - Po kliknutí se na Ikona přehrávání spustí stažený uživatelský program ve vybraném slotu na VEX Brain.
Ikona zastavení - Po kliknutí se na ikonu Zastavení zastaví běh uživatelského programu na VEX Brain.
Výběr projektů - Výběr projektů zobrazuje název vybraného projektu. Ikona výběru projektu nám umožňuje přepínat mezi projekty VEX, pokud jich v pracovním prostoru existuje více, kliknutím na ni a výběrem projektu ze seznamu.
Výběr souborů Pythonu (pouze Python) – Po vybrání projektu VEX Pythonu se v panelu nástrojů zobrazí Výběr souborů Pythonu. Výběr souborů Pythonu zobrazuje název vybraného souboru Pythonu. Python pro VEX v současné době podporuje stahování pouze jednotlivých souborů.

Užitečné informace o tom, jak používat funkce panelu nástrojů ve VS Code, v tomto.

Uživatelská nastavení VEXu

Uživatelská nastavení VEX nám umožňují nakonfigurovat rozšíření VEX podle našich vlastních požadavků. Uživatelská nastavení jsou globální nastavení použitá pro každý projekt rozšíření VEX VS Code. K nastavení uživatele se dostaneme kliknutím na ikonu Nastavení ve VS Code a výběrem odpovídajících položek v nabídkách.

Nastavení uživatele VS Code se otevře v kategorii VEX, kde lze přizpůsobit chování rozšíření VEX Robotics.

Uživatelská nastavení VEX pro konfiguraci rozšíření VEX VS Code jsou:

Cesta k nástroji CPP – Nastavuje cestu pro nástroj CPP.
Povolit uživatelský terminál– Povolí nebo zakáže rozšíření otevírat a zobrazovat data z uživatelského portu.
Položky protokolu – Nastaví počet položek protokolu, které se mají nahrát z VEX Brain.
Typ sestavení projektu – Nastavuje, jak rozšíření sestaví projekt C++.
Domovská stránka projektu – Nastaví výchozí umístění pro nové projekty.
Spustit po stažení – Nastavuje, zda se má uživatelský program spustit po stažení do VEX Brain.
Automatická obnova systému DFU – Nastavuje, zda se má mozek automaticky obnovit, když je v režimu DFU detekován mozek IQ (2. generace) nebo EXP.
Povolit websocket server – Povolí nebo zakáže rozšíření pro spuštění websocket serveru.
Adresa hostitele websocket serveru – Nastavuje adresu hostitele websocket serveru.
Port websocket serveru – Nastaví číslo portu websocket serveru

Užitečné informace o tom, jak získat přístup k uživatelským nastavením VEX a jak je nastavit, v tomto.