TOTVS Developer Studio Code

O plugin do TOTVS Developer Studio Code disponibiliza uma suíte de desenvolvimento para o ecossistema Protheus. Ele utiliza 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. Lista de IDEs com suporte ao DAP.

Funcionalidades

Syntax Highlight
Comunicação baseada nos protocolos LSP/DAP.
Compilação de fontes, pastas e da área de trabalho.
Depuração de fontes (Local e WebApp).
Geração de Patch.
Aplicação de Patch.
Deleção de fontes do RPO.
Desfragmentação do RPO.
Inspetor de objetos do RPO.
Inspetor de funções do RPO.
Geração de WS Protheus.

Configurações Gerais

Tela de boas vindas

A tela da boa vindas permite configurar a localização do SmartClient e dos diretórios de Includes que serão utilizados durante a compilação dos códigos fontes.
Esta tela será apresentada na primeira execução do plugin, assim que o primeiro fonte AdvPL for aberto.
Localize o SmartClient.exe (Windows) ou smartclient (Linux).
Localize os diretórios de Includes que necessitar para seus projetos.
Pressione o botão Salvar para concluir.

Cadastro de servidores utilizando o assistente

Clique no icone "+" no canto superior direito da visão, ao lado da aba Servidores.
Preencha as informações de nome, ip e porta do servidor.
Clique no botão Salvar.
Existe o atalho que para abertura do assistente: CTRL + SHIFT + P digite TOTVS: Add Server.

Conexão com servidores

Após executar o cadastro de ao menos um servidor.
Vá para visão de servidores (Acesso pelo ícone da TOTVS na lateral esquerda do VSCode).
Clique com o botão direito e selecione a opção Connect.
Informe ambiente, usuário e senha (pode ser "em branco") para prosseguir.
Aguarde o termino da conexão.
A conexão com servidores pode ser efetuada pela seleção do texto [Selecionar servidor/ambiente] na barra de ferramentas. Ou pelo atalho CTRL + SHIFT + P digite TOTVS: Select Server.

Configurações de Debug

Criando manualmente uma configuração de debug

O arquivo launch.json será criado automaticamente através da Tela de Boas Vindas.
Caso haja problemas com este arquivo você pode criá-lo manualmente através dos seguintes passos:
- Selecione a seção Debug no painel esquerdo do VSCode.
- Selecione na parte superior desta tela a opção Add Configuration....
- Comece a digitar TOTVS e selecione o tipo desejado
  - Tipo: totvs_language_debug, usa o SmartClient Desktop. Preencha o arquivo launch.json de acordo com seu ambiente e necessidas, como no exemplo abaixo.

{ "type": "totvs_language_debug", "request": "launch", "name": "Totvs Language Debug", "program": "${command:AskForProgramName}", "cwb": "${workspaceFolder}", "smartclientBin": "/home/mansano/_c/totvs12/bin/smartclient/smartclient" }

* Tipo: _totvs_language_web_debug_, usa o SmartClient Html.
  Preencha o arquivo `launch.json` de acordo com seu ambiente e necessidas, como no exemplo abaixo..

{ "type": "totvs_language_web_debug", "request": "launch", "name": "Totvs Language Debug", "program": "${command:AskForProgramName}", "cwb": "${workspaceFolder}", "smartclientUrl": "http://localhost:8080" }

Nota: Abra o arquivo settings.json e informe a chave "", com o caminho completo do seu navegador web.

{ "totvsLanguageServer.welcomePage": false, "totvsLanguageServer.web.navigator": "C:\Program Files\Mozilla Firefox\firefox.exe" }

Criando uma configuração de debug com assistente

Para abrir o assistente de nova configuração de debug, pressione o atalho CTRL + SHIFT + P e digite TOTVS: Configure Launchers.
Será aberto um assistente de configuração de launcher que permite criar uma nova configuração ou editar uma configuração já existente.
Preencha as informações e clique em Save.

Iniciando um debug

Caso necessário, verifique se os dados do arquivo launch.json estão corretos.
Conecte-se a um servidor previamente cadastrado.
Pressione o atalho F5 para iniciar o debug.
Caso necessário abrir o launch.json novamente, Selecione a seção Debug no painel esquerdo do VSCode
E por fim no ícone de configuração na parte superior Open launch.json, representado pelo icone de uma engrenagem.
Será exibido um campo para digitação do fonte que deseja depurar, ex: u_teste.
Pressione Enter para iniciar a depuração.

Usando Debug Console

É possível verificar os valores de variáveis e executar métodos durante o debug com o Debug Console.
Coloque um breakpoint em um ponto necessário de seu fonte.
Quando a depuração "parar" ao breakpoint, abra a visão Debug Console na parte inferior da tela.
Digite uma operação ou variável AdvPL disponivel em seu ambiente de depuração.
Analise os dados retornados de acordo com sua necessidade.

Patch

Gerando um Patch (From RPO) utilizando o assistente.

Para gerar um patch conecte-se ao servidor.
Selecione com o botão direito do mouse o servidor conectado.
Selecione a opção Patch Generation (From RPO).
Existe um atalho para a abertura da página: CTRL + SHIFT + P digite TOTVS e selecione a opção TOTVS: Patch Generation (From RPO).
Aguarde a carga dos arquivos do inspetor de objetos.
Selecione os arquivos que desejar para o patch utilizando o campo de Filtro.
Para digitar o filtro simplesmente saia do campo ou pressione Enter.
Selecione agora os arquivos na lista da esquerda e mova os desejados para lista da direita utilizando o botão ">>".
Repita o processo até que tenha selecionado todos os arquivos necessários.
Selecione agora o diretório onde deseja salvar o Patch.
Escolha o nome do arquivo de Patch desejado. (Quando não informado, o patch será gerado com o nome do RPO).
Efetue e geração do Patch pressionando o botão Gerar.

Gerando um Patch (From Folder) utilizando o menu de contexto

Para gerar um patch conecte-se ao servidor.
Clique com o botão direito em cima da pasta de contém os fontes que farão parte do patch.
Selecione a opção Patch Generation (From Folder).
Abrirá uma janela para selecionar onde deseja que o fonte seja salvo. Selecione um pasta.
Uma janela será aberta para coletar o nome do patch que será gerado. (Quando não informado, o patch será gerado com o nome do RPO).
Após as confirmações o patch será gerado no caminho desejado.

Aplicando Patch utilizando o assistente

Para aplicar um patch conecte-se ao servidor.
Selecione com o botão direito do mouse o servidor.
Selecione a opção Patch Apply.
Existe um atalho para a abertura da página: CTRL + SHIFT + P digite TOTVS e selecione a opção TOTVS: Patch Apply.
Os campos de servidores são preenchidas automaticamente com as informações do servidor conectado.
No campo Patch File selecione o patch que deseja aplicar.
Confirme a aplicação.

Aplicando Patch utilizando o menu de contexto

Para aplicar um patch conecte-se ao servidor.
Selecione o patch com o botão direito do mouse.
Selecione a opção Patch Apply from file.
Confirme a aplicação e o patch será aplicado.

RPO

Desfragmentação de RPO

Para desfragmentar um RPO conecte-se ao servidor.
Selecione o servidor com o menu de contexto e seleciona a opção Defrag RPO.
Também é possível selecionar a opção pelo atalho CTRL + SHIFT + P digitando TOTVS: Defrag RPO.
As mensagens de inicio e fim da desfragmentação serão exibidos no canto inferior direito.

Deletar recursos do RPO

Para deletar algum recurso do RPO, conecte-se ao servidor.
Com o menu de contexto em cima do arquivo que deseja excluir, selecione a opção Delete File/Resource from RPO.
Confirme a exclusão.
A confirmação da exclusão será exibida no console e em mensagens no canto inferior esquerdo.

Inspetor de Objetos do RPO

Para visualizar os arquivos que fazem parte do RPO, conecte-se ao servidor.
Com o menu de contexto em cima do servidor, selecione a opção Inspector of the Objects.
Abrirá um assistente com todos os arquivos que fazem parte do RPO, utilize o filtro para encontrar algum arquivo específico.
Também é possível abrir o assistente pelo atalho CTRL + SHIFT + P digitando TOTVS: Inspector of the Objects.

Inspetor de Funções do RPO

Para visualizar as funções que fazem parte do RPO, conecte-se ao servidor.
Com o menu de contexto em cima do servidor, selecione a opção Inspector of the Functions.
Abrirá um assistente com todos as funções que fazem parte do RPO, utilize o filtro para encontrar alguma função específica.
Também é possível abrir o assistente pelo atalho CTRL + SHIFT + P digitando TOTVS: Inspector of the Functions.

Configurações de Compilação

Compilando Function e Main Function com Chave de compilação

Este processo está sendo revisto e pode sofrer alterações.
Este processe só é válido para Windows.
Para aplicar uma chave de compilação, clique com o botão direito na visão de servidores e selecione a opção Compile key.
Abrirá um assistente para selecionar a chave que deseja. Todos os arquivos .aut podem ser selecionados.
Também é possível abrir o assistente pelo atalho CTRL + SHIFT + P digirantando TOTVS: Compile Key.
Após selecionar a chave, ela será lida e os campos preenchidos com suas informações.
Clique sobre o botão de Validate para verificar se a chave é válida.
OBS: A chave só será salva ao clicar no botão Save ou Save/Close caso a chave seja válida.

Configuração de Include

Na visão de servidores, clique com o menu de contexto e selecione a opção Include.
Também é possível configurar pelo assistente: CTRL + SHIFT + P digite TOTVS: Include.
As configurações de include ficam no arquivo %USERHOME%/.totvsls/servers.json. Abra esse arquivo.
Já existe por padrão o diretório "C:/totvs/includes".
Para adicionar uma nova configuração de include separe por vírgula ou substitua o path existente. Ex:"includes": ["C:/totvs/includes1","C:/totvs/includes2", "C:/totvs/includes3"].

Arquivos do pré compilador

Para manter os arquivos gerados pelo pré-compilador, habilite a opção nas preferencias em: File | Preferences | Settings | Extensions | AdvPL | Leave PPO File.
Caso queira um log completo das operações efetuadas pelo pré-compilador, habilite a opção: File | Preferences | Settings | Extensions | AdvPL | Show Pre Compiler.

Geração de Client WS Protheus

É possível gerar arquivos ADVPL a partir de clients WSDL.
Abra o assistente com o atalho CTRL + SHIFT + P e digite TOTVS: Generate WS Protheus.
Preencha o campo URL, selecione um diretório e escreva o nome e extensão do arquivo protheus que será gerado no diretório especificado.
Após preencher, uma mensagem de sucesso avisará que tudo foi criado corretamente.

Suporte

Capturador de Logs

Caso tenha problemas com a ferramenta e deseja suporte da equipe de desenvolvimento do plugin, inicie uma ferramenta de coleta de logs para auxiliar no suporte. Essa ferramenta colhe informações como versões de ferramentas e plugins, sistema operacional, versão do VSCode, 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.... Os capturador será encerrado e um arquivo chamado tdsSupport.zip será gerado. Anexe esse arquivo ao chamado.

Desenvolvimento Colaborativo

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

Plugins recomendados

Numbered Bookmarks.

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

https://marketplace.visualstudio.com/items?itemName=alefragnani.numbered-bookmarks

Ukoe001/tds-vscode