Skip to content

Latest commit

 

History

History
51 lines (29 loc) · 3.31 KB

linter.md

File metadata and controls

51 lines (29 loc) · 3.31 KB
Raw

TDS: Linter

Requisitos

  • projeto aberto
  • diretório de includes configurado

Recomenda-se que pastas e arquivos não contenham caracteres especiais e/ou acentuados e sempre em mínusculas de forma a manter a compatibildade entre os diversos sistemas operacionais suportados pelo TDS-VSCode e seus componentes. Leia [Convenção para nomenclatura de File System em ambiente Linux]https://tdn.totvs.com/x/h8BICw).

O Linter é um analisador de código estático que aponta erros de programação em seu código durante a edição ou em segundo plano. Ele apresenta os problemas encontrados no próprio editor e também na visão de Problemas.

Linter

Este recurso ajudará o desenvolvedor a identificar problemas antes de efetuar a compilação no AppServer, auxiliando-o a eliminar avisos (warnings), pois estes já serão identificados mesmo antes de sua compilação.

Comportamento do linter

Para alterar o comportamento do linter, acesse as configurações da extensões (Settings), acessando na árvore da visão settings, extensions + TOTVS.

Comportamento do linter

Onde:

  • enable: habilita o processo em todos os fontes da área de trabalho.
  • enableOnlyOpenFiles: habilita o processo somente nos arquivos em edição (padrão) e mantem o comportamento como nas versões anteriores.
  • disable: desabilita o processo.

Includes

Como em qualquer compilação de um fonte AdvPL é necessário que o diretório de Includes esteja configurado corretamente para que o processo funcione corretamente.

Caso ocorra o erro C2090 File not found PRTOPDEF.CH, é provável que o diretório de Includes não esteja configurado corretamente. Revise as configurações conforme indicado em Configuração de Include.

Arquivos 4GL e PER (Logix):

Para a correta análise desses arquivos o Linter necessita do arquivo .SCH (Scheme do banco de dados, normalmente logix.sch). A busca por esse(s) arquivo(s) é feita na(s) pasta(s) de include configurada(s).

Marcações

As marcações de problemas serão apresentadas no próprio Editor e também na visão de Problemas em tempo de edição.

Se for encontrado um erro crítico no código ele será destacado com a cor vermelha (padrão) no Editor e não indicará mais nenhum outro erro até que este seja sanado.

Caso contrário, se não houve erro crítico, ele apresentará avisos (warnings) se existirem e recomenda-se que os mesmos sejam sanados.

Compilação

Com o Linter teremos as mesmas questões que seriam detectadas somente após a compilação do fonte, então se houver uma indicação de erro e/ou warning eles serão os mesmos quando o fonte for compilado.

Se perceberem algum comportamento estranho no Linter realize a compilação do fonte. Caso o comportamento persista na compilação, favor abrir um chamado diretamente na TOTVS informando o problema encontrado na compilação para que o time do AppServer possa avaliar a questão. Quando o problema for solucionado pelo time de AppServer o Linter receberá a correção nas próximas atualizações da extensão.