Se você desenvolve em AdvPL no Protheus, prepare-se: o tradicional smartclient.exe está com os dias contados. A partir da versão 12.1.2410, a TOTVS oficializou a transição para o Web Smartclient, também conhecido como WebApp — uma nova forma de acessar e depurar o sistema, totalmente via navegador.

Neste artigo, você vai entender o que muda, por que essa atualização é positiva e como configurar seu ambiente no VS Code para continuar trabalhando com agilidade e segurança.

Por que o Web Smartclient está substituindo o executável?

A TOTVS está investindo em soluções mais modernas, seguras e compatíveis com as novas exigências de mercado. O SmartClient Desktop exigia instalação local, o que podia gerar problemas de compatibilidade, especialmente em ambientes com múltiplos desenvolvedores.

Com o Web Smartclient, o acesso ao ERP TOTVS acontece diretamente pelo navegador, eliminando a necessidade de instalações na máquina do desenvolvedor. Isso representa:

• Menos manutenção de ambiente local;
• Maior flexibilidade no desenvolvimento remoto;
• Facilidade de uso em qualquer sistema operacional com navegador.

Leia o comunicado oficial da TOTVS:
Substituição do SmartClient Desktop – Linha Protheus

Como usar o Web Smartclient no VS Code?

A boa notícia é que a transição é simples — e o próprio VS Code, com a extensão da
TOTVS, já oferece suporte ao Web Smartclient. Você só precisa:

1. Atualizar o plugin TOTVS no VS Code;
2. Criar uma nova configuração de depuração utilizando a opção
   “TOTVS Language Debug via Web App”;
3. Definir o navegador que deseja utilizar (como Google Chrome ou Microsoft Edge);
4. Iniciar a depuração normalmente, como fazia com o smartclient.exe.

Veja o passo a passo completo na documentação da TOTVS:
Configurando o VS Code para depurar com WebApp

Benefícios para o dia a dia do desenvolvedor

Ao utilizar o Web Smartclient, você mantém todos os recursos de depuração do VS Code, como:

• Breakpoints (pontos de parada);
• Inspeção de variáveis;
• Acompanhamento do fluxo do código em tempo real;
• Maior estabilidade e agilidade na execução.

E o melhor: sem depender de caminhos locais ou configurações complexas no seu sistema operacional.

Como a TNU Sistemas pode apoiar sua empresa

Se sua equipe ainda não migrou para o Web Smartclient ou está enfrentando dificuldades com a nova configuração, a TNU Sistemas pode apoiar sua empresa.

Otimize sua produtividade com o apoio de quem entende de TOTVS. Fale com a TNU Sistemas e veja como podemos acelerar sua evolução!

Considerações Finais

A mudança para o Web Smartclient representa um avanço importante no desenvolvimento em AdvPL. Com acesso direto pelo navegador e integração nativa ao VS Code, a nova abordagem traz mais produtividade, estabilidade e escalabilidade para os projetos.

Adapte-se agora e tire proveito do que há de mais atual no universo TOTVS. E se precisar de suporte especializado, conte com a TNU Sistemas para tornar essa transição tranquila e eficiente.

TNU Sistemas — seu parceiro em inovação, suporte e performance no ecossistema TOTVS.