PROGRAMANDO EM ADVPL COM

VSCODE

 05/02/2018
 Posted by: David Alves
 Category: Artigos
18 Comentários

O que é VSCode ?
O Visual Studio Code mais conhecido como VsCode, é um editor de texto multiplataforma
disponibilizado pela Microsoft para o desenvolvimento de aplicações web, com suporte
principalmente a ASP.NET 5 e Node.js. Conhecer essa ferramenta é importante para os
desenvolvedores que pretendem trabalhar em ambientes multiplataforma, por exemplo,
seguindo a tendência de desenvolvimento web em ambiente Mac e Linux, ao mesmo
tempo em que mantém o projeto compatível com Windows.

Clique Aqui para fazer o download do instalador.

Como vamos programar em AdvPL dentro do VSCode ?

Para programar em AdvPL utilizando o VSCode é necessário realizar a instalação de uma
extensão chamada advpl-vscode e configurar o ambiente. Toda configuração é feita por
meio e chaves em formato JSON, fique tranquilo que é muito simples. Esse plugin foi
desenvolvido pelo Rodrigo Silva (KillerAll – https://github.com/killerall).

Instalando a extensão.
Abra o VSCode e utilize o atalho CTRL + P e cole o seguinte comando e pressione Enter:

1 ext install advpl-vscode

Clique aqui para mais informações sobre instalações de extensões.

Requisitos para utilização.

Para utilizar os recursos de compilação e debug no VSCode é necessário que o AppServer

esteja na build 131227A ou superior, a partir dessa versão de binário tanto o Protheus 11 e
12 são suportados.
Observação: Essa extensão ainda não está disponível no Linux. Em OSX o suporte do editor
e do debug já esta funcional.

Configurando VSCode.
Abra o VSCode e acesse a opção: File / Preferences / Settings

Será aberto a tela de configuração, no lado esquerdo é apresentado as possíveis

configurações que poderão ser feitas, no lado direito são as configurações realizadas. As
configurações que estão marcadas na imagem abaixo, estão relacionadas diretamente a
extensão advpl-vscode.
Modelo de configuração:

1 {
2 "editor.fontSize": 13,
3 "files.encoding": "windows1252",
4 "advpl.environments":[
5 {
6 "smartClientPath":"C:\\CAMINHO\\PARA\\PASTA\\SMARTCLIENT\\",
7 "environment":"NOME_DO_AMBIENTE",
8 "includeList":"C:\\CAMINHO\\PARA\\PASTA\\INCLUDES\\",
9 "server":"ENDEREÇO_DO_APPSERVER",
10 "port":"PORTA_DE_CONEXAO",
11 "user":"USUÁRIO_PROTHEUS",
12 "passwordCipher":"SENHA_CRIPTOGRAFADA"
13 }
14 ],
15 "advpl.selectedEnvironment": "NOME_DO_AMBIENTE",
16 "advpl.startProgram": "SIGAMDI"
17 }

Exemplo de configuração:
1
2
3
4{
5 "editor.fontSize": 13,
6 "files.encoding": "windows1252",
7 "advpl.environments":[
8 {
9 "smartClientPath":"C:\\protheus\\Protheus11\\Protheus\\BIN\\Smartclient\\",
1 "environment":"DAVID",
0 "includeList":"C:\\Users\\david.santos\\Documents\\TDS\\Workspace\\Includes\\",
1 "server":"localhost",
1 "port":"1234",
1 "user":"david.santos",
2 "passwordCipher":"WTR2YVZ4akFWWHd6eC81NDUyZWY0blhUQ2s1dGt0UkpObkRWQnh2TUxWZlZ0T
1 0tjSUErNHlJU2tYQzg0eExsa0tia3RNdVhxMlBUZmRhYzR5TllNNmhMTnFJeUhENE9VVW5LUllrWWtxMXJyY
3 StQdDVzUGJ1eDNGclVFMnFxa2w="
1 }
4 ],
1 "advpl.selectedEnvironment": "DAVID",
5 "advpl.startProgram": "SIGAMDI"
1}
6
1
7

Configuração de Ambiente:

 files.encoding: utilizar o encode windows1252

 advpl.selectedEnvironment: Ambiente atualmente selecionado.
 advpl.startProgram: Módulo ou função que será sugerido no launch do Debug.
 advpl.environments: Configuração dos ambientes Protheus.
o smartClientPath: Caminho para pasta smartclient.
o environment: Ambiente em que será compilado os fontes.
o includeList: Caminho para pasta includes.
o server: Endereço da maquina onde esta o AppServer.
o port: Numero da porta de conexão.
o user: Usuário utilizado para logar no Protheus.
o passwordCipher: Senha utilizada para logar no Protheus.
Criptografando a senha de login Protheus.

Para criptografar a nossa senha de login, precisamos utilizar o VS Code Quick Open (Atalho:
CTRL + P) digitar o comando abaixo e teclar Enter:

1 >cipher
O VSCode irá pedir para que você informe a senha que deseja criptografar, digite a senha
que você utiliza para se logar no Protheus e tecle Enter. Após esse procedimento ele irá
gerar a sua senha criptografada e apresentar a mesma no Output conforme imagem
abaixo:

Após obter a sua senha criptografada, basta informar a mesma dentro da

chave “passwordCipher”

Compilação:
Neste momento já possível realizar compilações em nosso ambiente, crie um arquivo
chamado VsCode.prw e cole o código abaixo:
1 #Include 'Protheus.ch'
2
3 User Function VsCode()
4
5 MsgInfo("Teste VsCode com AdvPL!","SigaMDI.net")
6
7 Return
Salve o arquivo e tecla CTRL + F9 para realizar a compilação, e tudo estiver correto a
mensagem abaixo sera apresentado no Output:

Execução:
Para executar a função que acabamos de criar, basta teclar F5 e informar o nome da função
(u_VsCode) e em seguida teclar Enter

Se tudo estiver OK, a mensagem abaixo será apresentada.

Informações importantes:

A extensão advpl-vscode, foi desenvolvida recentemente e com isso pode surgir alguns
problemas ao utiliza-lo, mas a versão utilizada neste tutorial já está muito funcional.
A iniciativa para o desenvolvimento dessa ferramenta é espetacular e recomendo a todos
utilizar esta extensão para ajudar na evolução desse projeto.