Visão geral da interface do utilizador da extensão de código VEX VS – Biblioteca VEX

Este artigo fornece uma visão geral da UI de extensão de código do VEX Visual Studio (interface do utilizador). A extensão suporta o desenvolvimento de projetos C++ e Python para as plataformas VEX IQ 2ª geração, EXP e V5.

Layout da interface do utilizador da extensão de código VEX VS

A UI da extensão de código do VEX Visual Studio está dividida em cinco áreas principais: Barra de atividades, Barra lateral, Editor, Painel de terminal e Barra de ferramentas.

Captura de ecrã que mostra o layout completo da interface do utilizador do VEX no VS Code. A barra de atividades e a barra lateral estão no lado esquerdo do ecrã, a barra de ferramentas e o terminal estão na parte inferior do ecrã, e o editor preenche o resto do ecrã.

Barra de atividades

A barra de atividades apresenta uma variedade de ícones que nos permitem alternar entre visualizações e nos fornecem indicadores adicionais específicos do contexto para o desenvolvimento do projeto VEX.

Barra de atividades do VS Code com a extensão VEX Robotics instalada. A barra de atividades possui ícones que oferecem ações rápidas e úteis, como pesquisa, gestão de extensões, controlo de versões e muito mais.

Os ícones comuns utilizados para desenvolver um projeto VEX no VS Code são:

Explorer View Icon - Quando clicado, o Explorer View é aberto na barra lateral.
Ícone de Exibição de Extensões - Quando clicado, a Exibição de Extensões é aberta na Barra Lateral.
VEX View Icon - Quando clicado, o VEX View é aberto na barra lateral.

Barra lateral

A barra lateral contém diferentes vistas que nos permitem utilizar as ferramentas integradas no VS Code. As visualizações comuns da barra lateral utilizadas para executar tarefas de desenvolvimento de projetos VEX são Extension View, VEX Viewe Explorer View.

Exibição de extensão

O Extension View é utilizado para instalar e gerir as extensões no VS Code. Para desenvolver software nas plataformas VEX IQ 2ª geração, EXP e V5, necessitamos de instalar a extensão VEX, extensão C/C++ e extensão Python.

Para obter instruções passo a passo sobre como instalar a extensão VEX, extensão C/C++e extensão Python no código VS, consulte este artigo.

Visualização das extensões do VS Code que apresenta uma lista das extensões instaladas. Cada extensão tem um menu de definições que pode ser aberto aqui, e existe uma barra de pesquisa para encontrar e descarregar novas extensões.

Visualização VEX

O VEX View permite-nos desenvolver projetos para VEX IQ 2ª Geração, EXP e V5 em VS Code. Existem três categorias incluídas na vista VEX: AÇÕES DO PROJETO, INFORMAÇÃO DO DISPOSITIVO VEX, e FEEDBACK VEX.

A vista VEX do VS Code mostra as opções para criar e importar projetos na parte superior, o menu de informações do dispositivo VEX na parte inferior e um menu de feedback na parte inferior.

AÇÕES DO PROJETO
Os botões em AÇÕES DO PROJETO são utilizados para criar um novo projeto VEX ou importar um projeto VEXcode existente.
Para obter orientações detalhadas sobre a criação de um projeto VEX no VS Code, consulte este artigo para V5, este artigo para EXPe este artigo para IQ (2º).

Secção Ações do Projeto da Visualização de Extensão VEX. Esta secção possui dois botões com os dizeres "Novo Projeto" e "Importar Projeto".

INFORMAÇÃO DO DISPOSITIVO VEX
A categoria INFORMAÇÃO DO DISPOSITIVO VEX fornece uma visão geral do dispositivo VEX ligado - um VEX Brain ou um Controlador VEX.

Esta categoria indica o tipo de dispositivo VEX ligado e apresenta as informações do sistema Brain, a porta série, o programa descarregado e os dispositivos ligados às portas inteligentes do VEX Brain. Permite-nos capturar o ecrã do VEX Brain, visualizar o registo de eventos do VEX Brain, utilizar o V5 Battery Medic, definir o nome do cérebro e equipa númeroe apagar o programa do utilizador do VEX Cérebro.

Quando um VEX Brain está ligado ao computador, a categoria VEX DEVICE INFO mostra se um VEX Controller está ligado ao VEX Brain e permite-nos atualizar o VEXos para o VEX Brain se a versão VEXos do VEX Brain estiver desatualizada.

Quando um VEX Controller está ligado ao computador, a categoria VEX DEVICE INFO mostra se um VEX Brain está ligado ao VEX Controller e permite-nos atualizar o VEXos para o VEX Controller se a versão VEXos do VEX Controller estiver desatualizada.

Para obter uma descrição abrangente das informações do dispositivo e de como utilizar as funcionalidades em VEX DEVICE INFO, consulte este artigo.

VEX FEEDBACK
Podemos enviar feedback à VEX, digitando a mensagem na caixa de texto abaixo de VEX FEEDBACK e clicando no botão ENVIAR .
Para obter informações úteis sobre a utilização do VEX FEEDBACK no VS Code, consulte este artigo.

Secção de feedback VEX da vista de extensão VEX. Esta secção contém um formulário com opções para enviar feedback à VEX.

Visualização do Explorador

O Explorer View é utilizado para navegar, abrir e gerir os ficheiros e pastas do projeto VEX no VS Code.

Visualização do Explorador do VS Code que permite ao utilizador navegar pelas pastas e ficheiros do seu projeto VEX. Os ficheiros possuem ícones correspondentes e os tipos de ficheiro são apresentados; neste exemplo, está selecionado um ficheiro Python e o título é main.py.

Editor

O Editor é a área principal para editar os ficheiros no VS Code. A extensão de código VEX VS permite Intellisense/Linting para C/C++ e Python na área do Editor para nos ajudar durante o desenvolvimento do programa.

Editor VS Code com um ficheiro Python aberto como parte de um projeto VEX. Aqui é possível escrever e editar código em Python ou C/C++ para criar programas de robótica VEX quando ligados a um VEX Brain.

Na área Editor, podemos aceder a informações úteis sobre uma função específica passando o rato sobre o texto da função ou utilizando o VEX Command Help para aceder à documentação desta função incluída na API C++ e Python (Application Programming Interface).

Para obter instruções detalhadas sobre como utilizar o VEX Command Help no VS Code, consulte este artigo.

Painel Terminal

A extensão VEX VS Code disponibiliza dois terminais no arranque, o Log Terminal e o Interactive Terminal.

Log Terminal - O Log Terminal apresenta a saída de compilação, o erro de compilação e os resultados de download.

O terminal de registos VEX do VS Code é aberto e apresenta um estado em branco padrão, com apenas uma mensagem impressa: "Log".

Terminal Interativo - O Terminal Interativo tem duas funções: apresentar registos de impressão e enviar as sequências de teclas em bruto de volta para um programa do utilizador.

Nota: Para utilizar o terminal interactivo, um Brain ou Controller tem de estar ligado a um computador que execute a extensão VEX VS Code.
Nota: A saída do terminal interativo é apagada por defeito após a compilação e o download de um programa do utilizador.

Barra de ferramentas

A barra de ferramentas apresenta uma variedade de ícones que nos fornecem uma forma rápida de interagir com os projetos de extensão VEX VS Code, VEX Brains e VEX Controllers.

Barra de ferramentas VS Code com ícones de extensão VEX que podem ser utilizados para interagir rapidamente com dispositivos e projetos VEX ligados. As características do VEX incluem o Seletor de Dispositivo, o Seletor de Slot, o ícone de Download da Versão & , o ícone de Reproduzir, o ícone de Parar, o Seletor de Projeto e o Seletor de Ficheiros Python.

Nota: A barra de ferramentas só está ativa quando um projeto VEX válido está aberto no VS Code.

Nota: Um projeto VEX válido é aquele que é criado ou importado pela extensão. Os projetos VEXcode ou VEXcode Pro abertos no editor não serão considerados projetos VEX válidos e terão de ser importados.

Os ícones apresentados na barra de ferramentas incluem:

Seletor de dispositivos - O Seletor de dispositivos apresenta o ícone do dispositivo VEX ligado (um ícone de Brain ou um ícone de Controller )
Nota: Se um controller estiver ligado ao computador, mas não tiver uma ligação rádio com um cérebro, não será apresentado nenhum nome de cérebro junto ao ícone do Controller.

Ícone seletor de slots - O ícone seletor de slots permite-nos escolher em que slot a extensão VEX irá descarregar ou reproduzir um programa do utilizador clicando sobre ele e selecionando um dos oito slots disponíveis no VEX Brain na lista de seleção.
Ícone de download do Build & - Se estiver ligado um dispositivo VEX, o ícone de download é apresentado na barra de ferramentas. Quando clicado, o projeto será compilado e, se for bem-sucedido, será descarregado para o dispositivo VEX ligado.
Ícone Play - Quando clicado, o ícone Play executa o programa do utilizador descarregado no slot selecionado no VEX Brain.
Ícone Stop - Quando clicado, o ícone Stop interrompe a execução do programa do utilizador no VEX Brain.
Seletor de Projeto - O Seletor de Projeto apresenta o nome do projeto selecionado. O ícone do seletor de projeto permite-nos alternar entre projetos VEX quando existem vários dentro do espaço de trabalho a clicar sobre ele e a selecionar um projeto na lista de seleção.
Seletor de ficheiros Python (apenas Python) - Quando um projeto VEX Python é selecionado, o Seletor de ficheiros Python aparece na barra de ferramentas. O Python File Selector apresenta o nome do ficheiro Python selecionado. Atualmente, o Python para VEX suporta apenas downloads de ficheiros únicos.

Para obter informações úteis sobre como utilizar as funcionalidades da barra de ferramentas no VS Code, este artigo.

Configurações do utilizador VEX

As definições do utilizador VEX permitem-nos configurar a extensão VEX de acordo com os nossos próprios requisitos. As definições do utilizador são definições globais aplicadas a cada projeto de extensão VEX VS Code. Podemos aceder Configurações do utilizador VEX clicando no ícone Configurações no VS Code e selecionando os itens correspondentes nos menus.

As Configurações do Utilizador do VS Code são abertas na categoria VEX, onde o comportamento da extensão VEX Robotics pode ser personalizado.

As definições do utilizador VEX para configurar a extensão do código VEX VS são:

Canal do Controlador (apenas Controlador V5) - Define o Canal de Rádio do Controlador V5 para Download ou Pit. Esta configuração aplica-se apenas ao link de rádio VEXnet.

Cpp Toolchain Path – Define o caminho para o CPP Toolchain.
Activar Terminal de Utilizador- Activa ou desactiva o posto para abrir e apresentar os dados da porta do utilizador.
Entradas de registo - Define o número de entradas de registo a carregar a partir de um VEX Brain.
Project Build Type – Define a forma como a extensão irá construir um projeto C++.
Project Home - Define o local predefinido para novos projetos.
Executar após download - Define se o programa do utilizador deve ser executado após ser descarregado para um VEX Brain.
System DFU Auto Recover - Define se o Brain deve recuperar automaticamente quando é detectado um IQ2 ou EXP no modo DFU.
Websocket Server Enable - Activa ou desactiva a extensão para iniciar o Websocket Server.
Endereço de host do servidor Websocket - Define o endereço de host do servidor Websocket.
Porta do servidor Websocket - Define o número da porta do servidor Websocket

Para obter informações úteis sobre como aceder e definir as definições do utilizador VEX, este artigo.