Visão geral da interface do utilizador da extensão VEX para VS Code – Biblioteca VEX

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

Layout da interface do utilizador da extensão VEX para VS Code

A interface de utilizador da extensão VEX para o Visual Studio Code está dividida em cinco áreas principais: Barra de Atividades, Barra Lateral, Editor, Painel do 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 série de ícones que nos permitem alternar entre visualizações e fornece-nos indicadores contextuais adicionais 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:

Ícone da Vista do Explorador - Ao clicar, a Vista do Explorador abre na Barra Lateral.
Ícone de visualização de extensões - Ao clicar, a visualização de extensões abre na barra lateral.
Ícone de visualização VEX - Ao clicar, a visualização VEX abre na barra lateral.

Barra lateral

A barra lateral contém diferentes visualizações que nos permitem utilizar as ferramentas integradas do VS Code. As visualizações comuns da barra lateral utilizadas para executar tarefas no desenvolvimento de projetos VEX são Visualização de extensão, Visualização VEXe Visualização do explorador.

Vista de extensão

A opção Extension View é utilizada para instalar e gerir extensões no VS Code. Para desenvolver software nas plataformas VEX IQ de 2ª geração, EXP e V5, é necessário instalar as extensões VEX, C/C++ e Python.

Para obter instruções passo a passo sobre como instalar a extensão VEX, a extensão C/C++e a extensão Python no VS Code, 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.

VEX View

O View permite desenvolver projetos para VEX IQ de 2ª geração, EXP e V5 no VS Code. Existem três categorias incluídas na VEX View: 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 como criar um projeto VEX no VS Code, consulte artigo para V5 este artigo para EXPe este artigo para IQ (2ª edição)

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

Esta categoria indica o tipo de dispositivo VEX ligado e apresenta as informações do sistema Brain, porta série, programa descarregado e dispositivos ligados às portas inteligentes do VEX Brain. Isto 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 o número da equipae apagar o programa do utilizador do VEX Brain

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

Quando um Controlador VEX é ligado ao computador, a categoria INFORMAÇÃO DO DISPOSITIVO VEX mostra se um VEX Brain está ligado ao Controlador VEX e permite-nos atualizar o VEXos do Controlador VEX no caso de a versão do VEXos do Controlador VEX estar desatualizada.

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

FEEDBACK VEX
Podemos enviar feedback à VEX, escrevendo a mensagem na caixa de texto abaixo de FEEDBACK VEX e clicando no botão ENVIAR
Para obter informações úteis sobre como utilizar o 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.

Visão do Explorador

A janela "Explorador (Explorer View é utilizada 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 é VEXcode Project.py.

Editor

O Editor é a área principal para editar ficheiros no VS Code. A extensão VEX para VS Code habilita o Intellisense/Linting para C/C++ e Python na área do Editor, auxiliando no 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 do Editor, podemos aceder a informação útil sobre uma função específica passando o rato sobre o texto da função ou utilizando o comando VEX Help para aceder à documentação dessa função incluída na API (Application Programming Interface) do C++ e do Python.

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

Painel de terminais

A extensão VEX para VS Code disponibiliza dois terminais no arranque: o Terminal de Registo e o Terminal Interativo.

Terminal de Registo - O Terminal de Registo apresenta a saída da compilação, os erros 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.

: Para utilizar o terminal interactivo, um cérebro ou controlador deve estar ligado a um computador que execute a extensão VEX para VS Code.
Nota: A saída do terminal interativo é apagada por defeito após a compilação e o download 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 para VS Code, VEX Brains e controladores VEX.

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.

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

projeto VEX válido é um projeto 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 presentes na barra de ferramentas incluem:

Seletor de dispositivos - O Seletor de dispositivos apresenta o ícone do dispositivo VEX ligado (um ícone do Brain ou um ícone do 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 do cérebro junto ao ícone do Controller.

Ícone Seletor de Slot - O Ícone Seletor de Slot permite escolher em que Slot a Extensão VEX irá descarregar ou executar um programa do utilizador, clicando nele e selecionando um dos oito Slots disponíveis no VEX Brain na lista de seleção.
Build & Ícone de Download - Se estiver ligado um dispositivo VEX, o Ícone de Download é apresentado na barra de ferramentas. Ao clicar, o projeto será compilado e, se a compilação for bem-sucedida, será descarregado para o dispositivo VEX ligado.
Ícone de reprodução - Ao clicar, o Ícone de reprodução executa o programa de utilizador descarregado no Slot selecionado no VEX Brain.
Ícone de Parar - Ao clicar, o Ícone de Parar 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 Projetos permite alternar entre projetos VEX quando existem vários na área de trabalho clicando sobre ele e selecionando um projeto na lista pendente.
Seletor de ficheiros Python (apenas Python) - Quando um projeto VEX Python é selecionado, o Seletor de ficheiros Python irá aparecer na Barra de ferramentas. O Seletor de Ficheiros apresenta o nome do ficheiro Python selecionado. Atualmente, o Python para VEX suporta apenas downloads de ficheiros individuais.

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

Configurações de utilizador VEX

As Configurações VEX de acordo com as nossas próprias necessidades. As Definições do Utilizador são definições globais aplicadas a todos os projetos de extensão VEX para VS Code. Podemos aceder às Definições de Utilizador VEX clicando no ícone Definiçõ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 de utilizador VEX para configurar a extensão VEX para VS Code 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 enlace de rádio VEXnet.

Caminho da cadeia de ferramentas C++ - Define o caminho para a cadeia de ferramentas C++.
Activar Terminal do Utilizador- Activa ou desactiva a extensão para abrir e apresentar os dados da porta do utilizador.
entradas de registo - Define o número de entradas de registo a enviar a partir de um VEX Brain.
Tipo de compilação do projeto - Define a forma como a extensão irá compilar um projeto C++.
Página inicial do projeto - Define o local predefinido para novos projetos.
Executar após o download - Define se o programa do utilizador deve ser executado após ser descarregado para um VEX Brain.
Recuperação automática do sistema DFU - Define se o cérebro deve recuperar automaticamente quando um IQ2 ou EXP é detectado no modo DFU.
Activar servidor Websocket - Activa ou desactiva a extensão para iniciar o servidor Websocket.
Endereço do host do servidor Websocket - Define o endereço do 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 configurar as Definições de Utilizador do VEX, consulte artigo.