Como instalar e configurar o VS Code com AdvPL

Para quem quer outra opção sem ser o TDS para substituir o Dev Antigo, hoje vou mostrar como instalar e configurar o Visual Studio Code junto com o AdvPL.


Essa integração foi criada para que programadores utilizassem uma plataforma mais leve que o TDS (que veio do Eclipse). O VS Code está sendo cada vez mais difundido e utilizado em São Paulo e em outras regiões.

A documentação da integração do AdvPL com o VS Code pode ser visualizada clicando aqui.

Instalando o VS Code

1. Fazer o download através do link – code.visualstudio.com/download

Download do Visual Studio Code

2. Prossiga com a instalação e marque as opções que desejar

Opções da Instalação

Adicionando Extensões

3. Clique na área de Extensões

Procurando extensões

4. Procure por “Portuguese (Brazil) Language Pack” e clique em Install

Extensão para deixar em português o VS Code

5. Faça o mesmo procedimento, agora procurando por “AdvPL” e clique em Install

Extensão do AdvPL

Criando e configurando um projeto em AdvPL

6. Clique em Arquivo > Salvar Espaço de Trabalho Como, e escolha um diretório para salvar sua Workspace

Salvar Workspace

7. Crie um código fonte qualquer, que iremos testar mais para frente

Criando um fonte de exemplo

//Bibliotecas
#Include "Protheus.ch"

/*/{Protheus.doc} zTeste2
Função de Teste para o VS Code
@type  Function
@author Atilio
@since 20/01/2019
@version 1.0
@example
u_zTeste()
/*/
User Function zTeste2()
Local aArea := GetArea()

//Mostrando uma mensagem
Alert("Mensagem de Teste - VS Code")

RestArea(aArea)
Return

8. Abra o arquivo de configuração da workspace, cole o conteúdo abaixo, e altere as definições de diretórios, serviço e porta. A senha por enquanto pode deixar como 123. Abaixo eu configurei 2 ambientes de teste.

Configurando os ambientes

{
	"folders": [
		{
			"path": "."
		}
	],
	"settings": {
		
		"advpl.environments":[{
				"smartClientPath": "E:\\TOTVS\\Smartclient\\",
				"environment": "TESTE1",
				"includeList": "E:\\TOTVS\\TOTVS Developer Studio\\Include\\",
				"server": "localhost",
				"port": "1235",
				"user": "Admin",
				"passwordCipher": "123"
			},
			{
				"smartClientPath": "E:\\TOTVS\\Smartclient\\",
				"environment": "TESTE2",
				"includeList": "E:\\TOTVS\\TOTVS Developer Studio\\Include\\",
				"server": "localhost",
				"port": "1235",
				"user": "Admin",
				"passwordCipher": "123"
			}]
	}
}

9. No canto inferior direito, clique em Ambiente, e escolha um Environment que você configurou

Selecionando ambiente

10. Agora pressione o atalho Ctrl + P, digite “>cipher” (sem aspas) e pressione enter, depois digite a senha de login do usuário que você configurou no passo 8

Utilizando o cipher

11. Copie a senha gerada e cole no lugar daquele 123 que deixamos no passo 8

Pegando a senha gerada

12. Compile o fonte com o atalho Ctrl + F9, e execute o Protheus com o atalho Ctrl + F11

13. Teste a rotina em algum lugar do sistema para ver se deu certo

Testando função no Protheus

14. Para ver algumas opções disponíveis do Advpl, pressione Ctrl + P, e digite “>advpl” (sem aspas)

Opções do AdvPL

Configurando SVN (Opcional)

15. Na parte de Extensões, procure SVN e instale

Extensão SVN

16. Pressione Ctrl + P e digite “>svn” (sem aspas), e escolha a opção Checkout

Opção Checkout

17. Insira a URL do repositório, e depois escolha uma pasta que ficará os arquivos no computador

URL do repositório

18. Insira um nome para pasta SVN

Nome da Pasta

19. Será perguntado se deseja abrir o repositório ou adicionar na workspace, nesse exemplo vamos utilizar Add To Workspace

Opção de adicionar a Workspace

20. Agora será mostrado os arquivos normalmente, e para realizar alterações (como Commit e Update), clique na área de Controle de Código Fonte, veja o projeto e pode fazer as alterações

Opção de Commit


Observação: Caso precise gerar um arquivo de configuração da workspace, faça:

1. Arquivo > Fechar Espaço de Trabalho

2. Arquivo > Salvar Espaço de Trabalho como…

3. Adicione / Crie um arquivo prw e abra ele

4. Clique em Depurar (Ctrl + Shift + D)

5. Onde tem “Sem Configurações”, clique no combo e depois clique em “Adicionar config (Espaço de Trabalho)”


Bom pessoal, por hoje é só.

Abraços e até a próxima.

Dan_Atilio
Analista e desenvolvedor de sistemas. Técnico em Informática pelo CTI da Unesp. Graduado em Banco de Dados pela Fatec Bauru. Entusiasta de soluções Open Source e blogueiro nas horas vagas.

3 Responses

  1. Rafael Arcanjo disse:

    “Abra o arquivo de configuração da workspace”
    Onde ? 🙁

  2. Rafael Arcanjo disse:

    Ah, tá no FINAL do artigo…

Deixe uma resposta