デスクトップランタイム
CaptchaLa デスクトップランタイムは、デスクトップ SDK の基盤となる Windows、macOS、Linux 向けのネイティブライブラリ一式です。現在のバージョン: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 機能をインストールせずに読み込めます。
Ubuntu 22.04 / Debian 12 より古い Linux ではネイティブのキャプチャウィンドウは使えません。その場合、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 OKWindows では、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 リファレンスを参照してください。