MMCPMarkets
OA

openatx/android-uiautomator-server-jar

Developer tools
20 stars Quality 37 Trend 31
Repository Install

for github.com/openatx/uiautomator2

Overview

UIAutomator is a great tool to perform Android UI testing, but to do it, you have to write java code, compile it, install the jar, and run. It's a complex steps for all testers... This project is to build a light weight jsonrpc server in Android device, so that we can just write PC side script to write UIAutomator tests. In Android Studio -> Build -> Build App Bundle/APK -> Build APK Now apk file can be found in app/build/outputs/apk/debug/app-debug.apk If no port is provided, it defaults to 9008. Use -h to see all options. 脚本自动执行 adb forward tcp:9008 tcp:9008，无需手动转发。 方法定义文件 tools/methods.json 由 AutomatorService.java 接口同步生成，含所有方法的名称、参数类型、描述和示例值。 当 AutomatorService.java 接口有新增、删除或修改方法时，使用 sync-methods skill 同步更新 tools/methods.json。

README

Purpose

UIAutomator is a great tool to perform Android UI testing, but to do it, you have to write java code, compile it, install the jar, and run. It’s a complex steps for all testers…

This project is to build a light weight jsonrpc server in Android device, so that we can just write PC side script to write UIAutomator tests.

How to build

Build APK

Method 1:

In Android Studio -> Build -> Build App Bundle/APK -> Build APK

Method 2:

./gradlew assembleDebug

Now apk file can be found in app/build/outputs/apk/debug/app-debug.apk

Launch Jar server

adb push app/build/outputs/apk/debug/app-debug.apk /data/local/tmp
adb shell CLASSPATH=/data/local/tmp/app-debug.apk app_process / com.wetest.uia2.Main [-p port]

If no port is provided, it defaults to 9008. Use -h to see all options.

Test server

adb forward tcp:9008 tcp:9008
curl -X POST -d '{"jsonrpc": "2.0", "id": "1f0f2655716023254ed2b57ba4198815", "method": "deviceInfo", "params": {}}' 'http://127.0.0.1:9008/jsonrpc/0'
# Expect output like
{'currentPackageName': 'com.smartisanos.launcher',
 'displayHeight': 1920,
 'displayRotation': 0,
 'displaySizeDpX': 360,
 'displaySizeDpY': 640,
 'displayWidth': 1080,
 'productName': 'surabaya',
 'screenOn': True,
 'sdkInt': 23,
 'naturalOrientation': True}

JSON-RPC Test Tool

交互式 JSON-RPC 方法测试脚本，用于快速调试和验证各个 RPC 方法。

# 交互模式（分类菜单选择方法 → 输入参数 → 查看结果）
python3 tools/test_jsonrpc.py

# 直接调用
python3 tools/test_jsonrpc.py ping
python3 tools/test_jsonrpc.py click 100 200
python3 tools/test_jsonrpc.py dumpWindowHierarchy false

脚本自动执行 adb forward tcp:9008 tcp:9008，无需手动转发。

方法定义文件 tools/methods.json 由 AutomatorService.java 接口同步生成，含所有方法的名称、参数类型、描述和示例值。

Sync Methods.json

当 AutomatorService.java 接口有新增、删除或修改方法时，使用 sync-methods skill 同步更新 tools/methods.json。

在 opencode 中对 AI 说：

同步 methods

AI 将自动：解析 Java 源码 → 提取所有方法 → 生成 methods.json → 校验 JSON 合法性。

该 skill 位于 .opencode/skills/sync-methods/SKILL.md，纯 AI 驱动，无需额外脚本。

Resources

Notes

If you have any idea, please email [email protected] or submit tickets.

Dependencies

Added features

  • [x] support unicode input

Thanks to

View the full README on GitHub

Recommended Tools

Try a different keyword or remove a filter.

Install

npx skillfish add openatx/android-uiautomator-server-jar
New to MCP? Start with the mcpskill.org guide →