Overzicht van de gebruikersinterface van VEX VS Code Extension – VEX-bibliotheek

Dit artikel biedt een overzicht van de VEX Visual Studio Code Extension UI (gebruikersinterface). De extensie ondersteunt de ontwikkeling van C++- en Python-projecten voor de platforms VEX IQ (2e generatie), EXP en V5.

VEX VS Code Extension UI-indeling

De gebruikersinterface van de VEX Visual Studio Code Extension is verdeeld in vijf hoofdgebieden: Activiteitenbalk, Zijbalk, Editor, Terminalpaneel en Werkbalk.

Schermafbeelding van de volledige VEX VS Code UI-indeling. De activiteitenbalk en de zijbalk bevinden zich aan de linkerkant van het scherm, de werkbalk en de terminal bevinden zich aan de onderkant van het scherm en de editor vult de rest van het scherm.

Activiteitenbalk

De activiteitenbalk bevat een reeks pictogrammen waarmee u kunt schakelen tussen weergaven. Ook krijgt u aanvullende contextspecifieke indicatoren voor de ontwikkeling van het VEX-project.

VS Code-activiteitenbalk met de VEX Robotics-extensie geïnstalleerd. De activiteitenbalk bevat pictogrammen waarmee u snel en eenvoudig handige acties kunt uitvoeren, zoals zoeken, extensies beheren, versiebeheer en meer.

De meest gebruikte pictogrammen voor het ontwikkelen van een VEX-project in VS Code zijn:

Explorer-weergavepictogram - Wanneer erop wordt geklikt, wordt de Explorer-weergave geopend in de zijbalk.
Extensieweergave-pictogram - Wanneer erop wordt geklikt, wordt de Extensieweergave geopend in de zijbalk.
VEX View-pictogram - Wanneer erop wordt geklikt, wordt de VEX View geopend in de zijbalk.

Zijbalk

De zijbalk bevat verschillende weergaven waarmee u de geïntegreerde hulpmiddelen in VS Code kunt gebruiken. De algemene zijbalkweergaven die worden gebruikt om taken voor VEX-projectontwikkeling uit te voeren, zijn Extensieweergave, VEX-weergaveen Verkennerweergave.

Uitbreidingsweergave

De Extension View wordt gebruikt om de extensies in VS Code te installeren en beheren. Voor het ontwikkelen van software op de platforms VEX IQ (2e generatie), EXP en V5 moeten we de VEX Extension, C/C++ Extension en Python Extension installeren.

Voor stapsgewijze instructies over het installeren van de VEX Extension, C/C++ Extensionen Python Extension in VS Code, u dit artikel

VS Code Extension View toont een lijst met geïnstalleerde extensies. Elke extensie heeft een instellingenmenu dat u hier kunt openen. Ook is er een zoekbalk waarmee u nieuwe extensies kunt zoeken en downloaden.

VEX-weergave

Met de VEX View kunnen we projecten ontwikkelen voor VEX IQ (2e generatie), EXP en V5 in VS Code. Er zijn drie categorieën opgenomen in de VEX-weergave: PROJECTACTIES, VEX-APPARAATINFO, en VEX-FEEDBACK.

VS Code VEX-weergave met opties voor het maken en importeren van projecten (boven), het menu VEX-apparaatinfo (onder) en een feedbackmenu (onder).

PROJECTACTIES
De knoppen onder PROJECTACTIES worden gebruikt om een nieuw VEX-project te maken of een bestaand VEXcode-project te importeren.
Voor gedetailleerde instructies over het maken van een VEX-project in VS Code, zie artikel voor V5 dit artikel voor EXPen dit artikel voor IQ (2e generatie)

Sectie Projectacties van de VEX Extension View. In deze sectie zijn twee knoppen te vinden: Nieuw project en Project importeren.

VEX DEVICE INFO
De categorie VEX DEVICE INFO geeft ons een overzicht van het aangesloten VEX-apparaat - een VEX Brain of een VEX Controller.

Deze categorie geeft het aangesloten VEX-apparaattype aan en geeft informatie weer over het Brain-systeem, de seriële poort, het gedownloade programma en de apparaten die zijn aangesloten op de slimme poorten van de VEX Brain. Hiermee kunnen we een screenshot maken van het VEX Brain-scherm, het VEX Brain-gebeurtenislogboek bekijken, de naam en het teamnummer
het brein instellen en het gebruikersprogramma uit het VEX Brain wissen.
Wanneer een VEX Brain is aangesloten op de computer, wordt in de categorie VEX DEVICE INFO aangegeven of de VEX Brain bijwerken als de VEXos-versie van de VEX Brain verouderd is.

Wanneer een VEX-controller is aangesloten op de computer, wordt in de categorie VEX DEVICE INFO weergegeven of er een VEX Brain is gekoppeld aan de VEX-controller. kunnen we de VEXos voor de VEX-controller bijwerken als de VEXos-versie van de VEX-controller verouderd is

Voor een uitgebreide beschrijving van de apparaatgegevens en hoe u de functies onder VEX-APPARAATINFOkunt gebruiken, raadpleegt u dit artikel.

VEX FEEDBACK
We kunnen feedback aan VEX sturen door het bericht in het tekstvak onder VEX FEEDBACK te typen en op de knop VERZENDEN te klikken.
Voor nuttige informatie over het gebruik van VEX FEEDBACK in VS Code, zie dit artikel.

VEX Feedback-sectie van de VEX Extension View. In deze sectie vindt u een formulier met opties voor het indienen van feedback bij VEX.

Explorer-weergave

De Explorer View wordt gebruikt om de VEX-projectbestanden en -mappen in VS Code te doorbladeren, openen en beheren.

VS Code Explorer-weergave waarmee de gebruiker door de mappen en bestanden in zijn VEX-project kan navigeren. De bestanden hebben bijbehorende pictogrammen en bestandstypen. In dit voorbeeld is een Python-bestand geselecteerd en luidt de titel main.py.

Editor

De Editor is het belangrijkste gebied voor het bewerken van bestanden in VS Code. De VEX VS Code-extensie maakt Intellisense/Linting mogelijk voor zowel C/C++ als Python in het Editor-gedeelte. Dit helpt ons bij de ontwikkeling van het programma.

VS Code Editor met een Python-bestand geopend als onderdeel van een VEX-project. Hier kan Python- of C/C++-code worden geschreven en bewerkt om VEX-roboticaprogramma's te maken wanneer deze is verbonden met een VEX Brain.

In het Editor-gedeelte kunt u nuttige informatie over een specifieke functie opvragen door de muis over de tekst van de functie te bewegen of door de VEX Command Help te gebruiken om toegang te krijgen tot de documentatie voor deze functie die is opgenomen in de C++ en Python API (Application Programming Interface).

Voor gedetailleerde instructies over het gebruik van de VEX Command Help in VS Code, zie dit artikel.

Aansluitpaneel

De VEX VS Code-extensie biedt bij het opstarten twee terminals: de Log Terminal en de Interactive Terminal.

Log Terminal - De Log Terminal geeft build-uitvoer, build-fouten en downloadresultaten weer.

De VS Code VEX Log Terminal wordt geopend en toont een standaard lege status met slechts één bericht: Log.

Interactieve terminal - De interactieve terminal heeft twee functies: het weergeven van afdruklogboeken en het terugsturen van onbewerkte toetsaanslagen naar een gebruikersprogramma.

Opmerking: Om de interactieve terminal te kunnen gebruiken, moet een Brain of Controller worden aangesloten op een computer waarop de VEX VS Code Extension draait.
Opmerking: De uitvoer van de interactieve terminal wordt standaard gewist nadat een gebruikersprogramma is gebouwd en gedownload.

Werkbalk

De werkbalk bevat een reeks pictogrammen waarmee u snel kunt communiceren met VEX VS Code-uitbreidingsprojecten, VEX Brains en VEX Controllers.

VS Code-werkbalk met VEX-extensiepictogrammen waarmee u snel kunt communiceren met aangesloten VEX-apparaten en projecten. De VEX-functies omvatten de apparaatkiezer, de slotkiezer, het pictogram Downloaden Build & , het pictogram Afspelen, het pictogram Stoppen, de projectkiezer en de Python-bestandskiezer.

Opmerking: De werkbalk is alleen actief wanneer er een geldig VEX-project is geopend in VS Code.

Opmerking: Een geldig VEX-project is een project dat door de extensie is gemaakt of geïmporteerd. VEXcode- of VEXcode Pro-projecten die in de editor worden geopend, worden niet beschouwd als geldige VEX-projecten en moeten worden geïmporteerd.

De pictogrammen op de werkbalk omvatten:

Apparaatkiezer - De apparaatkiezer geeft het pictogram van het aangesloten VEX-apparaat weer (een Brain-pictogram of een Controller-pictogram )
Opmerking: Als een controller is aangesloten op de computer, maar geen radioverbinding heeft met een brain, wordt er geen brainnaam weergegeven naast het Controller-pictogram.

Slot Selector Icon - Met het Slot Selector Icon kunnen we selecteren op welke Slot de VEX Extension een gebruikersprogramma zal downloaden of afspelen door erop te klikken en een van de acht beschikbare Slots op de VEX Brain te selecteren uit de keuzelijst.
Build & Downloadpictogram - Als een VEX-apparaat is aangesloten, wordt het Downloadpictogram weergegeven op de werkbalk. Wanneer u hierop klikt, wordt het project gebouwd en, indien succesvol, gedownload naar het aangesloten VEX-apparaat.
Afspeelpictogram - Wanneer erop wordt geklikt, start het Afspeelpictogram het gedownloade gebruikersprogramma in de geselecteerde sleuf op de VEX Brain.
Stoppictogram - Wanneer erop wordt geklikt, stopt het Stoppictogram de uitvoering van het gebruikersprogramma op de VEX Brain.
Projectkiezer - De Projectkiezer geeft de naam van het geselecteerde project weer. Met het projectselectiepictogram kunt u schakelen tussen VEX-projecten als er meerdere projecten in de werkruimte aanwezig zijn Klik hierop en selecteer een project uit de keuzelijst.
Python-bestandsselector (alleen Python) - Wanneer een VEX Python-project wordt geselecteerd, verschijnt de Python-bestandsselector in de werkbalk. De Python-bestandsselector geeft de naam van het geselecteerde Python-bestand weer. Python voor VEX ondersteunt momenteel alleen het downloaden van afzonderlijke bestanden.

Voor nuttige informatie over het gebruik van de Toolbar-functies in VS Code kunt u raadplegen.

VEX-gebruikersinstellingen

Met de VEX-gebruikersinstellingen kunnen we VEX Extension configureren volgens onze eigen vereisten. Gebruikersinstellingen zijn algemene instellingen die worden toegepast op elk VEX VS Code-extensieproject. We krijgen toegang tot de VEX-gebruikersinstellingen door op het instellingenpictogram in VS Code te klikken en de overeenkomstige items in de menu's te selecteren.

VS Code Gebruikersinstellingen wordt geopend in de VEX-categorie, waar het gedrag van de VEX Robotics Extension kan worden aangepast.

De VEX-gebruikersinstellingen voor het configureren van de VEX VS Code-extensie zijn:

Cpp Toolchain Pad - Stelt het pad voor de CPP Toolchain in.
Gebruikersterminalinschakelen: hiermee schakelt u de extensie in of uit om gegevens van de gebruikerspoort te openen en weer te geven.
Logboekvermeldingen - Stelt het aantal logboekvermeldingen in dat moet worden geüpload van een VEX Brain.
Project Build Type - Hiermee stelt u in hoe de extensie een C++-project bouwt.
Project Home - Stelt de standaardlocatie in voor nieuwe projecten.
Uitvoeren na downloaden - Hiermee wordt ingesteld of het gebruikersprogramma moet worden uitgevoerd nadat het is gedownload naar een VEX Brain.
Systeem DFU Automatisch Herstel - Hiermee stelt u in of de Brain automatisch moet herstellen wanneer een IQ (2e generatie) of EXP Brain wordt gedetecteerd in de DFU-modus.
Websocket Server Enable - Hiermee schakelt u de extensie voor het starten van de Websocket Server in of uit.
Websocket Server Host Address - Stelt het hostadres van de Websocket-server in.
Websocket-serverpoort - Stelt Websocket-serverpoortnummer in

dit artikelvoor nuttige informatie over het openen en instellen van de VEX-gebruikersinstellingen.