Десктопная среда выполнения
Десктопная среда выполнения CaptchaLa — это набор нативных библиотек для Windows, macOS и Linux, на которых построены десктопные SDK. Текущая версия: 1.2.0.
Напрямую среду выполнения не интегрируют. Используйте один из этих SDK: они содержат или сами загружают подходящую версию среды выполнения:
- Electron SDK (
@captcha-la/electron): npm-пакет содержит среду выполнения для всех поддерживаемых платформ. - Flutter SDK (
captchala): в Windows и Linux плагин загружает среду выполнения во время сборки и проверяет её по закреплённым хешам SHA-256.
Нативные приложения для macOS используют iOS / macOS SDK.
Нужна прямая интеграция?
Если ни Electron, ни Flutter не подходят для вашего приложения, свяжитесь с нами.
Платформы
| Платформа | Архитектуры | Окно капчи |
|---|---|---|
| Windows 10 1809+ и Windows Server | x64, arm64, x86 | Нативное окно (Microsoft Edge WebView2 Runtime) |
| Linux, glibc 2.17+ | x64, arm64 | Нативное окно: GTK 3 и WebKitGTK 4.1 (Ubuntu 22.04+, Debian 12+ или аналог) |
| macOS 11+ | arm64, x64 | Используется Electron SDK |
Начиная с 1.2.0 среда выполнения загружается и на Windows Server, включая Server Core и терминальные серверы, без установки дополнительных компонентов Windows.
В системах Linux старше Ubuntu 22.04 / Debian 12 нативное окно капчи недоступно; там Electron SDK показывает капчу в собственном окне.
Загрузка и проверка
Библиотеки публикуются на версионированном CDN пакетов вместе с контрольными суммами — для проверки безопасности или зеркалирования внутри вашей сети:
- Базовый URL:
https://pkg.captcha-pkg.net/desktop/1.2.0/(зеркало:https://pkg.captcha-cdn.net/desktop/1.2.0/) SHA256SUMSсодержит каждый файл с его SHA-256; по одной папке на платформу: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 OKВ Windows сравните вывод Get-FileHash <file> -Algorithm SHA256 со строкой в SHA256SUMS. Чтобы собрать десктопное приложение Flutter из зеркала, укажите папку в CAPTCHALA_LOCAL_PREBUILDS (см. Flutter: нативные библиотеки).
Требования
- Windows: Windows 10 1809+ или Windows Server; Microsoft Edge WebView2 Runtime для окна капчи.
- Linux: glibc 2.17+ и libcurl; GTK 3 и WebKitGTK 4.1 (
webkit2gtk-4.1) для окна капчи. - macOS: macOS 11+.
Проверка на сервере
Какой бы SDK вы ни использовали, отправьте pass token на ваш бэкенд и проверьте его через POST https://verify.captcha.la/v1/validate. См. справочник API.