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 VEX IQ 2nd Generation-, EXP- en V5-platformen.
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.
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.
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 VEX IQ 2nd Generation-, EXP- en V5-platforms 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
VEX-weergave
Met de VEX View kunnen we projecten ontwikkelen voor VEX IQ 2nd Generation, EXP en V5 in VS Code. Er zijn drie categorieën opgenomen in de VEX-weergave: PROJECTACTIES, VEX-APPARAATINFO, en VEX-FEEDBACK.
-
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 (2nd)
-
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 screenshots maken van het VEX Brain-scherm, het VEX Brain-gebeurtenislogboek bekijken, de V5-batterijmedicijn gebruiken, de naam van het brein instellen en het teamnummer, en het gebruikersprogramma van 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.
Explorer-weergave
De Explorer View wordt gebruikt om de VEX-projectbestanden en -mappen in VS Code te doorbladeren, openen en beheren.
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.
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.
-
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.
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.
De VEX-gebruikersinstellingen voor het configureren van de VEX VS Code-extensie zijn:
- Controllerkanaal (alleen V5-controller) - Stelt V5-controllerradiokanaal in op Download of Pit. Deze instelling is alleen van toepassing op de VEXnet-radioverbinding.
- 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 hersenen automatisch moeten herstellen wanneer een IQ2 of EXP 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.