Desktop-Runtime
Die CaptchaLa-Desktop-Runtime ist die Sammlung nativer Bibliotheken für Windows, macOS und Linux, auf der die Desktop-SDKs aufbauen. Aktuelle Version: 1.2.0.
Sie integrieren die Runtime nicht direkt. Verwenden Sie eines dieser SDKs; sie bringen die passende Runtime mit oder laden sie für Sie herunter:
- Electron-SDK (
@captcha-la/electron): Das npm-Paket enthält die Runtime für jedes unterstützte Ziel. - Flutter-SDK (
captchala): Unter Windows und Linux lädt das Plugin die Runtime beim Build herunter und prüft sie gegen fest hinterlegte SHA-256-Hashes.
Native macOS-Apps verwenden das iOS- / macOS-SDK.
Direkte Integration nötig?
Wenn weder Electron noch Flutter zu Ihrer App passt, kontaktieren Sie uns.
Plattformen
| Plattform | Architekturen | Captcha-Fenster |
|---|---|---|
| Windows 10 1809+ und Windows Server | x64, arm64, x86 | Natives Fenster (Microsoft Edge WebView2 Runtime) |
| Linux, glibc 2.17+ | x64, arm64 | Natives Fenster: GTK 3 und WebKitGTK 4.1 (Ubuntu 22.04+, Debian 12+ oder gleichwertig) |
| macOS 11+ | arm64, x64 | Vom Electron-SDK verwendet |
Seit 1.2.0 lädt die Runtime auch unter Windows Server, einschließlich Server Core und Terminalservern, ohne zusätzliche Windows-Features.
Auf Linux-Systemen, die älter als Ubuntu 22.04 / Debian 12 sind, ist das native Captcha-Fenster nicht verfügbar; das Electron-SDK zeigt das Captcha dort in einem eigenen Fenster an.
Download und Prüfung
Die Bibliotheken werden mit Prüfsummen im versionierten Paket-CDN veröffentlicht, für Sicherheitsprüfungen oder zum Spiegeln in Ihrem Netzwerk:
- Basis-URL:
https://pkg.captcha-pkg.net/desktop/1.2.0/(Mirror:https://pkg.captcha-cdn.net/desktop/1.2.0/) SHA256SUMSlistet jede Datei mit ihrem SHA-256; ein Ordner pro Ziel: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 OKUnter Windows vergleichen Sie Get-FileHash <file> -Algorithm SHA256 mit der Zeile in SHA256SUMS. Um eine Flutter-Desktop-App aus einem Mirror zu bauen, setzen Sie CAPTCHALA_LOCAL_PREBUILDS auf den Ordner (siehe Flutter: Native Bibliotheken).
Anforderungen
- Windows: Windows 10 1809+ oder Windows Server; Microsoft Edge WebView2 Runtime für das Captcha-Fenster.
- Linux: glibc 2.17+ und libcurl; GTK 3 und WebKitGTK 4.1 (
webkit2gtk-4.1) für das Captcha-Fenster. - macOS: macOS 11+.
Serverseitige Validierung
Unabhängig vom verwendeten SDK senden Sie das Pass-Token an Ihr Backend und validieren es mit POST https://verify.captcha.la/v1/validate. Siehe die API-Referenz.