Dieser Artikel bietet einen Überblick über die VEX Visual Studio Code Extension UI (Benutzeroberfläche). Die Erweiterung unterstützt die Entwicklung von C++- und Python-Projekten für die Plattformen VEX IQ 2nd Generation, EXP und V5.
UI-Layout der VEX VS Code-Erweiterung
Die Benutzeroberfläche der VEX Visual Studio Code Extension ist in fünf Hauptbereiche unterteilt: Aktivitätsleiste, Seitenleiste, Editor, Terminalbereich und Symbolleiste.
Aktivitätsleiste
Die Aktivitätsleiste verfügt über eine Reihe von Symbolen, mit denen wir zwischen den Ansichten wechseln können und die uns zusätzliche kontextspezifische Indikatoren für die VEX-Projektentwicklung liefern.
Die häufigsten Symbole, die für die Entwicklung eines VEX-Projekts in VS Code verwendet werden, sind:
-
Explorer-Ansichtssymbol - Wenn Sie darauf klicken, wird die Explorer-Ansicht in der Seitenleiste geöffnet.
-
Erweiterungsansichtssymbol - Wenn Sie darauf klicken, wird die Erweiterungsansicht in der Seitenleiste geöffnet.
-
VEX-Ansichtssymbol - Wenn Sie darauf klicken, wird die VEX-Ansicht in der Seitenleiste geöffnet.
Seitenleiste
Die Seitenleiste enthält verschiedene Ansichten, die es uns ermöglichen, die integrierten Tools in VS Code zu verwenden. Die üblichen Seitenleistenansichten, die zum Ausführen von Aufgaben für die VEX-Projektentwicklung verwendet werden, sind Erweiterungsansicht, VEX-Ansichtund Explorer-Ansicht.
Erweiterungsansicht
Die Extension View wird zum Installieren und Verwalten der Erweiterungen in VS Code verwendet. Für die Entwicklung von Software auf VEX IQ 2nd Generation-, EXP- und V5-Plattformen müssen wir die VEX-Erweiterung, die C/C++-Erweiterung und die Python-Erweiterung installieren.
Schritt-für-Schritt-Anleitungen zur Installation der VEX-Erweiterung, C/C++-Erweiterungund Python-Erweiterung in VS Code finden Sie in diesem Artikel.
VEX-Ansicht
Mit VEX View können wir Projekte für VEX IQ 2nd Generation, EXP und V5 in VS Code entwickeln. In der VEX-Ansicht sind drei Kategorien enthalten: PROJEKTAKTIONEN, VEX-GERÄTEINFORMATIONEN, und VEX-FEEDBACK.
-
PROJEKTAKTIONEN
Die Schaltflächen unter PROJEKTAKTIONEN werden verwendet, um ein neues VEX-Projekt zu erstellen oder ein vorhandenes VEXcode-Projekt zu importieren.
Ausführliche Anleitungen zum Erstellen eines VEX-Projekts in VS Code finden Sie in diesem Artikel für V5, in diesem Artikel für EXPund in diesem Artikel für IQ (2nd).
-
VEX-GERÄTEINFORMATIONEN
Die Kategorie VEX-GERÄTEINFORMATIONEN bietet uns einen Überblick über das angeschlossene VEX-Gerät – ein VEX-Gehirn oder einen VEX-Controller.
Diese Kategorie gibt den Typ des angeschlossenen VEX-Geräts an und zeigt Informationen zum Brain-System, zur seriellen Schnittstelle, zum heruntergeladenen Programm und zu den Geräten an, die mit den Smart-Ports des VEX Brain verbunden sind. Es ermöglicht uns, einen Screenshot des VEX-Brain-Bildschirms zu erstellen,, das VEX-Brain-Ereignisprotokoll anzuzeigen,, den V5-Batterie-Mediziner zu verwenden,, den Gehirnnamen festzulegen und die Teamnummer festzulegen,und das Benutzerprogramm aus dem VEX zu löschen Gehirn.
Wenn ein VEX Brain mit dem Computer verbunden ist, zeigt die Kategorie VEX-GERÄTEINFO an, ob ein VEX-Controller mit dem VEX Brain verbunden ist, und ermöglicht uns, das VEXos für das VEX Brain zu aktualisieren, wenn die VEXos-Version des VEX Brain vorhanden ist veraltet.
Wenn ein VEX-Controller an den Computer angeschlossen ist, zeigt die Kategorie VEX-GERÄTEINFO an, ob ein VEX Brain mit dem VEX-Controller verbunden ist, und ermöglicht uns, das VEXos für den VEX-Controller zu aktualisieren, wenn die VEXos-Version des VEX-Controllers vorhanden ist veraltet.
Eine umfassende Beschreibung der Geräteinformationen und der Verwendung der Funktionen unter VEX-GERÄTEINFORMATIONENfinden Sie in diesem Artikel.
-
VEX-FEEDBACK
Wir können Feedback an VEX übermitteln, indem wir die Nachricht in das Textfeld unter VEX-FEEDBACK eingeben und auf die Schaltfläche SENDEN klicken.
Hilfreiche Informationen zur Verwendung von VEX FEEDBACK in VS-Code finden Sie in diesem Artikel.
Explorer-Ansicht
Die Explorer-Ansicht wird zum Durchsuchen, Öffnen und Verwalten der VEX-Projektdateien und -Ordner in VS Code verwendet.
Editor
Der Editor ist der Hauptbereich zum Bearbeiten der Dateien in VS Code. Die VEX VS Code Extension ermöglicht Intellisense/Linting sowohl für C/C++ als auch Python im Editor-Bereich, um uns bei der Entwicklung des Programms zu unterstützen.
Im Editorbereich können wir auf hilfreiche Informationen zu einer bestimmten Funktion zugreifen, indem wir mit der Maus über den Text der Funktion fahren oder die VEX-Befehlshilfe verwenden, um auf die Dokumentation für diese Funktion zuzugreifen, die in der C++- und Python-API (Application Programming Interface) enthalten ist ).
Ausführliche Anweisungen zur Verwendung der VEX-Befehlshilfe in VS-Code finden Sie in diesem Artikel.
Anschlussfeld
Die VEX VS Code Extension stellt beim Start zwei Terminals bereit, das Log Terminal und das Interactive Terminal.
-
Protokollterminal – Das Protokollterminal zeigt Build-Ausgabe, Build-Fehler und Download-Ergebnisse an.
-
Interaktives Terminal - Das interaktive Terminal hat zwei Funktionen – das Anzeigen von Druckprotokollen und das Zurücksenden roher Tastenanschläge an ein Benutzerprogramm.
Hinweis: Um das interaktive Terminal nutzen zu können, muss ein Brain oder Controller an einen Computer angeschlossen sein, auf dem die VEX VS Code Extension ausgeführt wird.
Hinweis: Die interaktive Terminalausgabe wird nach dem Erstellen und Herunterladen eines Benutzerprogramms standardmäßig gelöscht.
Symbolleiste
Die Symbolleiste verfügt über eine Reihe von Symbolen, die uns eine schnelle Möglichkeit bieten, mit VEX VS Code-Erweiterungsprojekten, VEX Brains und VEX Controllern zu interagieren.
Hinweis: Die Symbolleiste ist nur aktiv, wenn ein gültiges VEX-Projekt in VS Code geöffnet ist.
Hinweis: Ein gültiges VEX-Projekt ist ein Projekt, das von der Erweiterung erstellt oder importiert wird. Im Editor geöffnete VEXcode- oder VEXcode Pro-Projekte gelten nicht als gültiges VEX-Projekt und müssen importiert werden.
Zu den Symbolen in der Symbolleiste gehören:
-
Geräteauswahl - Die Geräteauswahl zeigt das Symbol des verbundenen VEX-Geräts an (ein Brain-Symbol
oder ein Controller-Symbol
)
Hinweis: Wenn ein Controller mit dem Computer verbunden ist, aber keine Funkverbindung zu einem hat Gehirn wird neben dem Controller-Symbol kein Gehirnname angezeigt.
-
Slot-Auswahlsymbol – Mit dem Slot-Auswahlsymbol können wir auswählen, welchen Slot die VEX-Erweiterung herunterlädt oder auf dem ein Benutzerprogramm abgespielt wird, indem wir darauf klicken und einen der acht verfügbaren Slots auf dem VEX Brain aus der Auswahlliste auswählen.
-
Build-Symbol – Wenn kein VEX-Gerät angeschlossen ist, wird das Build-Symbol in der Symbolleiste angezeigt. Wenn Sie darauf klicken, wird das Projekt nur erstellt.
-
Download-Symbol – Wenn ein VEX-Gerät angeschlossen ist, wird das Download-Symbol in der Symbolleiste angezeigt. Wenn Sie darauf klicken, wird das Projekt erstellt und bei Erfolg auf das verbundene VEX-Gerät heruntergeladen.
-
Play-Symbol – Wenn Sie darauf klicken, führt das Play-Symbol das heruntergeladene Benutzerprogramm im ausgewählten Slot auf dem VEX Brain aus.
-
Stoppsymbol – Wenn Sie darauf klicken, stoppt das Stoppsymbol die Ausführung des Benutzerprogramms auf dem VEX Brain.
-
Projektauswahl - Die Projektauswahl zeigt den Namen des ausgewählten Projekts an. Mit dem Projektauswahlsymbol können wir zwischen VEX-Projekten wechseln, wenn mehrere im Arbeitsbereich vorhanden sind, indem wir darauf klicken und ein Projekt aus der Auswahlliste auswählen.
-
Python-Dateiauswahl (nur Python) – Wenn ein VEX-Python-Projekt ausgewählt ist, erscheint die Python-Dateiauswahl in der Symbolleiste. Der Python File Selector zeigt den Namen der ausgewählten Python-Datei an. Python für VEX unterstützt derzeit nur das Herunterladen einzelner Dateien.
Hilfreiche Informationen zur Verwendung der Symbolleistenfunktionen in VS Code finden Sie
VEX-Benutzereinstellungen
Die VEX-Benutzereinstellungen ermöglichen es uns, die VEX-Erweiterung nach unseren eigenen Anforderungen zu konfigurieren. Benutzereinstellungen sind globale Einstellungen, die auf jedes VEX VS Code-Erweiterungsprojekt angewendet werden. Wir können auf die VEX-Benutzereinstellungen zugreifen, indem wir in VS Code auf das Einstellungssymbol klicken und die entsprechenden Elemente in den Menüs auswählen.
Die VEX-Benutzereinstellungen zum Konfigurieren der VEX-VS-Code-Erweiterung sind:
- Controller-Kanal (nur V5-Controller) – Stellt den Funkkanal des V5-Controllers auf ein. Download oder Pit. Diese Einstellung gilt nur für die VEXnet-Funkverbindung.
- Cpp Toolchain Path – Legt den Pfad für die CPP Toolchain fest.
- Benutzerterminalaktivieren – Aktiviert oder deaktiviert die Erweiterung zum Öffnen und Anzeigen von Daten vom Benutzerport.
- Protokolleinträge – Legt die Anzahl der Protokolleinträge fest, die von einem VEX Brain hochgeladen werden sollen.
- Projekterstellungstyp – Legt fest, wie die Erweiterung ein C++-Projekt erstellt.
- Projekt-Startseite – Legt den Standardspeicherort für neue Projekte fest.
- Nach Download ausführen – Legt fest, ob das Benutzerprogramm ausgeführt werden soll, nachdem es auf ein VEX Brain heruntergeladen wurde.
- System DFU Auto Recover – Legt fest, ob das Gehirn automatisch wiederhergestellt werden soll, wenn im DFU-Modus ein IQ2 oder EXP erkannt wird.
- Websocket-Server aktivieren – Aktiviert oder deaktiviert die Erweiterung zum Starten des Websocket-Servers.
- Websocket-Server-Hostadresse – Legt die Hostadresse des Websocket-Servers fest.
- Websocket-Server-Port – Legt die Websocket-Server-Portnummer fest