TOTVS Developer Studio for VSCode (AdvPL, TLPP e 4GL) installs statistics

TOTVS Developer Studio para VSCode

A extensão do TOTVS Developer Studio for VS Code disponibiliza uma suíte de desenvolvimento para o ecossistema Protheus/Logix.

Utilizando os protocolos de comunicação LSP (_Language Server Protocol_) e DAP (_Debug Adapter Protocol_), ambos amplamente utilizados e extensíveis à outras _IDEs_ de mercado, como Atom, Visual Studio, Eclipse, Eclipse Theia, Vim e Emacs.

Lista de IDEs com suporte ao LSP e ao DAP.

A extensão TDS-VSCode somente é suportada por S.O. de 64 bits.

Funcionalidades

• Sintaxe destacada • Comunicação baseada nos protocolos LSP/DAP • Linter para análise de código estático • Console informativo e notificações • Edição, Formatação e Navegação de arquivos fontes (AdvPL, TLPP, 4GL e variantes) • Compilação de fontes, pastas e da área de trabalho • Depuração e execução (Local e _WebApp_) • TDS Replay - Depuração de execução pré-gravada. • Geração e aplicação de pacotes de atualizações (_patches_) • Manutenção do _RPO_ • Inspeção do _RPO_ • Geração de cliente de serviço web (_Web Service_) • Monitoramento de servidores • RPO Seguro • TDS-Cli compilação por linha de comando. Da mesma forma que o Eclipse, essa extensão do VSCode possui uma ferramenta de compilação em linha de comando. • Navegação em código • Configurações da extensão (chaves totvsLanguageServer) • API

SOBRE O USO DE CHAVES E TOKENS DE COMPILAÇÃO

As chaves de compilação ou _tokens_ de compilação empregados na construção do _Protheus/Logix_ e suas funcionalidades, são de uso restrito dos _desenvolvedores_ de cada módulo.

Em caso de mau uso destas chaves ou tokens, por qualquer _outra parte_, que não a referida acima, a mesma irá se responsabilizar, direta ou regressivamente, única e exclusivamente, por todos os prejuízos, perdas, danos, indenizações, multas, condenações judiciais, arbitrais e administrativas e quaisquer outras despesas relacionadas ao mau uso, causados tanto à TOTVS quanto a terceiros, eximindo a TOTVS de toda e qualquer responsabilidade.

Interoperabilidade entre sistemas operacionais

Para melhor interoperabilidade do ecosistema Protheus (áreas de trabalho, _smartClient_, _appServer_ e demais componentes) entre os sistemas operacionais suportados pelo TDS-VSCode e seus componentes, recomenda-se veementemente que pastas e arquivos não contenham caracteres especiais e/ou acentuados e sempre em mínusculas.

Leia Convenção para nomenclatura de _File System_ em ambiente _Linux_.

Guia rápido

O VS Code pode apresentar problemas em suas funcionalidades em sistemas operacionais da linha Windows Server. Veja os requisitos para uso do VS Code em Requirements.

Nunca usei o VS Code: Recomendamos a leitura de: - User Interface - Multi-root Workspaces - Settings - Basic Edition - Marketplace

Ao iniciar o VS Code com a extensão TDS-VSCode instalada, abra (ou crie) a pasta principal que contém (ou conterá) seus arquivos fontes e de recursos. Essa pasta é denominada genericamente de projeto.

No primeiro uso da extensão em um projeto, lhe será apresentada as Boas Vindas com configurações mínimas necessárias. Faça-as.

• Acione o ícone da TOTVS na barra de atividades • Registre o servidor de trabalho na visão (Servidores)[docs/servers.md], acionando a ação + • (Conecte-se)[docs/servers.md] ao servidor recém registrado • Após a conexão, acione na barra de atividades o ícone do Explorer • Abra (ou crie) o arquivo para edição e faça o desenvolvimento necessário • (Compile)[docs/compilation.md] acionando o atalho ctrl+F9 ou o menu de contexto sobre o arquivo ou recurso • Corrija eventuais erros de compilação apresentados na visão Problems • (Execute/depure)[docs/debugging.md] o Smartclient configurado na página de Boas vindas ou direto no arquivo .vscode\launch.json

Para detalhes dos processos, acesse as ligações (_links_).\ A visualização ou não das Boas Vindas pode ser efetuada em File | Preferences | Settings | Extensions | TOTVS | Welcome Page.

Saiba mais em

TOTVS - Extensão de desenvolvimento para VSCode (TEC) - Parte 1\ TOTVS - Extensão de desenvolvimento para VSCode (TEC) - Parte 2\ TOTVS - TDS-VSCode - Desenvolvimento colaborativo (TEC)

Acentuação e caracteres especiais nos códigos fontes

Tivemos notificações de problemas de _encode_ abrindo fontes antes salvos no *TDS*, isso ocorre porque o _encode_ original do VSCode é UTF8 e o do TDS-VSCode é outro. Para garantir a compilação é necessário compatibilizar o _encode_ da seguinte maneira:

• No estado original o fonte será mostrado desta maneira: • Antes de editar/salvar qualquer fonte no VS-Code entre nas configurações (Ctrl + ,). • No campo de busca digite _encode_ e selecione Windows1252 ou Windows1251, se utilizar alfabeto cirílico. • Abra o fonte com o novo _encode_ (reforçando que NÃO DEVE tê-lo salvo antes em UTF8) • Compile e/ou recompile o fonte e execute-o.

Por padrão, o _TDS-VSCode_ já vem configurado para usar o _encode_ Windows1252 (cp1252).

Desenvolvimento Colaborativo

• Se deseja contribuir com o desenvolvimento do plugin, acesse Git Hub TDS-VSCODE, faça seu commit que iremos analisar!

Extensões recomendadas

• Numbered Bookmarks

Permite uso de _bookmarks_ no estilo Delphi numerados de 1 a 9.

• Protheus.DOC

Suporte aos recursos e snippets de documentação TOTVS ProtheusDoc para VsCode.

Extensões com incompatibilidade

As extensões abaixo não devem ser utilizadas junto com o _TDS-VS-Code_ porque podem causar mal funcionamento.

• 4gl Outline Dxc • advpl-vscode • flutter e dart

Caso você perceba que alguma outra extensão de terceiros está interferindo no _TDS for VS-Code_, favor abrir um chamado informando detalhes da extensão e o problema causado.

Suporte

Capturador de Logs

Caso tenha problemas com a ferramenta e deseja suporte da equipe de desenvolvimento da extensão, inicie uma ferramenta de coleta de _logs_ para auxiliar no suporte. Essa ferramenta colhe informações como versões de ferramentas e extensões, sistema operacional, configuração de servidores e etc.…

Description from the VS Code Marketplace listing.