Primeiros passos

OpenADS é um projeto CMake em C++17. Compila no Windows (MSVC), Linux (clang ou gcc) e macOS (AppleClang).

Compilar

git clone https://github.com/FiveTechSoft/OpenADS
cd OpenADS
cmake --preset default
cmake --build build/default --config Release
ctest --test-dir build/default --output-on-failure -C Release

Binários gerados:

ace64.dll (Windows) / libace.so (Linux) / libace.dylib (macOS) em build/default/src/Release/ — o substituto direto do ACE.
tools/serverd/openads_serverd — CLI servidor TCP.
tools/bench/openads_bench — temporizador de cargas SQL multi-plataforma.

Opções de build

OPENADS_WITH_HTTP=ON (padrão desde v1.0.0-rc20) — compila o console web Studio dentro de openads_serverd e dentro de ace64.dll / ace32.dll (modo LocalServer). Use -DOPENADS_WITH_HTTP=OFF para excluir.
cmake -DOPENADS_WITH_TLS=ON … — habilita URIs tls:// em AdsConnect60. Empacota mbedtls 3.6 LTS (Apache-2.0) e o linka estaticamente desde v1.0.0-rc8 — zero dependência runtime de libssl / libcrypto / mbedtls.

O ZIP de release Windows traz ambos ace64.dll (x64) e ace32.dll (x86) mais openads_serverd_{x64,x86}.exe desde v1.0.0-rc8, então apps X#, Harbour-x86 e Clipper legacy escolhem o bitness correto numa só baixada.

Smoke test (drop-in)

Coloque ace64.dll (ou libace.so) no PATH da aplicação Harbour antes de qualquer cópia da SAP. As chamadas existentes de contrib/rddads agora caem no OpenADS.

Compile sua própria app Harbour contra OpenADS (`hbmk2` / `.hbp`)

O repo traz um template hbmk2 pronto em examples/harbour-hbmk2/ — coloque seu .prg ao lado de openads_demo.hbp, defina OPENADS_LIB apontando para o build do OpenADS, rode hbmk2. O .exe produzido move tabelas DBF / CDX pelo RDD padrão contrib/rddads do Harbour, mas cada chamada Ads* cai no ace64.dll do OpenADS em vez de qualquer cópia da SAP.

:: A partir de um Developer Command Prompt x64 do Visual Studio:
cd examples\harbour-hbmk2
set OPENADS_LIB=C:\OpenADS\build\default\src\Release
set PATH=C:\harbour\bin\win\msvc64;%OPENADS_LIB%;%PATH%
hbmk2 openads_demo.hbp
copy /y "%OPENADS_LIB%\ace64.dll" .
openads_demo.exe

O .hbp é deliberadamente mínimo — apenas as duas entradas de link que mudam para o OpenADS:

openads_demo.prg
-comp=msvc64
-lrddads                    # RDD ADS do Harbour (contrib/rddads)
-L${OPENADS_LIB}
-lace64                     # Import lib do OpenADS (em vez da da SAP)
-lrddcdx
-lrddntx
-lrddfpt

Há uma variante 32-bit (openads_demo_x86.hbp → -lace32) e um build.sh para Linux / macOS. Para apps GUI FiveWin (FWH) hbmk2 não basta — veja examples/fivewin/ para build_msvc64.cmd, que replica o build padrão FWH com rddads.lib + ace64.lib do OpenADS adicionados.

Erros típicos “meu .hbp não compila”:

Sintoma	Causa provável
`unresolved external symbol AdsConnect60` (ou qualquer `Ads*`)	`OPENADS_LIB` não definido, ou toolchain errado — `ace64.lib` é MSVC; para bcc64 / MinGW use a import lib correspondente.
`lib 'rddads' not found`	`contrib/rddads` não compilado para o `-comp=…` escolhido. Recompile o contrib do Harbour para esse toolchain.
Runtime `ace64.dll not found`	DLL não está junto do exe nem no `PATH`.
Strings truncadas em um TBrowse / xBrowse	Corrigido em v1.0.0-rc27 — `AdsGetField` agora preenche CHAR até a largura declarada.
`AdsVersion()` reporta algo como `12.0` / `11.10`	Você carregou o `ace64.dll` da SAP. `where ace64.dll` e reordene o `PATH`.

Smoke test (servidor TCP + Studio)

cmake --preset default
cmake --build build/default --target openads_serverd --config Release

./build/default/tools/serverd/openads_serverd \
    --port 6262 \
    --http-port 6263 \
    --data /caminho/dos/seus/dados

Depois abra http://localhost:6263/ em qualquer navegador.

Studio LocalServer (in-process)

Desde v1.0.0-rc9 o mesmo console Studio fica embutido em ace64.dll / ace32.dll. Uma app Harbour / X# / Clipper que carregue a DLL OpenADS recebe a SPA dentro do próprio processo — sem daemon. Defina OPENADS_STUDIO_PORT=8080 antes de iniciar a app para auto-arrancar, ou chame AdsStudioStart(port, data_dir) no código host. Detalhes em Studio.

Rodar `openads_serverd` como serviço

Desde v1.0.0-rc14:

Windows: openads_serverd --install-service (auto-start via SCM); --uninstall-service remove.
Linux: scripts/openads-serverd.service — unit systemd hardened (User=openads, ProtectSystem=strict, NoNewPrivileges).
macOS: scripts/com.openads.serverd.plist — launchd plist com KeepAlive on crash.

Detalhes em Implantação como serviço.