| 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)
- Instalar o CEF4Delphi primeiro: abrir o
.dpk dele, Build, "Install".
- Adicionar ao Library Path da IDE:
Source\ModelSource\ServicesSource\ViewSource\OtherPackages\Compilados\<VDxx> — a subpasta correspondente à versão do Delphi em uso (ver tabela abaixo).
- Abrir Packages/TWPP4DelphiCollection.dpk.
- 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).
- Build (Shift+F9) → botão direito no Project Manager → "Install".
- 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:
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.
