Übersicht über die VEX VS Code-Erweiterungs-Benutzeroberfläche – VEX-Bibliothek

Dieser Artikel bietet einen Überblick über die Benutzeroberfläche (UI) der VEX Visual Studio Code Extension. Die Erweiterung unterstützt die Entwicklung von C++- und Python-Projekten für die Plattformen VEX IQ 2nd Generation, EXP und V5.

VEX VS Code-Erweiterung UI-Layout

Die Benutzeroberfläche der VEX Visual Studio Code Extension ist in fünf Hauptbereiche unterteilt: Aktivitätsleiste, Seitenleiste, Editor, Terminalbereich und Symbolleiste.

Screenshot, der das vollständige VEX VS Code UI-Layout zeigt. Die Aktivitätsleiste und die Seitenleiste befinden sich auf der linken Seite des Bildschirms, die Symbolleiste und das Terminal befinden sich auf der unteren Seite des Bildschirms, und der Editor füllt den restlichen Bildschirm aus.

Aktivitätsleiste

Die Aktivitätsleiste verfügt über eine Reihe von Symbolen, mit denen wir zwischen Ansichten wechseln können und die uns zusätzliche kontextspezifische Indikatoren für die VEX-Projektentwicklung bieten.

VS Code-Aktivitätsleiste mit installierter VEX Robotics-Erweiterung. Die Aktivitätsleiste enthält Symbole, die nützliche Schnellaktionen ermöglichen, wie z. B. Suchen, Verwalten von Erweiterungen, Versionskontrolle und mehr.

Die folgenden allgemeinen Symbole werden für die Entwicklung eines VEX-Projekts in VS Code verwendet:

Explorer-Ansicht-Symbol – Beim Klicken wird die Explorer-Ansicht in der Seitenleiste geöffnet.
Erweiterungsansicht-Symbol – Beim Klicken wird die Erweiterungsansicht in der Seitenleiste geöffnet.
VEX-Ansichtssymbol – Beim 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 allgemeinen 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-Plattformen der 2. Generation, EXP und V5 müssen wir die VEX-Erweiterung, die C/C++-Erweiterung und die Python-Erweiterung installieren.

Eine Schritt-für-Schritt-Anleitung zur Installation der VEX-Erweiterung, C/C++-Erweiterungund Python-Erweiterung in VS Code finden Sie in diesem Artikel.

VS Code-Erweiterungsansicht, die eine Liste der installierten Erweiterungen anzeigt. Jede Erweiterung verfügt über ein Einstellungsmenü, das hier geöffnet werden kann, und es gibt eine Suchleiste zum Finden und Herunterladen neuer Erweiterungen.

VEX-Ansicht

Mit VEX View können wir Projekte für VEX IQ 2. Generation, EXP und V5 in VS Code entwickeln. Die VEX-Ansicht umfasst drei Kategorien: „PROJEKTAKTIONEN“, VEX-GERÄTEINFO, und „VEX-FEEDBACK“.

Die VS Code VEX-Ansicht zeigt oben Optionen zum Erstellen und Importieren von Projekten, unten das Menü „VEX-Geräteinformationen“ und ganz unten ein Feedback-Menü.

PROJEKTAKTIONEN
Die Schaltflächen unter PROJEKTAKTIONEN werden verwendet, um ein neues VEX-Projekt zu erstellen oder ein vorhandenes VEXcode-Projekt zu importieren.
Detaillierte 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 (2.).

Abschnitt „Projektaktionen“ der VEX-Erweiterungsansicht. Dieser Abschnitt enthält zwei Schaltflächen mit der Bezeichnung „Neues Projekt“ und „Projekt importieren“.

VEX-GERÄTEINFORMATIONEN
Die Kategorie VEX-GERÄTEINFORMATIONEN bietet uns eine Übersicht über das angeschlossene VEX-Gerät – ein VEX Brain oder einen VEX Controller.

Diese Kategorie gibt den Typ des angeschlossenen VEX-Geräts an und zeigt Informationen zum Brain-System, zum seriellen Port, zum heruntergeladenen Programm und zu den an die Smart Ports des VEX Brain angeschlossenen Geräten an. Damit können wir einen Screenshot des VEX Brain-Bildschirmsmachen, das VEX Brain-Ereignisprotokoll anzeigen, den V5 Battery Medic verwenden, den Brain-Namen und die Teamnummerfestlegen und das Benutzerprogramm vom VEX Brain löschen

Wenn ein VEX Brain mit dem Computer verbunden ist, zeigt die Kategorie VEX DEVICE INFO 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 veraltet ist.

Wenn ein VEX Controller mit dem Computer verbunden ist, zeigt die Kategorie VEX DEVICE INFO 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 veraltet ist.

Eine umfassende Beschreibung der Geräteinformationen und der Verwendung der Funktionen unter VEX-GERÄTEINFOfinden Sie in diesem Artikel.

VEX-FEEDBACK
Wir können Feedback an VEX senden, 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.

VEX-Feedback-Bereich der VEX-Erweiterungsansicht. Dieser Abschnitt enthält ein Formular mit Optionen zur Übermittlung von Feedback an VEX.

Explorer-Ansicht

Die Explorer-Ansicht wird zum Durchsuchen, Öffnen und Verwalten der VEX-Projektdateien und -ordner in VS Code verwendet.

VS Code Explorer-Ansicht, die es dem Benutzer ermöglicht, durch die Ordner und Dateien in seinem VEX-Projekt zu navigieren. Die Dateien sind mit entsprechenden Symbolen und Dateitypen versehen; in diesem Beispiel ist eine Python-Datei ausgewählt, deren Titel main.py lautet.

Editor

Der Editor ist der Hauptbereich zum Bearbeiten der Dateien in VS Code. Die VEX VS Code-Erweiterung ermöglicht Intellisense/Linting für C/C++ und Python im Editorbereich, um uns bei der Entwicklung des Programms zu unterstützen.

VS Code Editor mit einer geöffneten Python-Datei, die Teil eines VEX-Projekts ist. Hier kann Python- oder C/C++-Code geschrieben und bearbeitet werden, um VEX-Robotikprogramme zu erstellen, wenn diese mit einem VEX Brain verbunden werden.

Im Editorbereich können wir hilfreiche Informationen zu einer bestimmten Funktion abrufen, indem wir mit der Maus über den Text der Funktion fahren oder die VEX-Befehlshilfe verwenden, um auf die Dokumentation zu dieser 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-Erweiterung bietet beim Start zwei Terminals, das Protokollterminal und das interaktive Terminal.

Protokollterminal – Das Protokollterminal zeigt Build-Ausgabe, Build-Fehler und Download-Ergebnisse an.

Das VS Code VEX Log Terminal ist geöffnet und zeigt standardmäßig einen leeren Zustand an, in dem nur eine Meldung mit dem Wort „Log“ ausgegeben wird.

Interaktives Terminal - Das interaktive Terminal hat zwei Funktionen: Es zeigt Druckprotokolle an und sendet die Tastatureingaben an ein Benutzerprogramm zurück.

Hinweis: Um das interaktive Terminal zu nutzen, muss ein Brain oder Controller an einen Computer mit der VEX VS Code Extension angeschlossen sein.
Hinweis: Die Ausgabe des interaktiven Terminals wird nach dem Erstellen und Herunterladen eines Benutzerprogramms standardmäßig gelöscht.

Symbolleiste

Die Symbolleiste enthält eine Reihe von Symbolen, die uns eine schnelle Möglichkeit zur Interaktion mit VEX VS Code-Erweiterungsprojekten, VEX Brains und VEX Controllern bieten.

VS Code-Symbolleiste mit VEX-Erweiterungssymbolen, die zur schnellen Interaktion mit angeschlossenen VEX-Geräten und -Projekten verwendet werden können. Zu den VEX-Funktionen gehören die Geräteauswahl, die Slot-Auswahl, das Symbol für den Build & -Download, das Wiedergabesymbol, das Stoppsymbol, die Projektauswahl und die Python-Dateiauswahl.

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 werden nicht als gültige VEX-Projekte betrachtet und müssen importiert werden.

Zu den in der Symbolleiste enthaltenen Symbolen gehören:

Geräteauswahl - Die Geräteauswahl zeigt das Symbol des angeschlossenen VEX-Geräts an (ein Gehirn-Symbol oder ein Controller-Symbol )
Hinweis: Wenn ein Controller mit dem Computer verbunden ist, aber keine Funkverbindung zu einem Gehirn besteht, wird neben dem Controller-Symbol kein Gehirnname angezeigt.

Slot-Auswahlsymbol – Mit dem Slot-Auswahlsymbol können wir auswählen, auf welchen Slot die VEX-Erweiterung ein Benutzerprogramm herunterladen oder abspielen soll, indem wir darauf klicken und aus der Auswahlliste einen der acht verfügbaren Slots auf dem VEX-Gehirn auswählen.
Build & 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, sofern erfolgreich, auf das verbundene VEX-Gerät heruntergeladen.
Wiedergabesymbol – Wenn auf das Wiedergabesymbol geklickt wird, wird das heruntergeladene Benutzerprogramm im ausgewählten Slot auf dem VEX Brain ausgeführt.
Stoppsymbol – Wenn auf das Stoppsymbol geklickt wird, wird die Ausführung des Benutzerprogramms auf dem VEX Brain gestoppt.
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, wird die Python-Dateiauswahl in der Symbolleiste angezeigt. 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 Toolbar-Funktionen in VS Code finden Sie in diesem Artikel.

VEX-Benutzereinstellungen

Die VEX-Benutzereinstellungen ermöglichen es uns, die VEX-Erweiterung entsprechend 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 VS Code-Benutzereinstellungen werden zur Kategorie VEX geöffnet, wo das Verhalten der VEX Robotics Extension angepasst werden kann.

Die VEX-Benutzereinstellungen zum Konfigurieren der VEX VS Code-Erweiterung sind:

Controllerkanal (nur V5-Controller) – Legt den Funkkanal des V5-Controllers auf Download oder Pitfest. Diese Einstellung gilt nur für die VEXnet-Funkverbindung.

Cpp-Toolchain-Pfad – Legt den Pfad für die CPP-Toolchain fest.
Benutzerterminal aktivieren– 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-Homepage – Legt den Standardspeicherort für neue Projekte fest.
Nach Download ausführen – Legt fest, ob das Benutzerprogramm nach dem Herunterladen auf ein VEX Brain ausgeführt werden soll.
System DFU Auto Recover – Legt fest, ob das Brain 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 Portnummer des Websocket-Servers fest

Hilfreiche Informationen zum Zugriff auf die VEX-Benutzereinstellungen und deren Festlegung finden Sie in diesem Artikel.