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 (2.ª generación), 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 el diseño completo de la interfaz de usuario de VEX VS Code. La barra de actividad y la barra lateral están 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 llena 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 actividad de VS Code con la extensión VEX Robotics instalada. La barra de actividades tiene íconos que brindan acciones rápidas útiles, como buscar, administrar extensiones, control de versiones y 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 (2.ª generación), 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 extensión de VS Code 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

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 arriba, el menú de información del dispositivo VEX abajo 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.ª generación).

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 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 capturar la pantalla del VEX Brain, ver el registro de eventos del VEX Brain, establecer el nombre del cerebro y el número de equipo y borrar el programa de usuario del VEX Brain.

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 botón ENVIAR
Para obtener información útil sobre el uso de VEX FEEDBACK en VS Code, consulte este artículo.

Sección de comentarios de VEX 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 VS Code que permite al usuario navegar por las carpetas y archivos en su proyecto VEX. Los archivos tienen íconos correspondientes y se muestran los tipos de archivos; 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 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 de 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 la terminal de registro VS Code VEX y muestra un estado en blanco predeterminado con solo un 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 la terminal interactiva, se debe conectar un cerebro o controlador a una computadora 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 variedad 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 íconos de extensión VEX que se pueden usar para interactuar rápidamente con dispositivos y proyectos VEX conectados. Las características de VEX incluyen el Selector de dispositivos, el Selector de ranuras, el ícono de Descarga de compilación & , el ícono de Reproducir, el ícono de Detener, 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 ícono del dispositivo VEX conectado (un ícono de cerebro o un ícono 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 ícono del controlador.

Icono de selector de ranuras - El icono de selector de nos permite elegir en qué ranura VEX Extension descargará o reproducirá un programa de usuario haciendo clic en él y seleccionando una de las ocho ranuras disponibles en VEX Brain de la lista de selección.
Ícono de descarga de compilación & - Si hay un dispositivo VEX conectado, el Ícono de descarga se mostrará en la barra de herramientas. Al hacer clic, el proyecto se compilará y, si tiene éxito, se descargará al dispositivo VEX conectado.
Ícono de reproducción - Al hacer clic, el Ícono de reproducción ejecuta el programa de usuario descargado en la ranura seleccionada en VEX Brain.
Icono de parada - Al hacer clic, el Icono de parada detiene la ejecución del programa de usuario en 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.

La configuración de usuario de VS Code se abre 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:

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 cerebro IQ (2.ª generación) 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.