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

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.

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.

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 VEX

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ÇÕ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)

• 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, da porta série, do programa descarregado e dos 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.
  
  

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.

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.

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.
  
  

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

  

  
  
  Nota: Para utilizar o terminal interactivo, um Brain ou Controlador deve 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 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.

: 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 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 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 um dispositivo VEX estiver ligado, 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 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.