Översikt över VEX VS-kodtilläggets användargränssnitt – VEX bibliotek

Den här artikeln ger en översikt över VEX Visual Studio Code Extension UI (användargränssnitt). Tillägget stöder utveckling av C++- och Python-projekt för VEX IQ (2:a generationen), EXP och V5-plattformar.

VEX VS-kodtilläggets användargränssnittslayout

VEX Visual Studio Code Extension-gränssnittet är indelat i fem huvudområden: aktivitetsfält, sidofält, redigerare, terminalpanel och verktygsfält.

Skärmdump som visar den kompletta VEX VS Code UI-layouten. Aktivitetsfältet och sidofältet finns på vänster sida av skärmen, verktygsfältet och terminalen finns längst ner på skärmen och redigeraren fyller resten av skärmen.

Aktivitetsfält

Aktivitetsfältet har en rad ikoner som låter oss växla mellan vyer och ger oss ytterligare kontextspecifika indikatorer för VEX-projektets utveckling.

VS-kodaktivitetsfält med VEX Robotics-tillägget installerat. Aktivitetsfältet har ikoner som ger användbara snabba åtgärder, som att söka, hantera tillägg, versionshantering med mera.

De vanliga ikonerna som används för att utveckla ett VEX-projekt i VS Code är:

Ikon för Utforskarvy - När du klickar på den öppnas Utforskarvyn i sidofältet.
Ikon för tilläggsvy - När du klickar på den öppnas Tilläggsvyn i sidofältet.
VEX View-ikon - När du klickar på den öppnas VEX View i sidofältet.

Sidofält

Sidofältet innehåller olika vyer som gör det möjligt för oss att använda de integrerade verktygen i VS Code. De vanliga sidofältsvyerna som används för att utföra uppgifter för VEX-projektutveckling är Tilläggsvy, VEX-vyoch Utforskarvy.

Förlängningsvy

Tilläggsvy används för att installera och hantera tilläggen i VS Code. För att utveckla programvara på VEX IQ (2:a generationen), EXP och V5-plattformar behöver vi installera VEX Extension, C/C++ Extension och Python Extension.

För steg-för-steg-instruktioner om hur du installerar VEX-tillägget, C/C++-tilläggetoch Python-tillägget i VS Code, vänligen läs den här artikeln.

VS-kodtilläggsvy som visar en lista över installerade tillägg. Varje tillägg har en inställningsmeny som kan öppnas här, och det finns en sökfält för att hitta och ladda ner nya tillägg.

VEX-vy

VEX View gör det möjligt för oss att utveckla projekt för VEX IQ (2:a generationen), EXP och V5 i VS Code. Det finns tre kategorier i VEX-vyn: PROJEKTÅTGÄRDER, VEX-ENHETSINFO, och VEX-FEEDBACK.

VS Code VEX-vy som visar alternativ för att skapa och importera projekt ovan, VEX-enhetsinfomenyn nedan och en feedbackmeny längst ner.

PROJEKTÅTGÄRDER
Knapparna under PROJEKTÅTGÄRDER används för att skapa ett nytt VEX-projekt eller importera ett befintligt VEXcode-projekt.
För detaljerad vägledning om hur du skapar ett VEX-projekt i VS Code, se den här artikeln för V5, den här artikeln för EXPoch den här artikeln för IQ (2:a generationen).

Avsnittet Projektåtgärder i VEX-tilläggsvyn. Det här avsnittet har två knappar som läser Nytt projekt och Importera projekt.

VEX-ENHET INFO
Kategorin VEX-ENHET INFO ger oss en översikt över den anslutna VEX-enheten - en VEX Brain eller en VEX-styrenhet.

Denna kategori anger den anslutna VEX-enhetstypen och visar information om Brain-systemet, serieporten, nedladdat program och enheter anslutna till VEX Brains smarta portar. Det låter oss ta en skärmdump av VEX Brain-skärmen, visa VEX Brain-händelseloggen, ställa
hjärnans namn och teamnummer och radera användarprogrammet från VEX Brain.
När en VEX Brain är ansluten till datorn visar kategorin VEX DEVICE INFO om en VEX-styrenhet är länkad till VEX Brain och gör det möjligt för oss att uppdatera VEXos för VEX Brain om VEX Brains VEXos-version är föråldrad.

När en VEX-styrenhet är ansluten till datorn visar kategorin VEX DEVICE INFO om en VEX Brain är länkad till VEX-styrenheten och gör det möjligt för oss att uppdatera VEXos för VEX-styrenheten om VEX-styrenhetens VEXos-version är föråldrad.

För en omfattande beskrivning av enhetsinformationen och hur du använder funktionerna under VEX-ENHETSINFORMATION, vänligen läs den här artikeln.

VEX FEEDBACK
Vi kan skicka feedback till VEX genom att skriva meddelandet i textrutan under VEX FEEDBACK och klicka på knappen SKICKA
För användbar information om hur du använder VEX FEEDBACK i VS Code, vänligen se den här artikeln.

VEX-feedbacksektionen i VEX-utökningsvyn. Det här avsnittet har ett formulär med alternativ för att skicka feedback till VEX.

Utforskarvy

Utforskarvyn används för att bläddra bland, öppna och hantera VEX-projektfiler och -mappar i VS Code

VS Code Explorer-vy som låter användaren navigera bland mappar och filer i sitt VEX-projekt. Filerna har motsvarande ikoner och filtyper som visas, i det här exemplet är en Python-fil vald och titeln är main.py.

Redaktör

Redigeraren är det huvudsakliga området för att redigera filerna i VS Code. VEX VS Code Extension möjliggör Intellisense/Linting för både C/C++ och Python i editorområdet för att hjälpa oss under utvecklingen av programmet.

VS-kodredigerare med en Python-fil öppnad som en del av ett VEX-projekt. Python- eller C/C++-kod kan skrivas och redigeras här för att skapa VEX-robotprogram när de är anslutna till en VEX Brain.

I redigeringsområdet kan vi få tillgång till användbar information om en specifik funktion genom att hålla muspekaren över funktionens text eller genom att använda VEX-kommandohjälpen för att komma åt dokumentationen för den här funktionen som ingår i C++ och Python API (Application Programming Interface).

För detaljerade instruktioner om hur du använder VEX-kommandohjälpen i VS-kod, se den här artikeln.

Terminalpanel

VEX VS Code Extension tillhandahåller två terminaler vid start, loggterminalen och den interaktiva terminalen.

Loggterminal - Loggterminalen visar byggutdata, byggfel och nedladdningsresultat.

VS-kod VEX-loggterminalen öppnas och visar ett tomt standardläge med endast ett utskrivet meddelande som läser logg.

Interaktiv terminal - Den interaktiva terminalen har två funktioner - att visa utskriftsloggar och att skicka råa tangenttryckningar tillbaka till ett användarprogram.

Obs: För att använda den interaktiva terminalen måste en hjärna eller styrenhet vara ansluten till en dator som kör VEX VS-kodtillägget.
Obs: Interaktiv terminalutmatning rensas som standard efter att ett användarprogram har skapats och laddats ner.

Verktygsfält

Verktygsfältet innehåller en rad ikoner som ger oss ett snabbt sätt att interagera med VEX VS Code-tilläggsprojekt, VEX Brains och VEX Controllers.

VS Code-verktygsfält med VEX-tilläggsikoner som kan användas för att snabbt interagera med anslutna VEX-enheter och projekt. VEX-funktionerna inkluderar enhetsväljaren, platsväljaren, nedladdningsikonen för Bygg & , uppspelningsikonen, stoppikonen, projektväljaren och Python-filväljaren.

Obs: Verktygsfältet är endast aktivt när ett giltigt VEX-projekt är öppet i VS Code.

Obs: Ett giltigt VEX-projekt är ett projekt som skapas eller importeras av tillägget. VEXcode- eller VEXcode Pro-projekt som öppnas i redigeraren kommer inte att betraktas som ett giltigt VEX-projekt och måste importeras.

Ikonerna som visas i verktygsfältet inkluderar:

Enhetsväljare - Enhetsväljaren visar ikonen för den anslutna VEX-enheten (en hjärnikon eller en kontrollikon )
Obs: Om en kontrollenhet är ansluten till datorn men inte har en radiolänk till en hjärna visas inget hjärnnamn bredvid kontrollikonen.

Platsväljarikon - Platsväljarikonen låter oss välja vilken plats VEX-tillägget ska ladda ner eller spela upp ett användarprogram på genom att klicka på den och välja en av de åtta tillgängliga platserna på VEX-hjärnan från listan.
Bygg & Nedladdningsikon - Om en VEX-enhet är ansluten visas Nedladdningsikonen i verktygsfältet. När du klickar på den kommer projektet att byggas och om det lyckas laddas ner till den anslutna VEX-enheten.
Spela-ikon - När den klickas Spela-ikonen körs det nedladdade användarprogrammet i den valda platsen på VEX Brain.
Stoppikon - När den klickas Stoppikonen stoppar körningen av användarprogrammet på VEX Brain.
Projektväljare - Projektväljaren visar namnet på det valda projektet. Projektväljarikonen låter oss växla mellan VEX-projekt när det finns flera i arbetsytan genom att klicka på det och välja ett projekt från urvalslistan
Python-filväljare (endast Python) - När ett VEX Python-projekt väljs visas Python-filväljaren i verktygsfältet. Python-filväljaren visar namnet på den valda Python-filen. Python för VEX stöder för närvarande endast nedladdningar av enskilda filer.

För användbar information om hur du använder verktygsfältsfunktionerna i VS Code, vänligen läs den här artikeln.

VEX-användarinställningar

VEX användarinställningarna låter oss konfigurera VEX Extension enligt våra egna krav. Användarinställningar är globala inställningar som tillämpas på alla VEX VS Code-tilläggsprojekt. Vi kan komma åt VEX användarinställningar genom att klicka på inställningsikonen i VS Code och välja motsvarande alternativ i menyerna.

VS-kodens användarinställningar öppnas i VEX-kategorin där beteendet hos VEX Robotics Extension kan anpassas.

VEX-användarinställningarna för att konfigurera VEX VS-kodtillägget är:

Cpp-verktygskedjans sökväg - Anger sökvägen för CPP-verktygskedjan.
Aktivera användarterminal– Aktiverar eller inaktiverar tilläggets möjligheter att öppna och visa data från användarporten.
Loggposter – Anger antalet loggposter som ska laddas upp från en VEX Brain.
Projektbyggtyp – Anger hur tillägget ska bygga ett C++-projekt.
Projekt Startsida – Anger standardplatsen för nya projekt.
Kör efter nedladdning - Anger om användarprogrammet ska köras efter att det har laddats ner till en VEX Brain.
System DFU Autoåterställning - Ställer in om hjärnan ska återhämta sig automatiskt när en IQ-hjärna (2:a generationen) eller EXP-hjärna detekteras i DFU-läge.
Websocket Server Aktivera – Aktiverar eller inaktiverar tillägget för att starta Websocket Server.
Websocket-serverns värdadress – Anger värdadressen för Websocket-servern.
Websocket-serverport – Anger Websocket-serverportnummer

För användbar information om hur du kommer åt och ställer in VEX användarinställningar, läs den här artikeln.