Descripción general de la interfaz de usuario de la extensión VEX VS Code – Biblioteca VEX

Este artículo proporciona una descripción general de la interfaz de usuario (IU) de extensión de Visual Studio Code de VEX. La extensión admite el desarrollo de proyectos C++ y Python para plataformas VEX IQ 2nd Generation, EXP y V5.

Diseño de la interfaz de usuario de la extensión VEX VS Code

La interfaz de usuario de la extensión VEX Visual Studio Code se divide en cinco áreas principales: Barra de actividad, Barra lateral, Editor, Panel de terminal y Barra de herramientas.

Captura de pantalla que muestra la interfaz de usuario completa de VEX VS Code. La barra de actividad y la barra lateral se encuentran en el lado izquierdo de la pantalla, la barra de herramientas y la terminal están en la parte inferior de la pantalla, y el editor ocupa el resto de la pantalla.

Barra de actividades

La barra de actividades presenta una serie de íconos que nos permiten cambiar entre vistas y nos brinda indicadores adicionales específicos del contexto para el desarrollo del proyecto VEX.

Barra de actividades de VS Code con la extensión VEX Robotics instalada. La barra de actividad cuenta con iconos que proporcionan acciones rápidas y útiles, como búsquedas, gestión de extensiones, control de versiones y mucho más.

Los íconos comunes utilizados para desarrollar un proyecto VEX en VS Code son:

Icono de vista del explorador - Al hacer clic, Vista del explorador se abre en la barra lateral.
Icono de vista de extensiones - Al hacer clic, se abre la Vista de extensiones en la barra lateral.
Icono de vista VEX - Al hacer clic, se abre la vista VEX en la barra lateral.

Barra lateral

La barra lateral contiene diferentes vistas que nos permiten utilizar las herramientas integradas dentro de VS Code. Las vistas comunes de la barra lateral que se utilizan para realizar tareas para el desarrollo de proyectos VEX son Vista de extensión, Vista VEXy Vista del explorador.

Vista de extensión

La vista de extensión se utiliza para instalar y administrar las extensiones en VS Code. Para desarrollar software en las plataformas VEX IQ 2nd Generation, EXP y V5, necesitamos instalar la extensión VEX, la extensión C/C++ y la extensión Python.

Para obtener instrucciones paso a paso sobre cómo instalar la extensión VEX, la extensión C/C++y la extensión Python en VS Code, consulte este artículo.

Vista de extensiones de VS Code que muestra una lista de las extensiones instaladas. Cada extensión tiene un menú de configuración que se puede abrir aquí, y hay una barra de búsqueda para encontrar y descargar nuevas extensiones.

Vista VEX

La vista VEX View nos permite desarrollar proyectos para VEX IQ 2.ª generación, EXP y V5 en VS Code. Hay tres categorías incluidas en la vista VEX: ACCIONES DEL PROYECTO, INFORMACIÓN DEL DISPOSITIVO VEX, y COMENTARIOS VEX.

Vista VEX de VS Code que muestra opciones para crear e importar proyectos en la parte superior, el menú Información del dispositivo VEX en la parte inferior y un menú de comentarios en la parte inferior.

ACCIONES DEL PROYECTO
Los botones debajo de ACCIONES DEL PROYECTO se utilizan para crear un nuevo proyecto VEX o importar un proyecto VEXcode existente.
Para obtener instrucciones detalladas sobre cómo crear un proyecto VEX en VS Code, consulte este artículo para V5, este artículo para EXPy este artículo para IQ (2.º).

Sección Acciones del proyecto de la vista de extensión VEX. Esta sección tiene dos botones que dicen "Nuevo proyecto" e "Importar proyecto".

INFORMACIÓN DEL DISPOSITIVO VEX
La categoría INFORMACIÓN DEL DISPOSITIVO VEX nos proporciona una descripción general del dispositivo VEX conectado : un VEX Brain o un VEX Controller.

Esta categoría indica el tipo de dispositivo VEX conectado y muestra la información del sistema Brain, el puerto serie, el programa descargado y los dispositivos conectados a los puertos inteligentes del VEX Brain. Nos permite capturar la pantalla del cerebro VEX, ver el registro de eventos del cerebro VEX, usar el V5 Battery Medic, establecer el nombre del cerebro y número de equipoy borrar el programa de usuario del cerebro VEX

Cuando un VEX Brain está conectado a la computadora, la categoría INFORMACIÓN DEL DISPOSITIVO VEX muestra si un controlador VEX está vinculado al VEX Brain y nos permite actualizar el VEXos para el VEX Brain si la versión VEXos del VEX Brain está desactualizada.

Cuando un controlador VEX está conectado a la computadora, la categoría INFORMACIÓN DEL DISPOSITIVO VEX muestra si un cerebro VEX está vinculado al controlador VEX y nos permite actualizar el VEXos para el controlador VEX si la versión VEXos del controlador VEX está desactualizada.

Para obtener una descripción completa de la información del dispositivo y cómo utilizar las funciones en INFORMACIÓN DEL DISPOSITIVO VEX, consulte este artículo.

COMENTARIOS DE VEX
Podemos enviar comentarios a VEX escribiendo el mensaje en el cuadro de texto debajo de COMENTARIOS DE VEX y haciendo clic en el ENVIAR botón.
Para obtener información útil sobre el uso de VEX FEEDBACK en VS Code, consulte este artículo.

Sección de comentarios de VEX en la vista de extensión de VEX. Esta sección contiene un formulario con opciones para enviar comentarios a VEX.

Vista del explorador

La vista del explorador se utiliza para explorar, abrir y administrar los archivos y carpetas del proyecto VEX en VS Code.

Vista del Explorador de VS Code que permite al usuario navegar por las carpetas y los archivos de su proyecto VEX. Los archivos tienen iconos y tipos de archivo correspondientes; en este ejemplo, se ha seleccionado un archivo Python y su título es VEXcode Project.py.

Editor

El Editor es el área principal para editar los archivos en VS Code. La extensión VEX VS Code habilita Intellisense/Linting tanto para C/C++ como para Python en el área del Editor para ayudarnos mientras desarrollamos el programa.

Editor VS Code con un archivo Python abierto como parte de un proyecto VEX. Aquí se puede escribir y editar código Python o C/C++ para crear programas de robótica VEX cuando se conecta a un VEX Brain.

En el área del Editor, podemos acceder a información útil sobre una función específica pasando el mouse sobre el texto de la función o utilizando la Ayuda del comando VEX para acceder a la documentación de esta función incluida en la API de C++ y Python (Interfaz de programación de aplicaciones).

Para obtener instrucciones detalladas sobre el uso del comando VEX Help en VS Code, consulte este artículo.

Panel de terminales

La extensión VEX VS Code proporciona dos terminales al inicio: la terminal de registro y la terminal interactiva.

Terminal de registro : la Terminal de registro muestra la salida de la compilación, el error de compilación y los resultados de la descarga.

Se abre el terminal de registro VEX de VS Code y muestra un estado vacío predeterminado con un solo mensaje impreso que dice Registro.

Terminal interactivo - El terminal interactivo tiene dos funciones: mostrar registros de impresión y enviar pulsaciones de teclas sin procesar a un programa de usuario.

Nota: Para utilizar el terminal interactivo, se debe conectar un Brain o Controller a un ordenador que ejecute la extensión VEX VS Code.
Nota: La salida del terminal interactivo se borra de manera predeterminada después de crear y descargar un programa de usuario.

Barra de herramientas

La barra de herramientas presenta una serie de íconos que nos brindan una forma rápida de interactuar con proyectos de extensión VEX VS Code, VEX Brains y VEX Controllers.

Barra de herramientas de VS Code con iconos de extensión VEX que permiten interactuar rápidamente con los dispositivos y proyectos VEX conectados. Las funciones de VEX incluyen el selector de dispositivos, el selector de ranuras, el icono de descarga de compilación & , el icono de reproducción, el icono de parada, el selector de proyectos y el selector de archivos Python.

Nota: La barra de herramientas solo está activa cuando hay un proyecto VEX válido abierto en VS Code.

Nota: Un proyecto VEX válido es un proyecto creado o importado por la extensión. Los proyectos VEXcode o VEXcode Pro abiertos en el editor no se considerarán un proyecto VEX válido y deberán importarse.

Los iconos que aparecen en la barra de herramientas incluyen:

Selector de dispositivo - El selector de dispositivo muestra el icono del dispositivo VEX conectado (un icono de cerebro o un icono de controlador )
Nota: Si un controlador está conectado al ordenador, pero no tiene un enlace de radio con un cerebro, no se mostrará ningún nombre de cerebro junto al icono del controlador.

Icono de selector de ranura - El Icono de selector de ranura nos permite elegir en qué ranura la extensión VEX descargará o reproducirá un programa de usuario haciendo clic en él y seleccionando una de las ocho ranuras disponibles en el cerebro VEX de la lista de selección.
Build & Icono de descarga - Si hay un dispositivo VEX conectado, el Icono de descarga aparecerá en la barra de herramientas. Al hacer clic, el proyecto se compilará y, si tiene éxito, se descargará al dispositivo VEX conectado.
Icono de reproducción - Al hacer clic, el Icono de reproducción ejecuta el programa de usuario descargado en la ranura seleccionada en el VEX Brain.
Icono de parada - Al hacer clic, el Icono de parada detiene la ejecución del programa de usuario en el VEX Brain.
Selector de proyecto - El Selector de proyecto muestra el nombre del proyecto seleccionado. El ícono selector de proyecto nos permite cambiar entre proyectos VEX cuando existen varios dentro del espacio de trabajo haciendo clic en él y seleccionando un proyecto de la lista de selección.
Selector de archivos Python (solo Python) - Cuando se selecciona un proyecto VEX Python, el Selector de archivos Python aparecerá en la barra de herramientas. El selector de archivos Python muestra el nombre del archivo Python seleccionado. Actualmente, Python para VEX solo admite descargas de archivos individuales.

Para obtener información útil sobre cómo utilizar las funciones de la barra de herramientas en VS Code, consulte este artículo.

Configuración de usuario de VEX

La configuración de usuario VEX nos permite configurar la extensión según nuestros propios requisitos. Las configuraciones de usuario son configuraciones globales que se aplican a cada proyecto de extensión de VEX VS Code. Podemos acceder a la Configuración de usuario VEX haciendo clic en el ícono de Configuración en VS Code y seleccionando los elementos correspondientes en los menús.

Se abre la configuración de usuario de VS Code en la categoría VEX, donde se puede personalizar el comportamiento de la extensión VEX Robotics.

Las configuraciones de usuario de VEX para configurar la extensión VEX VS Code son:

Canal del controlador (solo controlador V5) : establece el canal de radio del controlador V5 en Descargar o Pit. Esta configuración se aplica únicamente al enlace de radio VEXnet.

Ruta de la cadena de herramientas Cpp : establece la ruta para la cadena de herramientas CPP.
Habilitar terminal de usuario: habilita o deshabilita la extensión para abrir y mostrar datos desde el puerto de usuario.
Entradas de registro : establece la cantidad de entradas de registro que se cargarán desde un VEX Brain.
Tipo de compilación de proyecto : establece cómo la extensión compilará un proyecto C++.
Inicio del proyecto : establece la ubicación predeterminada para nuevos proyectos.
Ejecutar después de descargar : establece si el programa del usuario debe ejecutarse después de descargarse a un VEX Brain.
Recuperación automática del sistema DFU : establece si el cerebro debe recuperarse automáticamente cuando se detecta un IQ2 o EXP en modo DFU.
Habilitar servidor Websocket : habilita o deshabilita la extensión para iniciar el servidor Websocket.
Dirección de host del servidor Websocket : establece la dirección de host del servidor Websocket.
Puerto del servidor Websocket: establece el número de puerto del servidor Websocket

Para obtener información útil sobre cómo acceder y configurar la configuración de usuario de VEX, consulte este artículo.