Skip to content

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 ​

PlattformArchitekturenCaptcha-Fenster
Windows 10 1809+ und Windows Serverx64, arm64, x86Natives Fenster (Microsoft Edge WebView2 Runtime)
Linux, glibc 2.17+x64, arm64Natives Fenster: GTK 3 und WebKitGTK 4.1 (Ubuntu 22.04+, Debian 12+ oder gleichwertig)
macOS 11+arm64, x64Vom 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/)
  • SHA256SUMS listet jede Datei mit ihrem SHA-256; ein Ordner pro Ziel: 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

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

MIT-licensed examples · CaptchaLa is operated independently