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:

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

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

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:

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:

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

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):

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:

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:

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:

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:

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…:

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

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:

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:

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

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

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:

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++)

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):

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

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

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

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

Na próxima tela vemos a conexão estabelecida com o servidor 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):

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:

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):

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:

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:

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!”:

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 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