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:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/07/img1.jpg?resize=588%2C310)
Nesse post iremos instalar o VSCode para o sistema operacional Windows, mas você poderá instalar em outras plataformas como linux e MacOS:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/07/img2.jpg?resize=1024%2C507)
Após efetuar o download do executável do VSCode execute o instalador como administrador:
![Executável VSCODE](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/07/img3.jpg?resize=381%2C48)
Na próxima tela que aparece marque a opção Eu aceito o acordo e clique em próximo:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img4.jpg?resize=639%2C505)
Na próxima tela que aparece marque as opções abaixo e clique em próximo:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img5.jpg?resize=640%2C506)
Na próxima tela clique em instalar:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img6.jpg?resize=640%2C507)
Na próxima tela clique em concluir para finalizar a instalação do VSCode:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img7.jpg?resize=640%2C506)
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:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img8.jpg?resize=444%2C483)
No campo de pesquisa de extensões pesquise por “Portuguese (Brazil) Language Pack” e depois clique em Install:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img9.jpg?resize=608%2C142)
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:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img10.jpg?resize=999%2C737)
Após o reiniciar o VSCode o mesmo estará com o idioma Português(Brasil):
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img11.jpg?resize=582%2C317)
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:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img12.jpg?resize=630%2C235)
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:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img13.jpg?resize=1024%2C559)
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:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img14.jpg?resize=1024%2C559)
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:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img15.jpg?resize=1024%2C559)
Ao final clique em SAVE/CLOQUE para salvar e fechar:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img16.jpg?resize=1024%2C560)
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…:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img17.jpg?resize=1024%2C559)
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:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img18.jpg?resize=1024%2C557)
O próximo passo é adicionarmos uma pasta ao workspace criado, para isso clique novamente em Arquivo e depois em Adicionar pasta ao workspace
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img19.jpg?resize=1024%2C559)
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:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img20.jpg?resize=1024%2C559)
Na próxima tela vemos a workspace ProtheusAdvpl e a pasta Blog_Site_ProtheusAdvpl criadas:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img21.jpg?resize=1024%2C559)
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:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img22.jpg?resize=1024%2C559)
Dê um nome para o arquivo, no meu caso dei o nome de teste.tlpp(ou teste.prw):
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img23.jpg?resize=1024%2C557)
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
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img24.jpg?resize=1024%2C559)
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:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img25.jpg?resize=1024%2C559)
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++)
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img26.jpg?resize=1024%2C559)
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:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img27.jpg?resize=1024%2C559)
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):
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img28.jpg?resize=1016%2C549)
Após isso clique com o botão direito do mouse na conexão do appserver que criamos e depois clique em Connect:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img29.jpg?resize=1024%2C559)
Na próxima tela que aparece informe o nome do ambiente(environment) do servidor appserver e dê um enter:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img30.jpg?resize=1024%2C313)
Na próxima tela informe o usuário do protheus que irá se conectar ao servidor appserver e dê enter:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img31.jpg?resize=1024%2C306)
Na próxima tela informe a senha do usuário do protheus:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img32.jpg?resize=1024%2C308)
Na próxima tela vemos a conexão estabelecida com o servidor appserver:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img33-1.jpg?resize=1024%2C305)
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):
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img34.jpg?resize=1024%2C517)
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:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img35.jpg?resize=1024%2C530)
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):
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img36.jpg?resize=1024%2C386)
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:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img37.jpg?resize=1024%2C381)
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:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img38.jpg?resize=1024%2C559)
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!”:
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2020/08/img39.jpg?resize=1024%2C559)
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
![](https://i0.wp.com/protheusadvpl.com.br/wp-content/uploads/2023/03/Instalacao-e-Configuracao-do-TOTVS-VSCode-2-1024x576.png?resize=1024%2C576&ssl=1)
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