Visão geral da interface do usuário 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 usuário). A extensão suporta o desenvolvimento de projetos C++ e Python para plataformas VEX IQ 2ª geração, EXP e V5.

Layout da interface do usuário da extensão de código VEX VS

A IU da extensão de código do VEX Visual Studio é dividida em cinco áreas principais: Barra de atividades, Barra lateral, Editor, Painel de terminal 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 fornecem indicadores adicionais específicos do contexto para o desenvolvimento do projeto VEX.

Os ícones comuns usados 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 visualizações que nos permitem usar as ferramentas integradas no VS Code. As visualizações comuns da barra lateral usadas para executar tarefas de desenvolvimento de projetos VEX são Extension View, VEX Viewe Explorer View.

Exibição de extensão

O Extension View é usado para instalar e gerenciar as extensões no VS Code. Para desenvolver software nas plataformas VEX IQ 2ª geração, EXP e V5, precisamos 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 VEX

O VEX View nos permite desenvolver projetos para VEX IQ 2ª Geração, EXP e V5 em VS Code. Existem três categorias incluídas na visualização VEX: 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 usados para criar um novo projeto VEX ou importar um projeto VEXcode existente.
Para obter orientação detalhada 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º).

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. Ele nos permite capturar a tela do VEX Brain, visualizar o registro de eventos do VEX Brain, usar o V5 Battery Medic, definir o nome do cérebro e número da equipee apagar o programa do usuário do VEX Cérebro.

Quando um VEX Brain está conectado ao computador, a categoria VEX DEVICE INFO mostra se um VEX Controller está vinculado ao VEX Brain e nos permite atualizar o VEXos para o VEX Brain se a versão VEXos do VEX Brain for desatualizado.

Quando um VEX Controller está conectado ao computador, a categoria VEX DEVICE INFO mostra se um VEX Brain está vinculado ao VEX Controller e nos permite atualizar o VEXos para o VEX Controller se a versão VEXos do VEX Controller for desatualizado.

Para obter uma descrição abrangente das informações do dispositivo e como usar os recursos 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 o uso do VEX FEEDBACK no VS Code, consulte este artigo.

Visualização do Explorador

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 os arquivos 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.

Na área 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 desta função incluída na API C++ e Python (Application Programming Interface ).

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

Painel Terminal

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

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

Terminal Interativo - O Terminal Interativo tem duas funções - exibir registros de impressão e enviar pressionamentos de teclas brutos de volta para um programa do usuário.

Nota: Para utilizar o terminal interativo, um cérebro ou controlador deve estar conectado a um computador executando a extensão de código VEX VS.
Nota: A saída do terminal interativo é limpa por padrão após a construção e 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 é aquele 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:

Device Picker - O Device Picker exibe o ícone do dispositivo VEX conectado (um ícone Brain ou um ícone de controlador )
Nota: 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 próximo ao ícone do controlador.

Ícone seletor de slot - O ícone seletor slots nos permite escolher em qual slot a extensão VEX irá baixar ou reproduzir um programa do usuário clicando nele e selecionando um dos oito slots disponíveis no VEX Brain na lista de seleção.
Build Icon- Se um dispositivo VEX não estiver conectado, o Build Icon será exibido na barra de ferramentas. Quando clicado, o projeto apenas será compilado.
Ícone de download - Se um dispositivo VEX estiver conectado, o Ícone de download será exibido na barra de ferramentas. Quando clicado, o projeto será compilado e, se for bem-sucedido, será baixado para o dispositivo VEX conectado.
Ícone Play - Quando clicado, o ícone Play executa o programa do usuário baixado no slot selecionado no VEX Brain.
Ícone Stop - Quando clicado, o ícone Stop 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 existem vários dentro do espaço de trabalho clicando nele e selecionando um projeto na lista de seleção.
Seletor de arquivos Python (somente Python) - Quando um projeto VEX Python for selecionado, o Seletor de arquivos Python aparecerá na barra de ferramentas. O Python File Selector exibe o nome do arquivo Python selecionado. Atualmente, Python para VEX oferece suporte apenas para downloads de arquivo único.

Para obter informações úteis

Configurações do usuário VEX

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

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

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

Cpp Toolchain Path – Define o caminho para o CPP Toolchain.
Habilitar Terminal de Usuário- Habilita ou desabilita o ramal 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.
Project Build Type – Define como a extensão construirá um projeto C++.
Project Home - 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 se recuperar automaticamente quando um IQ2 ou EXP for detectado no modo DFU.
Websocket Server Enable - Habilita ou desabilita a extensão para iniciar o Servidor Websocket.
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 acessar e definir as configurações do usuário VEX, este artigo.