Skip to content

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 ​

PlataformaArquiteturasJanela do captcha
Windows 10 1809+ e Windows Serverx64, arm64, x86Janela nativa (Microsoft Edge WebView2 Runtime)
Linux, glibc 2.17+x64, arm64Janela nativa: GTK 3 e WebKitGTK 4.1 (Ubuntu 22.04+, Debian 12+ ou equivalente)
macOS 11+arm64, x64Usado 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/)
  • SHA256SUMS lista cada arquivo com seu SHA-256; uma pasta por alvo: linux-x64, linux-arm64, win32-x64, win32-arm64, win32-ia32, darwin-arm64, darwin-x64
bash
# 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 OK

No 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.

MIT-licensed examples · CaptchaLa is operated independently