Configurar o Debug no VSCode Quando se usa Protheus com WebAgent e WebApp (via Navegador)

No artigo de hoje, vamos demonstrar em como configurar a Depuração de códigos em AdvPL e TLPP no Protheus quando se é usado o navegador através do WebApp e/ou WebAgent.

Atualização Fevereiro de 2025

Saiu uma documentação oficial no TDN com os prints das telas, segue o link: clique aqui.

Artigo original

  1. No VSCode, clique em File > Preferences > Settings (ou se estiver em português é Arquivo > Preferências > Configurações)
Acessando as configurações

Acessando as configurações

  1. Procure por navigator, ai você pode configurar por usuário (que vai pegar independente da Workspace, igual no print abaixo) ou exclusivamente por Workspace. Ai no caminho do navegador, coloque o .exe, no exemplo abaixo foi usado o Microsoft Edge (eu também já testei com o Google Chrome):
Definindo o navegador

Definindo o navegador

  1. Se você já tiver um launch.json configurado, você pode renomear ele fazendo um backup ou apagando ele
Apagando ou renomeando o launch.json original

Apagando ou renomeando o launch.json original

  1. Ai clique na esquerda, na parte de depuração e depois clique em create a launch.json file
Criando um novo launch.json

Criando um novo launch.json

  1. Selecione o nome da sua workspace que você criar o launch.json (nesse caso eu chamei ela de Workspace3)
Selecionando a Workspace

Selecionando a Workspace

  1. Na parte de selecionar o tipo de Debug, coloque TOTVS Language Web Debug (SmartClient HTML)
Selecionando a opção de SmartClient HTML

Selecionando a opção de SmartClient HTML

  1. Será gerado o arquivo launch.json
Arquivo launch.json gerado

Arquivo launch.json gerado

  1. Então ao pressionar -F5- para debugar, ele já abre o Protheus
Protheus Web abrindo via debug

Protheus Web abrindo via debug

Referências:

Bom pessoal, por hoje é só.

Abraços e até a próxima.

Dan (Daniel Atilio)
Cristão de ramificação protestante. Especialista em Engenharia de Software pela FIB, graduado em Banco de Dados pela FATEC Bauru e técnico em informática pelo CTI da Unesp. Entusiasta de soluções Open Source e blogueiro nas horas vagas. Autor e mantenedor do portal Terminal de Informação.

12 Responses

  1. Julius disse:

    Olá Irmão! Paz!
    Fiz exatamente como ordenado aqui neste link e tbm no github, mas não está rodando. Continua me aparecendo o “Parameter WebNavigator not informed”, mas eu informei…
    Tenho que sinalizar o navegador no “.ini” tambem?

    Obrigado”

    • Amém Julius, bom dia, tudo joia?

      Que estranho, eu não peguei esse erro de WebNavigator.

      Eu fiz exatamente o procedimento que tirei os prints para esse artigo, e funcionou normalmente.

      Vou tentar pesquisar para ver se encontro alguma referência sobre.

      Se eu encontrar algo, eu atualizo aqui no artigo.

      Tenha uma ótima e abençoada quinta feira.

      Um grande abraço.

    • Guilherme Bigois disse:

      Precisa adicionar no seu settings.json o parâmetro totvsLanguageServer.web.navigator com o caminho do seu navegador.

      O meu por exemplo está assim: “totvsLanguageServer.web.navigator”: “C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe”

    • Diego disse:

      Bom dia, pessoal; Estou com esse problema também, conseguiram resolver?
      Incluí no settings.json o caminho do navegador mas não resolveu

      • Bom dia Diego, tudo joia?

        Então, eu não precisei incluir diretamente no settings.json, apenas no passo 2 via tela.

        E depois fazer o passo 6 recriando a configuração como SmartClient HTML.

        Veja esses dois passos se consegue reproduzir ai.

        Ficamos no aguardo.

        Tenha uma ótima e abençoada quinta feira.

        Um grande abraço.

  2. Robson disse:

    muito obrigado pela dica ! me ajudou muito ! Tudo de bom !

  3. Jonas disse:

    Top, seu site é o melhor em conteúdos de ADVPL e Protheus!!!

  4. Henrique disse:

    Muito obrigado. Ajudou bastante

Deixe uma resposta

Terminal de Informação