VEX VS Code-Erweiterung – Benutzeroberflächenübersicht – VEX-Bibliothek

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

VEX VS Code Erweiterungs-UI-Layout

Die Benutzeroberfläche der VEX Visual Studio Code-Erweiterung ist in fünf Hauptbereiche unterteilt: Aktivitätsleiste, Seitenleiste, Editor, Terminal-Panel 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 enthält eine Reihe von Symbolen, mit denen wir zwischen verschiedenen Ansichten wechseln können und die uns zusätzliche kontextspezifische Indikatoren für die Entwicklung des VEX-Projekts liefern.

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 gängigen Symbole, die für die Entwicklung eines VEX-Projekts in VS Code verwendet werden, sind:

Explorer-Ansicht Symbol - Beim Anklicken öffnet sich die Explorer-Ansicht in der Seitenleiste.
Erweiterungsansicht Symbol - Beim Anklicken öffnet sich die Erweiterungsansicht in der Seitenleiste.
VEX-Ansichtssymbol - Beim Anklicken öffnet sich die VEX-Ansicht in der Seitenleiste.

Seitenleiste

Die Seitenleiste enthält verschiedene Ansichten, die es uns ermöglichen, die in VS Code integrierten Tools zu nutzen. Die üblicherweise in der Seitenleiste verwendeten Ansichten zur Durchführung von Aufgaben im Rahmen der VEX-Projektentwicklung sind Erweiterungsansicht, VEX-Ansichtund Explorer-Ansicht.

Erweiterungsansicht

Die Erweiterungsansicht dient zum und Verwalten der Erweiterungen in VS Code. Für die Softwareentwicklung auf den Plattformen VEX IQ (2. Generation), EXP und V5 müssen die VEX-Erweiterung, die C/C++-Erweiterung und die Python-Erweiterung installiert werden.

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

VEX View können wir Projekte für VEX IQ (2. Generation), EXP und V5 in VS Code entwickeln. Die VEX-Ansicht enthält drei Kategorien: PROJEKTAKTIONEN, VEX-GERÄTEINFORMATIONEN, 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 dienen zum Erstellen eines neuen VEX-Projekts oder zum Importieren eines bestehenden VEXcode-Projekts.
Eine detaillierte Anleitung zum Erstellen eines VEX-Projekts in VS Code finden Sie diesem Artikel für, diesem Artikel fürund diesem Artikel für IQ (2. Generation)

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 einen Überblick über das angeschlossene VEX-Gerät – ein VEX Brain oder einen VEX Controller.

Diese Kategorie gibt den angeschlossenen VEX-Gerätetyp an und zeigt Informationen über das Brain-System, den seriellen Port, das heruntergeladene Programm und die an die Smart Ports des VEX Brain angeschlossenen Geräte an. Es ermöglicht uns, einen Screenshot des VEX Brain-Bildschirms zu erstellen, das VEX Brain-Ereignisprotokoll einzusehen, den Brain-Namen und die Teamnummer festzulegen und das Benutzerprogramm aus dem VEX Brain zu löschen.

Wenn ein VEX Brain mit dem Computer verbunden ist, zeigt die Kategorie VEX-Geräteinformationen an, ob ein VEX-Controller mit dem VEX Brain verbunden ist, und ermöglicht es uns, VEXos für das VEX Brain zu aktualisieren, falls die VEXos-Version des VEX Brain veraltet ist.

Wenn ein VEX-Controller an den Computer angeschlossen ist, zeigt die Kategorie VEX-Geräteinformationen an, ob ein VEX Brain mit dem VEX-Controller verbunden ist, und ermöglicht es uns für den VEX-Controller zu aktualisieren, falls dessen VEXos-Version veraltet ist.

Eine ausführliche Beschreibung der Geräteinformationen und der Funktionen unter VEX DEVICE INFOfinden 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 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 dient zum Durchsuchen, Öffnen und Verwalten der VEX-Projektdateien und -ordner in VS Code.

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 von 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 Programmentwicklung 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 indem wir den Befehl VEX Command Help verwenden, um auf die Dokumentation für diese Funktion zuzugreifen, die in der C++ und Python API (Application Programming Interface) enthalten ist.

Eine detaillierte Anleitung zur Verwendung des Befehls VEX in VS Code finden Sie diesem.

Anschlussfeld

Die VEX VS Code-Erweiterung bietet beim Start zwei Terminals: das Log-Terminal und das interaktive Terminal.

Log Terminal - Das Log Terminal 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: die Anzeige von Druckprotokollen und die Rücksendung der Rohdaten der Tastatureingaben an ein Benutzerprogramm.

Hinweis: Um das interaktive Terminal zu nutzen, muss ein Brain oder Controller mit einem Computer verbunden sein, auf dem die VEX VS Code-Erweiterung ausgeführt wird.
: Die Ausgabe des Terminals wird nach dem Kompilieren und Herunterladen eines Benutzerprogramms standardmäßig gelöscht.

Symbolleiste

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

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.

: Die Symbolleiste ist nur aktiv wenn ein gültiges VEX-Projekt in VS Code geöffnet ist.

: Ein VEX-Projekt ist ein Projekt, das von der Erweiterung erstellt oder importiert wurde. Im Editor geöffnete VEXcode- oder VEXcode Pro-Projekte werden nicht als gültiges VEX-Projekt betrachtet und müssen importiert werden.

Die in der Symbolleiste enthaltenen Symbole umfassen:

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 - Das Slot-Auswahlsymbol ermöglicht es uns, den Slot auszuwählen, auf dem die VEX-Erweiterung ein Benutzerprogramm herunterladen oder ausführen soll, indem wir darauf klicken und einen der acht verfügbaren Slots auf dem VEX Brain aus der Auswahlliste auswählen.
Build & Download-Symbol - Wenn ein VEX-Gerät angeschlossen ist, wird das Download-Symbol in der Symbolleiste angezeigt. Nach dem Anklicken wird das Projekt erstellt und, falls erfolgreich, auf das angeschlossene VEX-Gerät heruntergeladen.
Wiedergabesymbol - Beim Anklicken des Wiedergabesymbols wird das heruntergeladene Benutzerprogramm im ausgewählten Slot auf dem VEX Brain ausgeführt.
Stoppsymbol - Beim Anklicken des wird die Ausführung des Benutzerprogramms auf dem VEX Brain gestoppt.
Projektauswahl - Die Projektauswahl zeigt den Namen des ausgewählten Projekts an. Mit dem Symbol 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-Dateiauswahldialog 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 diesem Artikel.

VEX-Benutzereinstellungen

Die VEX-Benutzereinstellungen ermöglichen es uns, die VEX-Erweiterung nach unseren eigenen Anforderungen zu konfigurieren. Benutzereinstellungen sind globale Einstellungen, die für jedes VEX VS Code-Erweiterungsprojekt gelten. Wir können auf die -Benutzereinstellungen zugreifen indem wir in VS Code auf das Symbol „Einstellungen“ klicken und die entsprechenden Menüpunkte 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 zur Konfiguration der VEX VS Code-Erweiterung lauten:

Cpp Toolchain Path - Legt den Pfad für die CPP Toolchain fest.
Benutzerterminal aktivieren- Aktiviert oder deaktiviert die Erweiterung zum Öffnen und Anzeigen von Daten vom Benutzerport.
Logeinträge - Legt die Anzahl der Logeinträge fest, die von einem VEX Brain hochgeladen werden sollen.
Projekt-Build-Typ - Legt fest, wie die Erweiterung ein C++-Projekt erstellt.
Projektstartseite - Legt den Standardspeicherort für neue Projekte fest.
Nach dem 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 sich das Gehirn automatisch wiederherstellen soll, wenn ein IQ (2. Generation) oder EXP Gehirn im DFU-Modus erkannt wird.
Websocket-Server aktivieren - Aktiviert oder deaktiviert die Erweiterung zum Starten des Websocket-Servers.
Websocket Server Host Address - Legt die Hostadresse des Websocket-Servers fest.
Websocket-Server-Port - Legt die Portnummer des Websocket-Servers fest

Hilfreiche Informationen zum Zugriff auf und zur Konfiguration der VEX-Benutzereinstellungen finden in diesem.