/advpl-compile

Compila no AppServer Protheus real via TDS-LS. Auto-detecta servers do TDS-VSCode (~/.totvsls/servers.json), pede senha, gera RPO no servidor.

Assinatura: /advpl-compile <arquivo.prw>

/advpl-compile faz compile remoto real no AppServer Protheus — gera RPO atualizado, autentica via TLS, com rollback automatico em caso de erro.

UX zero-config

Le automaticamente o ~/.totvsls/servers.json da extensao TDS-VSCode da TOTVS. Se voce ja usa o TDS pra compilar, a skill ja sabe quais servers voce tem.

Fluxo tipico

voce: /advpl-compile MATA010.prw

Claude: "Encontrei 3 servers configurados:
         1. Dev Local (localhost:6701, env=meu_dev)
         2. Homolog Cloud (cloud.totvs.com.br:6701 TLS, env=HOMOLOG)
         3. Producao (prod.cliente.com.br:6701 TLS, env=PROD)
         Qual usar?"

voce: "2"

Claude: "Senha do admin no Homolog Cloud?"

voce: <senha>

Claude: "Compilando...
         [OK] Source compiled successfully.
         [OK] All files compiled successfully.
         EXIT=0
         Quer salvar a senha pra proximas vezes?"

voce: "sim"

Claude: "Salvei em ~/.claude/advpl-credentials.json (so este server)"

Proximas vezes: so digitar /advpl-compile MATA010.prw "Homolog Cloud".

Detalhes tecnicos

Casos de erro tratados

[ERROR] Authentication failed
→ Usuario/senha errados

[ERROR] Connection refused
→ AppServer offline OU porta errada OU TLS mismatch

[ERROR] appre41(8) Error C2024  Unclosed control structures
→ Erro de sintaxe — rollback automatico ja foi feito
   Use /advpl-validate primeiro pra pegar isso local

Pre-requisitos

  1. /advpl-setup rodado uma vez
  2. Acesso de rede ao AppServer (porta 6701 default)
  3. Usuario Protheus com permissao de developer
  4. Server cadastrado no TDS-VSCode (ou ~/.totvsls/servers.json manual)

Credenciais salvas

Em ~/.claude/advpl-credentials.json, formato:

{
  "default": {
    "server": "192.168.0.198",
    "port": 6701,
    "secure": 1,
    "build": "AUTO",
    "environment": "HOMOLOG",
    "user": "admin",
    "password": "..."
  }
}

⚠ Arquivo no .gitignore do repo. Nunca commite.

Instalacao

A skill faz parte do pacote claude-advpl-skill open source. Baixe e instale:

curl -O https://archtecgroup.com.br/downloads/claude-advpl-skill-v0.2.1.zip
unzip claude-advpl-skill-v0.2.1.zip
bash install.sh
# OU Windows PowerShell:
.\install.ps1

Documentacao tecnica completa: GitHub maycondev/claude-advpl-skill

Caso de uso real (post): Auditando 800 linhas de AdvPL em 30 segundos

Suporte / Customizacao

Precisa adaptar a skill pro seu fluxo, integrar em pipeline CI/CD custom, ou usar em ambiente corporativo com NDA?

A ArchTec oferece consultoria especializada em automacao de dev Protheus com Claude/AI. Fale com nossos especialistas →

Veja também