Skip to content

デスクトップランタイム ​

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 Serverx64、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、x64Electron 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
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

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 リファレンスを参照してください。

MIT-licensed examples · CaptchaLa is operated independently