Como Instalar e Configurar o TOTVS VSCode

Tempo de leitura: 8 minutos

Olá, aqui é Adilio Costa, no post de hoje iremos aprender como instalar e configurar o TOTVS VSCode(Plugin TOTVS Developer Studio for VSCode), a nova extensão de ADVPL/TL++ da Totvs para a IDE VSCODE.

No post iremos abordar os seguintes tópicos:

  • Baixando e Instalando o VSCode
  • Instalando o Plugin Português(Brasil) do VSCode
  • Instalando o Plugin TOTVS Developer Studio for VSCode
  • Criação de Projeto e Fonte ADVPL/TL++ no TOTVS VSCode
  • Criação do Servidor AppServer, Compilação e Execução do Fonte ADVPL/TL++ Criado.

Baixando e Instalando o VSCode

Para baixarmos o VSCode acesse o link Download VSCode, você deverá ver uma tela como a imagem abaixo:

Download VSCode

Nesse post iremos instalar o VSCode para o sistema operacional Windows, mas você poderá instalar em outras plataformas como linux e MacOS:

Download VSCode para Windows, Linux e Mac.

Após efetuar o download do executável do VSCode execute o instalador como administrador:

Executável VSCODE
Executável VSCode

Na próxima tela que aparece marque a opção Eu aceito o acordo e clique em próximo:

 

Na próxima tela que aparece marque as opções abaixo e clique em próximo:

 

Na próxima tela clique em instalar:

Na próxima tela clique em concluir para finalizar a instalação do VSCode:

Conclusão da instalação do Totvs VSCODE

Instalando do Plugin Português(Brasil) do VSCode

O próximo passo é instalarmos o plugin Português(Brasil) do VSCode, ao entrar na IDE clique na aba extensões:

Extensões do VSCode

No campo de pesquisa de extensões pesquise por “Portuguese (Brazil) Language Pack” e depois clique em Install:

Extensão Português(Brasil) para o VSCode

Após a instalação da extensão Português(Brasil) do VSCode o mesmo informará que será preciso reiniciá-lo para reconhecer a instalação, clique em Restart Now:

Após o reiniciar o VSCode o mesmo estará com o idioma Português(Brasil):

VSCode com o idioma Português(Brasil)

 

 


Receba as últimas atualizações do ProtheusAdvpl
Deixe seu melhor email
Nós respeitamos sua privacidade.


 

 

Instalando o Plugin Totvs Developer Studio for VSCode

O próximo passo é instalarmos o plugin TOTVS Developer Studio no VSCode, para isso clique na aba extensões e pesquise por TOTVS Developer Studio for VSCode e clique em Instalar:

Extensão TOTVS Developer Studio for VsCode

Criação de Projeto e Fonte ADVPL/TL++ no TOTVS VSCode

Feito a instalação da extensão do TOTVS Developer Studio for VSCode agora iremos criar um projeto e um fonte ADVPL/TL++ no TOTVS VSCode, para isso clique na aba TOTVS conforme a imagem abaixo:

Aba TOTVS

Na parte direita da tela iremos informar onde está o executável do smartclient(smartclient.exe) do Protheus, para isso clique em Escolher arquivo e informe o diretório do seu smartclient:

Selecionando o smarclient(smartclient.exe)

A próxima etapa é selecionarmos a pasta dos includes(bibliotecas ADVPL/TL++), para isso clique em Escolher arquivo(botão mais abaixo) e depois em Selecionar pasta:

Selecionando a pasta include

Ao final clique em SAVE/CLOQUE para salvar e fechar:

O próximo passo é criarmos uma workspace(área de trabalho), uma workspace é uma área de trabalho onde podemos fazer configurações(informar as configurações de appserver, ambientes(environment) dos RPO do Protheus), adicionar ou excluir extensões e também adicionarmos pastas para cada projetos ADVPL/TL++ que criarmos. Para criar o nosso workspace clique em Arquivo e depois em Salvar Espaço de Trabalho Como…:

Criação da Workspace no VSCode

Na próxima tela informe o nome do arquivo do workspace e salve o mesmo dentro de uma pasta(eu criei uma pasta chamada Projetos_ADVPL_TLPP e salvei o arquivo dentro dela), dei o nome arquivo do workspace de ProtheusAdvpl, clique em Salvar:

O próximo passo é adicionarmos uma pasta ao workspace criado, para isso clique novamente em Arquivo e depois em Adicionar pasta ao workspace

Adicionando pasta ao workspace

 

Na próxima tela que surge eu criei uma pasta chamada de Blog_Site_ProtheusAdvpl(fica a seu critério) e depois clicamos em Adicionar:

 

Na próxima tela vemos a workspace ProtheusAdvpl e a pasta Blog_Site_ProtheusAdvpl criadas:

workspace ProtheusAdvpl e pasta Blog_Site_ProtheusAdvpl

O próximo passo é criarmos o arquivo fonte ADVPL/TL++ que irá ficar dentro da pasta que criamos, para isso clique com o botão direito do mouse em cima da pasta criada e depois em Novo Arquivo:

Criando o arquivo ADVPL/TL++

Dê um nome para o arquivo, no meu caso dei o nome de teste.tlpp(ou teste.prw):

arquivo teste.tlpp

Copiei o código abaixo e cole dentro do arquivo teste.tlpp:

#include 'protheus.ch'
/*
Acesse o Blog/Site ProtheusAdvpl:http://protheusadvpl.com.br/
Se inscreva no Canal ProtheusAdvpl:https://www.youtube.com/protheusadvpl
Siga-nos no instagram:https://www.instagram.com/protheusadvpl/
Conheça o Portal ProtheusAdvpl:http://protheusadvpl.com.br/portal-protheusadvpl
*/
User Function Teste()

	Local cMsg:="Nosso primeiro programa ADVPL/TL++ no TOTVS VSCode!"

	msgAlert(cMsg)

Return

teste.tlpp criado

Criação do Servidor TOTVS AppServer, Compilação e Execução do Fonte ADVPL/TL++ Criado.

O próximo passo é criarmos o servidor appserver através de uma conexão, para isso clique na aba TOTVS e mais acima no símbolo “+” para adicionarmos o servidor appserver:

Criação do servidor appserver

Na tela que aparece iremos informar os seguintes dados:

  • Descrição do Servidor
  • O IP onde está localizado o servidor appserver
  • A porta de conexão do appserver
  • O diretório de includes(bibliotecas de funcionalidades ADVPL/TL++)
Dados de conexão do servidor appserver

Após isso clique em SAVE para salvar os dados da conexão, após isso você verá o servidor appserver criado dentro do VSCode:

O próximo passo é subir o serviço do appserver em modo console ou em modo serviço do windows(caso você não saiba como configurar, veja no post instalacao-e-configuracao-do-protheus-12-1-23-lobo-guara-parte-3):

Appserver executando em modo console

 


Receba as últimas atualizações do ProtheusAdvpl
Deixe seu melhor email
Nós respeitamos sua privacidade.


 

Após isso clique com o botão direito do mouse na conexão do appserver que criamos e depois clique em Connect:

Conexão com o appserver

Na próxima tela que aparece informe o nome do ambiente(environment) do servidor appserver e dê um enter:

Informando o ambiente(environment) do appserver

Na próxima tela informe o usuário do protheus que irá se conectar ao servidor appserver e dê enter:

Informando o usuário do protheus

Na próxima tela informe a senha do usuário do protheus:

Informando a senha do usuário do protheus

 

 

Na próxima tela vemos a conexão estabelecida com o servidor appserver:

Conexão estabelecida com o appserver

O próximo passo é compilarmos o fonte teste.tlpp que criamos anteriormente, para isso clique com o botão direito em cima do fonte e clique em Compile File/Folder(ou Ctrl+F9):

Compilando o fonte teste.tlpp

Na próxima tela, se não tiver ocorrido nenhum erro durante a compilação do fonte teste.tlpp, você verá uma mensagem como na imagem abaixo:

Compilação do fonte teste.tlpp com sucesso

O próximo e último passo é executarmos o fonte teste.tlpp para exibir a mensagem “Nosso primeiro programa ADVPL/TL++ no TOTVS VSCode!”, para isso clique na aba Executar e depois em Executar sem Depuração(ou poderá digitar o comando Ctrl+F5):

Executando o fonte teste.tlpp

Na próxima tela que aparece devemos informar a função ADVPL que iremos executar, no fonte teste.tlpp criamos uma função de usuário(User Function) chamada Teste, toda função de usuário para ser executada deverá iniciar por U_nomeDaFuncao, assim para executarmos a função Teste informamos U_TESTE e depois damos um Enter, conforme é mostrado na imagem:

Executando a função de usuário Teste

Na próxima tela podemos ver o smartclient sendo iniciado para se comunicar com o servidor appserver e executar ao chamado ao programa teste.tlpp compilado:

Smartclient sendo iniciado

Na próxima tela podemos ver o nosso programa teste.tlpp sendo executado e apresentando a mensagem “Nosso primeiro programa ADVPL/TL++ no TOTVS VSCode!”:

Programa teste.tlpp sendo executado

 

 


Receba as últimas atualizações do ProtheusAdvpl
Deixe seu melhor email
Nós respeitamos sua privacidade.


 

Bem, assim finalizamos mais um post, espero que você tenha aprendido o que vimos hoje no post de instalação e configuração do TOTVS VSCode, qualquer dúvida pode deixar seu comentário ou enviar um email para adiliocosta@protheusadvpl.com.br. Até um próximo post, grande abraço e fica com Deus.


CONHEÇA O CURSO INSTALAÇÃO E CONFIGURAÇÃO DO TOTVS VS CODE
Conheça o Curso Instalação e Configuração do TOTVS VSCode

CONHEÇA O PORTAL PROTHEUSADVPL


Se inscreva no Canal ProtheusAdvpl no Youtube: https://www.youtube.com/protheusadvpl

Siga o ProtheusAdvpl no Instagram: http://www.instagram.com/protheusadvpl

Curta a Página ProtheusAdvpl no Facebook: https://www.facebook.com/protheusadvpl2/

Participe do Grupo ProtheusAdvpl no Facebook: http://protheusadvpl.com.br/grupo-facebook-protheusadvpl


Receba as últimas atualizações do ProtheusAdvpl
Deixe seu melhor email
Nós respeitamos sua privacidade.