VEX VS Code-extensie UI-overzicht

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

VEX VS Code-extensie UI-indeling

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

Activiteitenbalk

De activiteitenbalk bevat een reeks pictogrammen waarmee we tussen weergaven kunnen schakelen en die ons aanvullende contextspecifieke indicatoren geven voor de ontwikkeling van het VEX-project.

De gebruikelijke pictogrammen die worden gebruikt voor het ontwikkelen van een VEX-project in VS Code zijn:

• Pictogram Verkennerweergave - Wanneer erop wordt geklikt, wordt Verkennerweergave geopend in de zijbalk.
• Extensiesweergavepictogram - Wanneer erop wordt geklikt, wordt de Extensiesweergave 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 we de geïntegreerde tools binnen VS Code kunnen gebruiken. De gebruikelijke zijbalkweergaven die worden gebruikt om taken uit te voeren voor VEX-projectontwikkeling zijn Extensieweergave, VEX-weergaveen Verkennerweergave.

Extensieweergave

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

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

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 DEVICE INFO, en VEX FEEDBACK.

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

• 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 toont de informatie van het Brain-systeem, de seriële poort, het gedownloade programma en apparaten die zijn aangesloten op de slimme poorten van de VEX Brain. Hiermee kunnen we screenshot maken van het VEX Brain Screen, het VEX Brain Event Log bekijken, de V5 Battery Medic gebruiken, de hersennaam instellen en teamnummer, en het gebruikersprogramma van de VEX wissen Hersenen.
  
  Wanneer een VEX Brain op de computer is aangesloten, laat de categorie VEX DEVICE INFO zien of een VEX Controller is gekoppeld aan de VEX Brain en kunnen we de VEX Brain bijwerken als de VEXos-versie van de VEX Brain is verouderd.
  
  Wanneer een VEX-controller op de computer is aangesloten, wordt in de categorie VEX DEVICE INFO weergegeven of een VEX Brain is gekoppeld aan de VEX-controller en kunnen we de VEX-controller bijwerken als de VEXos-versie van de VEX-controller is verouderd.
  
  Voor een uitgebreide beschrijving van de apparaatinformatie en hoe u de functies onder VEX APPARAATINFOkunt gebruiken, kunt u dit artikel lezen.

• VEX FEEDBACK
  We kunnen feedback naar 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 de VEX FEEDBACK in VS Code, zie dit artikel.
  
  

Verkenner-weergave

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

Editor

De Editor is het belangrijkste gebied waarin u de bestanden in VS Code kunt bewerken. De VEX VS Code Extension maakt Intellisense/Linting voor zowel C/C++ als Python in het Editor-gebied mogelijk om ons te helpen bij het ontwikkelen van het programma.

In het Editor-gebied kunnen we nuttige informatie over een specifieke functie benaderen 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.

Terminalpaneel

De VEX VS Code Extension biedt twee terminals bij het opstarten, de Log Terminal en de Interactieve 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 printlogs en het terugsturen van ruwe toetsaanslagen naar een gebruikersprogramma.
  
  

  

  
  
  Opmerking: Om de interactieve terminal te gebruiken, moet een Brain of Controller zijn aangesloten op een computer waarop de VEX VS Code Extension draait.
  Opmerking: Interactieve terminaluitvoer wordt standaard gewist na het bouwen en downloaden van een gebruikersprogramma.

Werkbalk

De werkbalk bevat een reeks pictogrammen die ons een snelle manier bieden om te communiceren met VEX VS Code-uitbreidingsprojecten, VEX Brains en VEX Controllers.

Opmerking: De werkbalk is alleen actief als er een geldig VEX-project geopend is 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 als een geldig VEX-project beschouwd en moeten worden geïmporteerd.

De pictogrammen op de werkbalk zijn onder meer:

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

• Slot Selector Icoon - Met het Slot Selector Icoon kunnen we kiezen op welk Slot de VEX Extensie een gebruikersprogramma zal downloaden of afspelen door erop te klikken en een van de acht beschikbare Slots op de VEX Brain uit de keuzelijst te selecteren.
• Build-pictogram - Als er geen VEX-apparaat is aangesloten, wordt het Build-pictogram weergegeven op de werkbalk. Wanneer erop wordt geklikt, wordt het project alleen maar gebouwd.
• Downloadpictogram - Als er een VEX-apparaat is aangesloten, wordt het Downloadpictogram weergegeven op de werkbalk. Wanneer erop wordt geklikt, wordt het project gebouwd en, indien succesvol, gedownload naar het aangesloten VEX-apparaat.
• Speelpictogram - Wanneer erop wordt geklikt, voert het Speelpictogram het gedownloade gebruikersprogramma uit in het geselecteerde slot op de VEX Brain.
• Stoppictogram - Wanneer erop wordt geklikt, stopt het Stoppictogram met het uitvoeren van het gebruikersprogramma op de VEX Brain.
• Projectkiezer - De Projectkiezer geeft de naam van het geselecteerde project weer. Met het projectkiezerpictogram kunnen we schakelen tussen VEX-projecten als er meerdere in de werkruimte bestaan, door erop te klikken en een project uit de keuzelijst te selecteren.
• Python File Selector (alleen Python) - Wanneer een VEX Python-project is geselecteerd, verschijnt de Python File Selector in de werkbalk. De Python File Selector toont de naam van het geselecteerde Python-bestand. Python voor VEX ondersteunt momenteel alleen het downloaden van afzonderlijke bestanden.

Raadpleeg dit artikel voor nuttige informatie over het gebruik vanToolbar-functies in VS Code.

VEX-gebruikersinstellingen

Met de VEX-gebruikersinstellingen kunnen we de VEX Extensie configureren volgens onze eigen vereisten. Gebruikersinstellingen zijn algemene instellingen die worden toegepast op elk VEX VS Code-extensieproject. We hebben 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 het radiokanaal van de V5-controller in op Download of Pit. Deze instelling geldt alleen voor de VEXnet-radioverbinding.

• CPP Toolchain Path - Stelt het pad in voor de CPP Toolchain.
• Gebruikersterminalinschakelen - Schakelt de extensie in of uit om gegevens vanaf de gebruikerspoort te openen en weer te geven.
• Logboekinvoeren - Stelt het aantal loginvoeren in dat moet worden geüpload vanuit een VEX Brain.
• Projectbuildtype - Stelt in hoe de extensie een C++-project bouwt.
• Project Home - Stelt de standaardlocatie in voor nieuwe projecten.
• Uitvoeren na downloaden - Stelt in of het gebruikersprogramma moet worden uitgevoerd nadat het is gedownload naar een VEX Brain.
• Systeem DFU automatisch herstellen - Stelt in of de hersenen automatisch moeten herstellen wanneer een IQ2 of EXP wordt gedetecteerd in de DFU-modus.
• Websocket Server Enable - Schakelt de extensie voor het starten van de Websocket Server in of uit.
• Hostadres websocket-server - Stelt het hostadres van de websocket-server in.
• Websocket-serverpoort - Stelt het poortnummer van de websocket-server in

Raadpleeg dit artikel voor nuttige informatie over het openen en instellen vanVEX-gebruikersinstellingen.