Runtime desktop
O runtime desktop da CaptchaLa é o conjunto de bibliotecas nativas para Windows, macOS e Linux sobre o qual os SDKs desktop são construídos. Versão atual: 1.2.0.
Você não integra o runtime diretamente. Use um destes SDKs; eles incluem ou baixam o runtime correspondente para você:
- SDK Electron (
@captcha-la/electron): o pacote npm contém o runtime para todos os alvos compatíveis. - SDK Flutter (
captchala): no Windows e no Linux o plugin baixa o runtime durante o build e o verifica com hashes SHA-256 fixados.
Apps nativos de macOS usam o SDK iOS / macOS.
Precisa de integração direta?
Se nem o Electron nem o Flutter servem para o seu app, fale conosco.
Plataformas
| Plataforma | Arquiteturas | Janela do captcha |
|---|---|---|
| Windows 10 1809+ e Windows Server | x64, arm64, x86 | Janela nativa (Microsoft Edge WebView2 Runtime) |
| Linux, glibc 2.17+ | x64, arm64 | Janela nativa: GTK 3 e WebKitGTK 4.1 (Ubuntu 22.04+, Debian 12+ ou equivalente) |
| macOS 11+ | arm64, x64 | Usado pelo SDK Electron |
Desde a 1.2.0 o runtime também carrega no Windows Server, incluindo Server Core e servidores de terminal, sem instalar nenhum recurso extra do Windows.
Em sistemas Linux anteriores ao Ubuntu 22.04 / Debian 12 a janela nativa do captcha não está disponível; nesses casos o SDK Electron mostra o captcha em sua própria janela.
Download e verificação
As bibliotecas são publicadas na CDN de pacotes versionada com checksums, para revisões de segurança ou para espelhá-las dentro da sua rede:
- URL base:
https://pkg.captcha-pkg.net/desktop/1.2.0/(espelho:https://pkg.captcha-cdn.net/desktop/1.2.0/) SHA256SUMSlista cada arquivo com seu SHA-256; uma pasta por alvo:linux-x64,linux-arm64,win32-x64,win32-arm64,win32-ia32,darwin-arm64,darwin-x64
# Linux (use "shasum -a 256 -c -" on macOS)
BASE=https://pkg.captcha-pkg.net/desktop/1.2.0
TARGET=linux-x64
mkdir -p vendor/captchala/1.2.0 && cd vendor/captchala/1.2.0
curl -fsSLO "$BASE/SHA256SUMS"
for f in $(grep " $TARGET/" SHA256SUMS | awk '{print $2}'); do
mkdir -p "$(dirname "$f")" && curl -fsSL -o "$f" "$BASE/$f"
done
grep " $TARGET/" SHA256SUMS | sha256sum -c - # every line must say OKNo Windows, compare Get-FileHash <file> -Algorithm SHA256 com a linha do SHA256SUMS. Para compilar um app desktop Flutter a partir de um espelho, aponte CAPTCHALA_LOCAL_PREBUILDS para a pasta (veja Flutter: bibliotecas nativas).
Requisitos
- Windows: Windows 10 1809+ ou Windows Server; Microsoft Edge WebView2 Runtime para a janela do captcha.
- Linux: glibc 2.17+ e libcurl; GTK 3 e WebKitGTK 4.1 (
webkit2gtk-4.1) para a janela do captcha. - macOS: macOS 11+.
Validação no servidor
Qualquer que seja o SDK, envie o pass token para o seu backend e valide-o com POST https://verify.captcha.la/v1/validate. Veja a Referência da API.