Uma novíssima extensão do Visual Studio Code à sua disposição

4D suporta agora o Protocolo Servidor de Linguagem para permitir aos editores externos de código fonte lidar com o código 4D e fornecer-lhes funcionalidades padrão tais como realce de sintaxe, ajuda de sintaxe, ir para definição, ou digitar adiante. Vamos ver como tirar partido disso no Visual Studio Code.

Importante

Sabemos que a comunidade 4D está muito ligada ao editor de código incluído no IDE 4D. Permite-lhe desenvolver rapidamente, com tudo o que precisa à mão para construir uma aplicação comercial, sem deixar o 4D: desenhar uma estrutura de dados, ecrãs de desenho, código, testar, e recomeçar.
Com o lançamento de Projectos em 4D, abrimos a porta ao controlo de fontes e à edição de fontes 4D fora da IDE 4D.
Vemos no fórum e nas discussões que as opiniões diferem. Alguns de vós nunca pensariam em utilizar outra coisa que não seja o IDE 4D – que continuamos a melhorar o lançamento após o lançamento. Contudo, um número crescente de programadores 4D já utilizam outros editores, como o Visual Studio Code, porque nele encontram muitas vantagens: a possibilidade de abrir um projecto 4D para trabalhar na fonte 4D mas também em outras fontes (HTML ou javascript, por exemplo), ferramenta generalizada na comunidade de programadores em geral, integração com Git, etc.
É por isso que queremos tirar partido da versão 4D v19 R6 para lhe propor uma extensão do Código VS “Analisador 4D” e recolher o seu feedback sobre o mesmo. Esta extensão apenas suporta o destaque da sintaxe nesta fase, mas planeamos fornecer mais nas próximas semanas/meses: digite com antecedência e todos os benefícios que 4D poderia obter do suporte LSP.
É claro que esta iniciativa não tem impacto no seu editor de código 4D! É um apoio de reflexão, para trocar consigo sobre todas as possibilidades, e para partilhar ideias.

Esperamos que goste de o utilizar!

Renderização em Visual Studio Code

Aqui está a renderização de um ficheiro 4DM aberto em código VS quando a nova extensão é instalada, com realce de sintaxe por defeito:

Se quiser tornar o seu código ainda mais legível em VS Code, não se esqueça que pode configurar 4D para escrever os ficheiros 4DM sem fichas.

Como é que funciona?

Uma extensão VS Code para realce de sintaxe do código 4D já estava disponível, mas baseava-se no regex e limitava-se ao realce de sintaxe.

A partir da v19 R6, 4D suporta o Language Server Protocol (LSP), uma interface padrão entre editores de código e línguas.
LSP fornece várias funcionalidades comummente utilizadas nos editores de código, tais como destaque de sintaxe, ajuda de sintaxe, ir para definição, ou digitar adiante. A equipa 4D está a integrar este protocolo padrão e criou uma novíssima extensão de Visual Studio Code para tirar partido do mesmo.
Tecnicamente, quando se abre um ficheiro 4DM com código VS, a extensão lança uma instância 4D em modo headless para comunicar com o seu servidor LSP. Esta instância 4D carrega o ficheiro 4DM e o contexto para fornecer funcionalidades LSP ao editor de código VS através da extensão.

Instalar a extensão Visual Studio Code

A instalação da extensão é muito simples. Basta abrir o VS Code, o separador Extensões, e procurar a extensão “4D-Analyzer” no mercado.
Quando a encontrar, seleccione-a e clique no botão “install” (instalar).

Outra forma é descarregar a extensão 4D-Analyzer directamente do Visual Studio Code Marketplace!

Uma vez terminada a instalação, abrir as definições da extensão (o botão com o pequeno ícone de engrenagem). Na configuração do Caminho do Servidor, introduza o caminho da aplicação 4D (Servidor 4D ou Servidor 4D) que será utilizada pela extensão.

Se desenvolver em macOS, há uma limitação do SO que deve estar ciente: o sistema não lhe permitirá abrir uma instância 4D (autónoma ou Servidor) se já a tiver a funcionar com o Código VS. A solução consiste em configurar um executável distinto na extensão ou em abrir 4D antes do VSCode.

Abrir um ficheiro 4DM

Uma vez instalada e montada a extensão, é possível ver o resultado!

Dependendo de como se utiliza o Código VS, é possível abrir um único ficheiro 4DM usando o menu “Abrir ficheiro” ou um projecto inteiro usando o menu “Abrir pasta” e seleccionando a pasta do projecto. No último caso, basta clicar num ficheiro 4DM no VS Code explorer para o abrir no editor.

Ao abrir um ficheiro 4DM no editor VS Code, a extensão lançará uma instância executável 4D num modo sem cabeça que tratará do ficheiro 4DM. Assim, a instância executável 4D tratará de todo o projecto do ficheiro 4DM para carregar todo o contexto do código do projecto. E quando a janela VS Code é fechada, a instância 4D dedicada a esta janela é também fechada.

Pode ver que tudo é gerido automaticamente para si!

Um primeiro passo

Depois de instalar e configurar a extensão do Código VS, beneficiará automaticamente de outras capacidades LSP oferecidas por lançamentos 4D subsequentes. Neste momento, o passo seguinte é configurar as cores para se adequarem ao seu esquema de cores, como explicado neste post do blogue.

Estamos muito entusiasmados com esta nova extensão. Esteja à vontade para nos dar o seu feedback sobre o fórum 4D!