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.
- Sintaxe destacada
- Comunicação baseada nos protocolos LSP/DAP
- Linter - analisador de código estático
- 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.
O VS-Code pode apresentar problemas em suas funcionalidades em sistemas operacionais da linha Windows Server. Veja os requisitos para uso em Requirements.
Nunca usei o VS-Code: Recomendamos a leitura de:
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 deBoas vindas
ou direto no arquivo.vscode\launch.json
Para detalhes dos processos, acesse as ligações (links).
A visualização ou não dasBoas Vindas
pode ser efetuada emFile | Preferences | Settings | Extensions | TOTVS | Welcome Page
.
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)
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 selecioneWindows1252
ouWindows1251
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
.
- Se deseja contribuir com o desenvolvimento do plugin, acesse Git Hub TDS-VSCODE, faça seu commit que iremos analisar!
-
Permite uso de bookmarks no estilo Delphi numerados de 1 a 9.
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
, digiteTOTVS: On Logger Capture
. Nesse momento o capturador de log será iniciado. -
Reproduza o problema e selecione a opção
CTRL + SHIFT + P
digiteTOTVS: Off Logger Capture
ou na Barra inferior clique sobre o textoCapturando logs...
. O capturador será encerrado e um arquivo chamadotdsSupport.zip
será gerado. Anexe esse arquivo ao chamado.
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.5 , 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.
Se você sentiu a falta de alguma funcionalidade deixe sua idéia registrada. Ou se preferir colabore conosco e faça você mesmo. Veja como colaborar a seguir.
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 S.A. 🚧 🔌 📆 |
-
Permite uso de bookmarks no estilo Delphi numerados de 1 a 9.
As extensões abaixo não devem ser utilizadas junto com o TDS for VS-Code porque podem causar mal funcionamento.
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.