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

Este artículo proporciona una descripción general de la interfaz de usuario(interfaz de usuario) de VEX Visual Studio Code Extension. La extensión apoya el desarrollo de proyectos en C++ y Python para las plataformas VEX IQ (2ª generación), EXP y V5.

Diseño de UI de extensión de código VEX VS

La interfaz de usuario de VEX Visual Studio Code Extension se divide en cinco áreas principales: barra de actividades, barra lateral, editor, panel de terminales y barra de herramientas.

Captura de pantalla que muestra el diseño completo de la interfaz de usuario de VEX VS Code. La barra de actividades y la barra lateral están en el lado izquierdo de la pantalla, la barra de herramientas y el terminal están en la parte inferior de la pantalla y el editor llena el resto de la pantalla.

Barra de actividades

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

Barra de actividad VS Code con la extensión VEX Robotics instalada. La barra de actividades tiene iconos que proporcionan acciones rápidas útiles, como buscar, administrar extensiones, controlar versiones y más.

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

Icono de Vista del Explorador : cuando se hace clic, la Vista del Explorador se abre en la Barra Lateral.
Icono de vista de extensiones : cuando se hace clic, la vista de extensiones se abre en la barra lateral.
Icono de vista VEX : cuando se hace clic, la vista VEX se abre 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 utilizadas para realizar tareas para el desarrollo de proyectos VEX son Extension View, VEX View y Explorer View.

Vista de extensión

La vista Extensión se utiliza para instalar y administrar las extensiones en VS Code. Para desarrollar software en plataformas VEX IQ (2ª generación), EXP y V5, necesitamos instalar VEX Extension, C/C++ Extension y Python Extension.

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 extensión de código VS que muestra una lista de 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

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 DE VEX.

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

ACCIONES DEL PROYECTO
Los botones en ACCIONES DEL PROYECTO se utilizan para crear un nuevo proyecto VEX o importar un proyecto VEXcode existente.
Para obtener orientación detallada sobre la creación de un proyecto VEX en VS Code, consulte este artículo para V5, este artículo paraEXP y este artículo para IQ (2ª generación).

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

INFORMACIÓN DEL DISPOSITIVO VEX
La categoría de INFORMACIÓN del dispositivo Vex nos proporciona una visión general del dispositivo VEX conectado : un cerebro VEX o un controlador VEX.

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 de VEX Brain. Nos permite hacer una captura de pantalla de la pantalla cerebral de VEX, ver el registro de eventos cerebrales de Vex, establecer el nombre del cerebro y el número de equipo, y borrar el programa de usuario del cerebro de VEX.

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

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

Para obtener una descripción completa de la información del dispositivo y cómo usar las funciones en VEX DEVICE INFO, consulta este artículo.

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

Sección VEX Feedback de la vista de extensión de VEX. Esta sección tiene 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 código VS que permite al usuario navegar por las carpetas y archivos en su proyecto VEX. Los archivos tienen iconos y tipos de archivo correspondientes que se muestran, en este ejemplo se selecciona un archivo Python y el título dice main.py.

Editor

El Editor es el área principal para editar los archivos en VS Code. La extensión de código VEX VS permite Intellisense/Linting tanto para C/C++ como para Python en el área de Editor para ayudarnos a desarrollar el programa.

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

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

Para obtener instrucciones detalladas sobre el uso de la Ayuda del comando VEX en el código VS, consulte este artículo.

Panel de terminales

La extensión de código VEX VS proporciona dos terminales en el arranque, el terminal de registro y el terminal interactivo.

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

El terminal de registro VS Code VEX se abre y muestra un estado en blanco predeterminado con solo un registro de lectura de mensaje impreso.

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 cerebro o controlador a una computadora que ejecute la extensión de código VEX VS.
Nota: La salida interactiva del terminal se borra de forma predeterminada después de crear y descargar un programa de usuario.

Barra de herramientas

La barra de herramientas cuenta con una serie de iconos que nos proporcionan una forma rápida de interactuar con los proyectos de extensión VEX VS Code, VEX Brains y VEX Controllers.

Barra de herramientas de código VS con iconos de extensión VEX que se pueden usar para interactuar rápidamente con 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 de Python.

Nota: La barra de herramientas solo está activa cuando un proyecto VEX válido está 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 dispositivos: el selector de dispositivos muestra el icono del dispositivo VEX conectado (un icono de cerebro o un icono de controlador )
Nota: si un controlador está conectado a la computadora, pero no tiene un enlace de radio a un cerebro, no se mostrará ningún nombre de cerebro junto al icono del controlador.

Icono del selector de ranuras: el icono del selector de ranuras nos permite elegir en qué ranura descargará o reproducirá la extensión VEX 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.
Icono de & descarga de compilación: si hay un dispositivo VEX conectado, el icono de descarga se mostrará en la barra de herramientas. Al hacer clic, el proyecto se construirá y, si tiene éxito, se descargará en el 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: cuando se hace clic, el icono de parada deja de ejecutar el programa de usuario en el VEX Brain.
Selector de proyectos : el Selector de proyectos muestra el nombre del proyecto seleccionado. El icono del selector de proyectos 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 de Python (solo Python) : cuando se selecciona un proyecto de Python VEX, el selector de archivos de 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, consulta este artículo.

Configuración de usuario de VEX

La configuración de usuario de VEX nos permite configurar la extensión de VEX de acuerdo con nuestros propios requisitos. Los ajustes de usuario son ajustes globales aplicados a cada proyecto de extensión VEX VS Code. Podemos acceder a la configuración de usuario de VEX haciendo clic en el icono de configuración en VS Code y seleccionando los elementos correspondientes en los menús.

VS Code User Settings se abre a la categoría VEX donde se puede personalizar el comportamiento de la extensión VEX Robotics.

Los ajustes de usuario de VEX para configurar la extensión de código VS de VEX son:

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 el número de entradas de registro que se cargarán desde un VEX Brain.
Tipo de compilación del proyecto : establece cómo la extensión compilará un proyecto de C++.
Inicio del proyecto : establece la ubicación predeterminada para los nuevos proyectos.
Ejecutar después de la descarga : establece si el programa de usuario debe ejecutarse después de que se descargue en un VEX Brain.
Recuperación automática de DFU del sistema : establece si el cerebro debe recuperarse automáticamente cuando se detecta un cerebro IQ (2ª generación) o EXP en el modo DFU.
Websocket Server Enable : habilita o deshabilita la extensión para iniciar Websocket Server.
Dirección de host del servidor de Websocket : establece la dirección de host del servidor de Websocket.
Puerto del servidor de Websocket - Establece el número de puerto del servidor de Websocket

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