TOTVS Developer Studio para VSCode

GitHub

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

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.

Funcionalidades

Sintaxe destacada
Comunicação baseada nos protocolos LSP/DAP
Console informativo e notificações
Edição e Formataçã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)
Geração e aplicação de pacotes de atualizações (patchs)
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.

Guia rápido

Nunca usei o VS-Code: Recomendamos a leitura de:

User Interface

Multi-root Workspaces

Settings

Basic Edition

Marketpalce

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 icone da TOTVS na barra de atividades
Resgistre 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 icone 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

Tivemos reportes de problemas de encode abrindo fontes antes salvos no TDS, isso ocorre porque o encode original do VSCode é UTF8 e o do TDS é 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 entre nas configurações do VS Ctrl + ,.
No campo de busca digite _encode_ e selecione Windows1252 ou Windows1251 se utilizar alfabero 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 WindowsCP1252.

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.

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.

Para ativa-la, selecione pelo atalho CTRL + SHIFT + P, digite TOTVS: On Logger Capture. Nesse momento o capturador de log será iniciado.
Reproduza o problema e selecione a opção CTRL + SHIFT + P digite TOTVS: Off Logger Capture ou na Barra inferior clique sobre o texto Capturando logs.... O capturador será encerrado e um arquivo chamado tdsSupport.zip será gerado. Anexe esse arquivo ao chamado.

Logger

Resolução de problemas

Alguns problemas conhecidos e como resolvê-los.

Ocorrência	Solução
Aplicação de pacotes de atualização(patchs)
Servidores `Lobo Guara`, versão iqual ou anterior a `19.3.0.4`, podem apresentar mensagem de erro no processo de validação e mesmo assim aplicá-lo.	Atualizar o servidor para versão mais recente.

Se não conseguir resolvê-los, abra um chamado com o maior número de informações possíveis e incluindo os logs gerados conforme instruído em TROUBLESHOOTING.

Melhorias

Se você sentiu a falta de alguma funcionalidade deixe sua idéia (registrada)[https://github.com/totvs/tds-vscode/issues/new?assignees=&labels=&template=feature_request.md&title=]. S Ou se preferir colabore conosco e faça você mesmo. Veja como colaborar a seguir.

Desenvolvimento Colaborativo

Para contribuir com o desenvolvimento da extensão, acesse Git Hub TDS-VSCODE, faça um fork do projeto, crie um chamado "Pull Request" que iremos analisar!

TOTVS - TDS-VSCode - Desenvolvimento colaborativo

Mantenedor

_{TOTVS S.A.}
🚧 🔌 📆

Colaboradores

_{Alan Cândido} 💻 📖	_lwtnb-wrk 💻 📖	_{DanielYampolschi} 💻 📖	_{Matheus Sales} 💻 📖	_Mansano 💻 📖	_{Acacio Egas} 💻
_{Daniel Otto Bolognani} 💻	_{Leo Watanabe} 💻 📖	_{Rogério Ribeiro da Cruz} 💻	_{Robson William} ⚠️	_{FELIPE CAIADO ALMEIDA} 🐛	_isaquerochak 🐛
_{Rodrigo Gonçalves} 🐛	_{Rogério A. Morais} 💻	_alexmmartins 📖	_{Guilherme Bigois} 📖