Ez a cikk áttekintést nyújt a VEX Visual Studio Code Extension UI-ról (felhasználói felületről). A bővítmény támogatja a C++ és Python projektek fejlesztését VEX IQ 2nd Generation, EXP és V5 platformokhoz.

VEX VS Code Extension UI elrendezés

A VEX Visual Studio Code Extension UI öt fő területre oszlik: tevékenységsor, oldalsáv, szerkesztő, terminálpanel és eszköztár.

A teljes VEX VS Code felhasználói felület elrendezését bemutató képernyőkép. Az Aktivitássáv és az Oldalsáv a képernyő bal oldalán található, az Eszköztár és a Terminál a képernyő alsó részén, a szerkesztő pedig a képernyő többi részét kitölti.

Tevékenységsáv

Az Activity Bar egy sor ikont tartalmaz, amelyek segítségével válthatunk a nézetek között, és további kontextus-specifikus mutatókat ad a VEX projekt fejlesztéséhez.

VS Code aktivitássáv telepített VEX Robotics bővítménnyel. Az Aktivitássáv ikonjai hasznos gyorsműveleteket biztosítanak, például keresést, bővítmények kezelését, verziókövetést és egyebeket.

A VS Code-ban a VEX projekt fejlesztéséhez használt gyakori ikonok:

  • Böngésző nézet ikon. Intéző nézet ikon - Ha rákattint, a Explorer View megnyílik az oldalsávon.
  • Bővítmények nézet ikon. Bővítmények nézet ikonja - Ha rákattint, a Bővítmények nézet megnyílik az oldalsávban.
  • VEX nézet ikon. VEX View Icon - Ha rákattint, a VEX View megnyílik az oldalsávban.

Oldalsó sáv

Az oldalsáv különböző nézeteket tartalmaz, amelyek lehetővé teszik számunkra a VS Code integrált eszközeinek használatát. A VEX projektfejlesztési feladatok végrehajtására használt általános oldalsáv nézetek a következők: Extension View, VEX Viewés Explorer View.

Kiterjesztés nézet

A Extension View a VS Code bővítményeinek telepítésére és kezelésére szolgál. A VEX IQ 2nd Generation, EXP és V5 platformokon történő szoftverfejlesztéshez telepítenünk kell a VEX Extension, C/C++ Extension és Python bővítményt.

A VEX Extension, C/C++ Extensionés Python Extension VS Code-ban történő telepítéséhez lépésről lépésre vonatkozó utasításokért tekintse meg ezt a cikket.

VS Code bővítménynézet, amely a telepített bővítmények listáját jeleníti meg. Minden bővítményhez tartozik egy beállítások menü, amely itt nyitható meg, és van egy keresősáv az új bővítmények kereséséhez és letöltéséhez.


VEX nézet

A VEX View lehetővé teszi számunkra, hogy projekteket fejlesszünk a VEX IQ 2nd Generation, EXP és V5 számára VS Code-ban. A VEX View három kategóriát tartalmaz: PROJEKT MŰVELETEK, VEX ESZKÖZINFORMÁCIÓ, és VEX VISSZAJELZÉS.

VS Code VEX nézet, amely fent a projektek létrehozásának és importálásának lehetőségeit, alul a VEX eszközinformációk menüjét, alul pedig egy visszajelzési menüt jeleníti meg.

  • PROJEKTMŰVELETEK
    A PROJEKTMŰVELETEK alatti gombok új VEX projekt létrehozására vagy meglévő VEXcode projekt importálására szolgálnak.
    A VEX-projektek VS Code-ban történő létrehozásával kapcsolatos részletes útmutatásért tekintse meg ezt a cikket a V5, ezt a cikket az EXPhez és ezt a cikket az IQ (2.).

A VEX bővítménynézet Projektműveletek része. Ebben a részben két gomb található: Új projekt és Projekt importálása.

  • VEX ESZKÖZINFORMÁCIÓK
    A VEX ESZKÖZINFORMÁCIÓK kategória áttekintést nyújt a csatlakoztatott VEX eszközről – egy VEX Brainről vagy egy VEX vezérlőről.

    VEX Device Info section of the VEX Extension View is shown, with a list of all connected devices and specific info about each one. In this example, an IQ (2nd gen) Brain and its downloaded programs are shown.


    Ez a kategória jelzi a csatlakoztatott VEX eszköz típusát, és megjeleníti a Brain rendszer, a soros port, a letöltött program és a VEX Brain intelligens portjaihoz csatlakoztatott eszközök információit. Lehetővé teszi számunkra, hogy képernyőképet készítsünk a VEX Brainképernyőről, megtekintsük a VEX Brain eseménynaplót, használjuk a V5 Battery Medic, állítsuk be az agy nevét és acsapatszámot, és töröljük a felhasználói programot a VEX-ből. Agy.

    Ha egy VEX Brain csatlakozik a számítógéphez, a VEX DEVICE INFO kategória megmutatja, hogy egy VEX vezérlő kapcsolódik-e a VEX Brainhez, és lehetővé teszi a VEXos frissítését a VEX Brain számára, ha a VEX Brain VEXos verziója elavult.

    Ha egy VEX vezérlő csatlakozik a számítógéphez, a VEX DEVICE INFO kategória megmutatja, hogy egy VEX Brain kapcsolódik-e a VEX vezérlőhöz, és lehetővé teszi a VEXos frissítését a VEX vezérlőhöz, ha a VEX Controller VEXos verziója elavult.

    Az eszközinformációk átfogó leírásáért és a VEX ESZKÖZINFORMÁCIÓalatti funkciók használatáért tekintse meg ezt a cikket.
  • VEX VISSZAJELZÉS
    Visszajelzést küldhetünk a VEX-nek, ha beírjuk az üzenetet az VEX FEEDBACK alatti Szövegdobozba, majd a KÜLDÉS gombra kattintunk.
    A VEX FEEDBACK VS Code-ban történő használatával kapcsolatos hasznos információkért tekintse meg ezt a cikket.

A VEX bővítménynézet VEX visszajelzés része. Ebben a részben található egy űrlap, amelyen keresztül visszajelzést küldhet a VEX-nek.

Explorer nézet

A Explorer View a VS Code-ban található VEX projektfájlok és mappák böngészésére, megnyitására és kezelésére szolgál.

VS Code Explorer nézet, amely lehetővé teszi a felhasználó számára a VEX projektben található mappák és fájlok közötti navigálást. A fájlokhoz tartozó ikonok és fájltípusok láthatók, ebben a példában egy Python fájl van kiválasztva, és a címe main.py.

Szerkesztő

A Szerkesztő a fő terület a VS Code fájlok szerkesztéséhez. A VEX VS Code Extension lehetővé teszi az Intellisense/Linting alkalmazást C/C++ és Python számára a Szerkesztő területen, hogy segítsen nekünk a program fejlesztésében.

VS Code Editor egy VEX projekt részeként megnyitott Python fájllal. Python vagy C/C++ kód írható és szerkeszthető itt VEX robotikai programok létrehozásához, ha egy VEX Brainhez csatlakoztatjuk.

A Szerkesztő területen egy adott funkcióval kapcsolatos hasznos információkat érhetünk el, ha az egeret a függvény szövege fölé viszjük, vagy a VEX Command Help segítségével elérjük a C++ és Python API-ban (Application Programming Interface) található funkció dokumentációját. ).

A VEX Command Help VS Code-ban történő használatára vonatkozó részletes utasításokért lásd ezt a cikket.

Terminál panel

A VEX VS Code Extension két terminált biztosít indításkor, a naplóterminált és az interaktív terminált. 

  • naplóterminál – A naplóterminál megjeleníti az összeállítás kimenetét, az összeállítási hibát és a letöltési eredményeket.

A VS Code VEX naplóterminál megnyílik, és alapértelmezett üres állapotot mutat, csak egy üzenettel a Napló olvasása mellett.

  • Interaktív terminál - Az interaktív terminálnak két funkciója van: nyomtatási naplók megjelenítése és nyers billentyűleütések küldése vissza egy felhasználói programnak.

    VS Code VEX Interactive Terminal is opened and shows messages that detail the VEX Brain connection status.



    Megjegyzés: Az interaktív terminál használatához egy agyat vagy vezérlőt kell csatlakoztatni egy VEX VS Code Extension programot futtató számítógéphez.
    Megjegyzés: Az interaktív terminál kimenete alapértelmezés szerint törlődik a felhasználói program felépítése és letöltése után.

Eszköztár

Az Eszköztár egy sor ikont tartalmaz, amelyek segítségével gyorsan kommunikálhatunk a VEX VS Code kiterjesztési projektekkel, a VEX Brains-szel és a VEX vezérlőkkel.

VS Code eszköztár VEX bővítmény ikonokkal, amelyek segítségével gyorsan kommunikálhat a csatlakoztatott VEX eszközökkel és projektekkel. A VEX funkciói közé tartozik az Eszközválasztó, a Helyválasztó, a Build & letöltése ikon, a Lejátszás ikon, a Leállítás ikon, a Projektválasztó és a Python fájlválasztó.

Megjegyzés: Az Eszköztár csak akkor aktív, ha egy érvényes VEX projekt meg van nyitva a VS Code-ban. 

Megjegyzés: Az érvényes VEX projekt olyan projekt, amelyet a bővítmény hozott létre vagy importált. A szerkesztőben megnyitott VEXcode vagy VEXcode Pro projektek nem minősülnek érvényes VEX projektnek, és importálni kell őket.

Az Eszköztáron megjelenő ikonok a következők:

  • Az eszközválasztó ikon megjelenik a VS Code eszköztárán. Eszközválasztó - Az Eszközválasztó megjeleníti a csatlakoztatott VEX eszköz ikonját (egy Agy ikont Device Picker icon is highlighted on the VS Code toolbar. In this example it shows a Brain icon and it reads IQ Brain(IQ). vagy egy Vezérlő ikont Device Picker icon is highlighted on the VS Code toolbar. In this example it shows a Controller icon and it reads IQ Controller.)
    Megjegyzés: Ha egy vezérlő csatlakozik a számítógéphez, de nincs rádiókapcsolata az aggyal, akkor az agy neve nem jelenik meg a Vezérlő ikonja mellett.
  • Helyválasztó ikon. Slot Selector Icon – A Slot Selector Icon lehetővé teszi számunkra, hogy kiválasszuk, hogy a VEX Extension melyik Slot-ot töltse le vagy játssza le a felhasználói programot, ha rákattint, és kiválasztja a VEX Brain nyolc elérhető slotja közül egyet a listából.
  • Építés és letöltés ikon. Build & Letöltés ikon - Ha VEX eszköz van csatlakoztatva, a Letöltés ikon megjelenik az Eszköztáron. Ha rákattint, a projekt létrejön, és ha sikeres, letöltődik a csatlakoztatott VEX-eszközre.
  • Lejátszás ikon. Play Icon - Ha rákattint, a Play Icon futtatja a letöltött felhasználói programot a VEX Brain kiválasztott Slotjában.
  • Leállítás ikon. Leállítás ikon - Ha rákattint, a Stop Ikon leállítja a felhasználói program futtatását a VEX Brainben.
  • A Projektválasztó a VS Code eszköztáron látható. Ebben a példában IQ_Test-ként jelenik meg. Project Selector - A Project Selector megjeleníti a kiválasztott projekt nevét. A Project Selector Icon lehetővé teszi számunkra, hogy váltsunk a VEX projektek között, ha több is létezik a munkaterületen belül, ha rákattintunk, és kiválasztunk egy projektet a listából.
  • A Python fájlválasztó ikonja megjelenik a VS Code eszköztáron. Ebben a példában ez a main.py fájlt jelenti. Python File Selector (csak Python) - Ha egy VEX Python projekt van kiválasztva, a Python File Selector megjelenik az eszköztáron. A Python File Selector megjeleníti a kiválasztott Python fájl nevét. A Python for VEX jelenleg csak egyetlen fájl letöltését támogatja.

A VS Code eszköztár funkcióinak használatával kapcsolatos hasznos információkért tekintse meg ezt a cikket.

VEX felhasználói beállítások

A VEX felhasználói beállítások lehetővé teszik a VEX Extension konfigurálását saját igényeink szerint. A felhasználói beállítások globális beállítások, amelyeket minden VEX VS Code kiterjesztési projektre alkalmaznak. A VEX User Settings úgy érhetjük el, hogy a VS Code-ban a Beállítások ikonra kattintunk és a menükben kiválasztjuk a megfelelő elemeket.

A VS Code felhasználói beállításai a VEX kategóriában nyílnak meg, ahol a VEX robotikai bővítmény viselkedése testreszabható.

A VEX VS kódbővítmény konfigurálásához szükséges VEX felhasználói beállítások a következők:

  • Vezérlő csatorna (csak V5 vezérlő) – A V5 vezérlő rádiócsatornáját -re állítja Letöltés vagy Pit. Ez a beállítás csak a VEXnet rádiókapcsolatra vonatkozik.
  • Cpp Toolchain Path – Beállítja a CPP Toolchain elérési útját.
  • felhasználói terminál engedélyezése – Engedélyezi vagy letiltja a bővítményt, hogy megnyissa és megjelenítse az adatokat a felhasználói portról.
  • Naplóbejegyzések - Beállítja a VEX Brain-ből feltöltendő naplóbejegyzések számát.
  • Project Build Type – Beállítja, hogy a bővítmény hogyan építsen fel egy C++ projektet.
  • Projekt kezdőlapja – Beállítja az új projektek alapértelmezett helyét.
  • Futtatás letöltés után – Beállítja, hogy a felhasználói program lefusson-e, miután letöltötte a VEX Brainre.
  • Rendszer DFU automatikus helyreállítás – Beállítja, hogy az agy automatikusan helyreálljon-e, ha DFU módban IQ2 vagy EXP észlelhető.
  • Websocket Server engedélyezése – Engedélyezi vagy letiltja a bővítményt a Websocket Server elindításához.
  • Websocket Server Host Address – Beállítja a Websocket szerver gazdagép címét.
  • Websocket kiszolgáló portja – Beállítja a Websocket szerver portszámát

A VEX felhasználói beállítások elérésével és beállításával kapcsolatos hasznos információkért tekintse meg ezt a cikket.

For more information, help, and tips, check out the many resources at VEX Professional Development Plus

Last Updated: