uicheck_android
Source: README
Install
Android library: https://github.com/uicheck/uicheck, path packages/android
Android 原生运行时客户端。它把真实 Android 应用通过 WebSocket 接到 @uicheck/mcp,让 AI 请求截图并检查 Android view tree。
安装
把这个仓库作为 Android library 依赖添加:
https://github.com/uicheck/uicheck
包路径:
packages/android
单独启动 MCP 服务:
npx @uicheck/mcp
使用
在应用启动时安装客户端:
import ai.uicheck.android.UiCheckAndroidOptions
import ai.uicheck.android.UiCheckAndroidSocketOptions
import ai.uicheck.android.initUiCheck
val client = initUiCheck(
UiCheckAndroidOptions(
socket = UiCheckAndroidSocketOptions(
url = "ws://127.0.0.1:17322/socket",
clientId = "android-demo"
),
activity = this
)
)
不再需要时释放:
client.close()
选项
| 选项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
socket.url | String | - | @uicheck/mcp WebSocket 地址 |
socket.clientId | String | - | 可选的稳定客户端 ID |
socket.reconnectMs | Long | 1000 | 断线重连间隔 |
activity | Activity | - | 当前 Activity,用来自动读取根 View 和截图 |
screenshot | function | - | 可选截图 provider,用于 capture_page、capture_element 和 compare_screenshot,返回 PNG base64 |