Visão geral da interface do usuário da extensão VEX VS Code

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

Layout de interface do usuário da extensão VEX VS Code

A interface do usuário da extensão VEX Visual Studio Code é dividida em cinco áreas principais: Barra de atividades, Barra lateral, Editor, Painel de terminais e Barra de ferramentas.

Barra de atividades

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

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

• Ícone de visualização do Explorer - Quando clicado, o Ícone de visualização do Explorer é aberto na barra lateral.
• Ícone de exibição de extensões - Quando clicado, o Ícone de exibição de extensões é aberto na barra lateral.
• Ícone VEX View - Quando clicado, o VEX View abre na Barra Lateral.

Barra lateral

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

Exibição de extensão

A extensão View é usada para instalar e gerenciar 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, C/C++ Extensione Python Extension no VS Code, confira este artigo.

Visão VEX

O VEX View permite-nos desenvolver projetos para VEX IQ (2ª geração), EXP e V5 em VS Code. Há três categorias incluídas na VEX View: AÇÕES DO PROJETO, INFORMAÇÕES 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 a criação de um projeto VEX no VS Code, consulte este artigo para V5, este artigo para EXPe este artigo para IQ (2ª geração).

• VEX DEVICE INFO
  A categoria VEX DEVICE INFO nos fornece uma visão geral do dispositivo VEX conectado - um VEX Brain ou um VEX Controller.
  
  

  

  
  Esta categoria indica o tipo de dispositivo VEX conectado e exibe as informações do sistema Brain, porta serial, programa baixado e dispositivos conectados às portas inteligentes do VEX Brain. Permite-nos capturar o ecrã do VEX Brain, visualizar o registo de eventos do VEX Brain, definir o nome do cérebro e o número da equipa e apagar o programa de utilizador do VEX Brain.
  
  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 em 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.
  
  

Visualização do Explorer

O Explorer View é usado para navegar, abrir e gerenciar os arquivos e pastas do projeto VEX no VS Code.

Editor

O Editor é a área principal para editar arquivos no VS Code. A extensão VEX VS Code habilita o Intellisense/Linting para C/C++ e Python na área do Editor para nos ajudar no desenvolvimento do programa.

Na área do Editor, podemos acessar informações úteis sobre uma função específica passando o mouse sobre o texto da função ou usando o VEX Command Help para acessar a 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 VEX Command Help no VS Code, consulte este artigo.

Painel de terminais

A extensão VEX VS Code fornece dois terminais na inicialização, o Terminal de Log e o Terminal Interativo. 

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

• Terminal interativo - O Terminal interativo tem duas funções: exibir logs de impressão e enviar pressionamentos de tecla brutos de volta para um programa de usuário.
  
  

  

  
  
  Nota: Para utilizar o terminal interativo, um cérebro ou controlador deve ser conectado a um computador executando a extensão VEX VS Code.
  Nota: A saída do terminal interativo é apagada por padrão após a construção e o download de um programa de usuário.

Barra de ferramentas

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

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

Nota: Um projeto VEX válido é um projeto criado ou importado pela extensão. Projetos VEXcode ou VEXcode Pro abertos no editor não serão considerados projetos VEX válidos e precisarão ser importados.

Os ícones apresentados na Barra de Ferramentas incluem:

• Seletor de dispositivo - O Seletor de dispositivo exibe o ícone do dispositivo VEX conectado (um ícone de cérebro ou um ícone de controlador )
  Observação: Se um controlador estiver conectado ao computador, mas não tiver um link de rádio para um cérebro, nenhum nome de cérebro será exibido ao lado do ícone do controlador.

• Ícone seletor de slot - O ícone seletor de slot nos permite escolher em qual slot a extensão VEX baixará ou executará um programa de usuário clicando nele e selecionando um dos oito slots disponíveis no VEX Brain na lista de seleção.
• Ícone de download do Build & - Se um dispositivo VEX estiver conectado, o Ícone de download será exibido na barra de ferramentas. Quando clicado, o projeto será construído e, se for bem-sucedido, será baixado para o dispositivo VEX conectado.
• Ícone de reprodução - Quando clicado, o Ícone de reprodução executa o programa de usuário baixado no Slot selecionado no VEX Brain.
• Ícone de parada - Quando clicado, o Ícone de parada interrompe a execução do programa do usuário no VEX Brain.
• Seletor de Projeto - O Seletor de Projeto exibe o nome do projeto selecionado. O ícone do seletor de projeto nos permite alternar entre projetos VEX quando há vários dentro do espaço de trabalho clicando nele e selecionando um projeto na lista de seleção.
• Seletor de arquivo Python (somente Python) - Quando um projeto VEX Python é selecionado, o Seletor de arquivo Python aparecerá na barra de ferramentas. O seletor de arquivo Python exibe o nome do arquivo Python selecionado. Atualmente, o Python para VEX só oferece suporte a downloads de arquivos únicos.

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

Configurações do usuário VEX

As configurações do usuário do VEX nos permitem configurar a extensão VEX de acordo com nossas próprias necessidades. As configurações do usuário são configurações globais aplicadas a cada projeto de extensão do VEX VS Code. Podemos acessar as Configurações do Usuário VEX clicando no Ícone de Configurações no VS Code e selecionando os itens correspondentes nos menus.

As configurações do usuário VEX para configurar a extensão VEX VS Code são:

• Caminho da cadeia de ferramentas CPP - Define o caminho para a cadeia de ferramentas CPP.
• Habilitar Terminal de Usuário- Habilita ou desabilita a extensão para abrir e exibir dados da porta do usuário.
• Entradas de log - Define o número de entradas de log a serem carregadas de um VEX Brain.
• Tipo de construção de projeto - Define como a extensão construirá um projeto C++.
• Página inicial do projeto - Define o local padrão para novos projetos.
• Executar após download - Define se o programa do usuário deve ser executado após ser baixado para um VEX Brain.
• System DFU Auto Recover - Define se o Brain deve recuperar automaticamente quando um IQ (2ª geração) ou EXP Brain é detectado no modo DFU.
• Habilitar servidor Websocket - Habilita ou desabilita a extensão para iniciar o servidor Websocket.
• Endereço do host do servidor Websocket - Define o endereço do host do servidor Websocket.
• Websocket Server Port - 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.