--- title: 데스크톱 런타임 description: "CaptchaLa 데스크톱 런타임 1.2.0: Electron 및 Flutter 데스크톱 SDK가 사용하는 Windows, macOS, Linux용 네이티브 라이브러리, 지원 플랫폼, 검증이나 미러링에 쓰는 SHA256SUMS." --- # 데스크톱 런타임 CaptchaLa 데스크톱 런타임은 데스크톱 SDK의 기반이 되는 **Windows**, **macOS**, **Linux**용 네이티브 라이브러리 모음입니다. 현재 버전: **1.2.0**. 런타임을 직접 통합하지 않습니다. 다음 SDK 중 하나를 사용하세요. 맞는 런타임을 함께 제공하거나 받아 옵니다. - **[Electron SDK](./electron)**(`@captcha-la/electron`): npm 패키지에 지원하는 모든 대상용 런타임이 들어 있습니다. - **[Flutter SDK](./flutter)**(`captchala`): Windows와 Linux에서는 플러그인이 빌드 시 런타임을 내려받아 고정된 SHA-256 해시로 검증합니다. 네이티브 macOS 앱은 [iOS / macOS SDK](./ios)를 사용하세요. ::: tip 직접 통합이 필요하신가요? Electron과 Flutter 모두 앱에 맞지 않는다면 [문의해 주세요](https://dash.captcha.la/support). ::: ## 플랫폼 {#platforms} | 플랫폼 | 아키텍처 | 캡차 창 | | --- | --- | --- | | 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부터 런타임은 Server Core와 터미널 서버를 포함한 Windows Server에서도 추가 Windows 기능을 설치하지 않고 로드됩니다. Ubuntu 22.04 / Debian 12보다 오래된 Linux 시스템에서는 네이티브 캡차 창을 사용할 수 없으며, 이 경우 Electron SDK가 자체 창에 캡차를 표시합니다. ## 다운로드 및 검증 {#download} 라이브러리는 체크섬과 함께 버전별 패키지 CDN에 게시되며, 보안 검토나 내부 네트워크 미러링에 사용할 수 있습니다. - 기본 URL: `https://pkg.captcha-pkg.net/desktop/1.2.0/`(미러: `https://pkg.captcha-cdn.net/desktop/1.2.0/`) - [`SHA256SUMS`](https://pkg.captcha-pkg.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 -Algorithm SHA256` 결과를 `SHA256SUMS`의 해당 줄과 비교하세요. 미러에서 Flutter 데스크톱 앱을 빌드하려면 `CAPTCHALA_LOCAL_PREBUILDS`를 해당 폴더로 지정하세요 ([Flutter: 네이티브 라이브러리](./flutter#native-libraries) 참고). ## 요구 사항 {#requirements} - **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 레퍼런스](../api-reference)를 참고하세요.