---

name: wpp-build description: Guiar a compilação e instalação do pacote Delphi/Lazarus WPP4Delphi (TWPP4DelphiCollection.dpk) — dependências CEF4Delphi/WA-JS, Library Path por versão do Delphi (VD23-VD30), diretiva CEFCurrentVersion, setup do app Demo. Use quando o usuário pedir ajuda para compilar, instalar, ou configurar o ambiente de build deste componente, ou relatar erro de compilação/instalação do pacote.

Build / instalação do WPP4Delphi

Não há build CLI nem suíte de testes automatizada neste repositório — é um pacote Delphi/VCL (e uma variante Lazarus) compilado pela IDE. Este skill guia diagnóstico e passos de build/instalação; não tente rodar um "build" via shell além de operações read-only de inspeção (o compilador Delphi (dcc32/dcc64/MSBuild) normalmente não está disponível no ambiente do agente).

Dependências externas obrigatórias (não vendorizadas)

• CEF4Delphi — deve estar instalado e compilado ANTES do WPP4Delphi. Versão de referência: Chromium 109.0.5414.120 (compatível com Windows 7/8/Server 2012+).
• WA-JS — já vendorizado em Source/JS/js.abr, normalmente não precisa reinstalar, mas fica desatualizado com o tempo; a versão mais recente está em https://raw.githubusercontent.com/wppconnect-team/WPP4Delphi/main/Source/JS/js.abr.

Se o usuário relatar erro de compilação mencionando TChromium, CEF4Delphi, vclFireDAC, IndyIPClient etc. não encontrados, o problema quase sempre é dependência ausente/desinstalada — não é bug no código deste componente.

Passos de instalação (Delphi/RAD Studio)

1. Instalar o CEF4Delphi primeiro: abrir o .dpk dele, Build, "Install".
2. Adicionar ao Library Path da IDE:
   • Source\Model
   • Source\Services
   • Source\View
   • Source\Other
   • Packages\Compilados\<VDxx> — a subpasta correspondente à versão do Delphi em uso (ver tabela abaixo).
3. Abrir Packages/TWPP4DelphiCollection.dpk.
4. Se o CEF4Delphi instalado for versão > 120: definir a diretiva de compilação CEFCurrentVersion no projeto do pacote ANTES do Build (senão erro de compatibilidade de versão).
5. Build (Shift+F9) → botão direito no Project Manager → "Install".
6. Para rodar o app Demo (fora do escopo padrão de análise deste repo, ver .claudeignore): compilar uma vez para gerar C:\Executáveis\WPPConnectDemo, copiar ConfTWPPConnect.ini (de Demo\BIN) e os binários do CEF (mesma versão) para essa pasta.

Mapeamento de versão do Delphi → pasta Compilados

Packages\Compilados tem uma subpasta por versão do compilador porque .dcu não é compatível entre versões:

| Pasta | Delphi/RAD Studio | |---|---| | VD23..VD30 | Ver numeração em https://delphidabbler.com/notes/version-numbers | | lazarus | Build alternativo para Lazarus (usa .lpk/.lpi, não o .dpk) |

Se o usuário não souber a versão, peça para checar em Help → About na IDE, ou o valor de CompilerVersion/RTLVersion.

Via Boss (gerenciador de pacotes Delphi)

boss install github.com/wppconnect-team/WPP4Delphi

mainsrc = ./Source, projeto do pacote = ./Packages/TWPP4DelphiCollection.dproj (ver boss.json).

Diagnóstico de erros comuns

• "Package not found" / unidade não encontrada ao abrir o .dpk: falta alguma pasta no Library Path (passo 2) ou a pasta VDxx não corresponde à versão real da IDE.
• Erro de versão de CEF incompatível em runtime (VersaoCEF4Aceita retorna falso, ver uTWPPConnect.ConfigCEF.pas): confirmar que os binários do CEF instalados batem com a versão que o CEF4Delphi.pas desse build espera; para CEF > 120, confirmar que CEFCurrentVersion foi definida (passo 4).
• QR Code não aparece / Chromium não carrega: geralmente binários do CEF (.dll, locales, swiftshader etc.) não foram copiados para a pasta do executável — não é um problema do pacote Delphi em si.
• Erros de sintaxe após uma edição manual do código-fonte: como não há build CLI, não dá para validar sintaxe fora da IDE — revisar begin/end/try/finally manualmente e avisar o usuário que a validação final precisa ser um Build na IDE.

Escopo

Pastas Demo, Demo QrCode e Instalador existem no repositório mas estão listadas em .claudeignore — fora do escopo padrão de análise/edição, mas os passos de setup delas continuam válidos para orientar o usuário verbalmente.