Skip to content

Runtime de escritorio ​

El runtime de escritorio de CaptchaLa es el conjunto de bibliotecas nativas para Windows, macOS y Linux sobre el que se construyen los SDK de escritorio. Versión actual: 1.2.0.

No integras el runtime directamente. Usa uno de estos SDK; incluyen o descargan el runtime correspondiente por ti:

  • SDK de Electron (@captcha-la/electron): el paquete npm contiene el runtime para todos los destinos compatibles.
  • SDK de Flutter (captchala): en Windows y Linux el plugin descarga el runtime durante la compilación y lo comprueba con hashes SHA-256 fijados.

Las apps nativas de macOS usan el SDK de iOS / macOS.

¿Necesitas una integración directa?

Si ni Electron ni Flutter encajan en tu app, contáctanos.

Plataformas ​

PlataformaArquitecturasVentana del captcha
Windows 10 1809+ y Windows Serverx64, arm64, x86Ventana nativa (Microsoft Edge WebView2 Runtime)
Linux, glibc 2.17+x64, arm64Ventana nativa: GTK 3 y WebKitGTK 4.1 (Ubuntu 22.04+, Debian 12+ o equivalente)
macOS 11+arm64, x64La usa el SDK de Electron

Desde 1.2.0 el runtime también se carga en Windows Server, incluidos Server Core y los servidores de terminal, sin instalar ninguna característica adicional de Windows.

En sistemas Linux anteriores a Ubuntu 22.04 / Debian 12 la ventana nativa del captcha no está disponible; allí el SDK de Electron muestra el captcha en su propia ventana.

Descarga y verificación ​

Las bibliotecas se publican en la CDN de paquetes versionada con checksums, para revisiones de seguridad o para replicarlas dentro de tu red:

  • URL base: https://pkg.captcha-pkg.net/desktop/1.2.0/ (réplica: https://pkg.captcha-cdn.net/desktop/1.2.0/)
  • SHA256SUMS lista cada archivo con su SHA-256; una carpeta por destino: 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

En Windows, compara Get-FileHash <file> -Algorithm SHA256 con la línea de SHA256SUMS. Para compilar una app de escritorio de Flutter desde una réplica, apunta CAPTCHALA_LOCAL_PREBUILDS a la carpeta (consulta Flutter: bibliotecas nativas).

Requisitos ​

  • Windows: Windows 10 1809+ o Windows Server; Microsoft Edge WebView2 Runtime para la ventana del captcha.
  • Linux: glibc 2.17+ y libcurl; GTK 3 y WebKitGTK 4.1 (webkit2gtk-4.1) para la ventana del captcha.
  • macOS: macOS 11+.

Validación en el servidor ​

Uses el SDK que uses, envía el pass token a tu backend y valídalo con POST https://verify.captcha.la/v1/validate. Consulta la Referencia de la API.

MIT-licensed examples · CaptchaLa is operated independently