Olá mundo, neste artigo vou falar sobre como implementar a visão estruturada do código (Outline ou code mapper) no VsCode para AdvPL enquanto o Language Server para AdvPL não fica pronto.

Espero que goste!

Para aqueles que não sabem sobre o que este artigo se trata, vou explicar. A visão Outline ou a listagem de símbolos do VsCode é um recurso nativo do VsCode que permite encontrar os símbolos da linguagem (métodos, classes, variáveis, etc) de forma mais “rápida” e ágil.

Porém, seu funcionamento só é possível quando há implementado via Language Server os recursos para que o VsCode entenda a sintaxe e estrutura do AdvPL como qualquer outra linguagem já suportada por ele (Java Script, Type Script, …)

Sendo assim, enquanto esse recurso não fica disponível para as extensões de suporte a AdvPL advpl-vscode ou tds-vscode, existe uma forma de utilizar este “recurso” de uma outra forma, e é sobre isso que vamos falar agora.

• Como pré-requisito, você precisará instalar a extensão CodeMap.

• Instalado a extensão, baixe o arquivo de mapeamento dos símbolos AdvPL mapper_prw.js e adicione na pasta do VsCode AppData\Roaming\Code\User , ou em seu diretório de preferência.

• Baixado o arquivo, basta configurar a extensão para que ela carregue a configuração dos símbolos AdvPL da seguinte forma:

{
  "codemap.prw": "C:\\Users\\MyUSer\\AppData\\Roaming\\Code\\User\\mapper_prw.js",
  "codemap.prx": "C:\\Users\\MyUser\\AppData\\Roaming\\Code\\User\\mapper_prw.js",
  "codemap.tlpp": "C:\\Users\\MyUser\\AppData\\Roaming\\Code\\User\\mapper_prw.js",
  "codemap.textMode": false
}

Adicione o código acima nas configurações do Workspace ou de usuário do VsCode.

• Pronto, agora basta carregar um fonte AdvPL e na Activity Bar estará sendo apresentado a estrutura do código conforme hierarquia.

Clicando em cada item, o cursor do documento será posicionado para a linha ao qual ele pertence.

Fiz uma implementação recente para que os métodos das classes fiquem dispostos abaixo da assinatura da classe, isso porque em AdvPL os métodos da classe são definidos utilizando a palavra Class, e a declaração do mesmo pode estar em qualquer lugar do código.

Espero ter ajudado, em breve mais artigos explicando outros macetes que utilizo. Até a próxima!