Sync Methods

同步 methods.json

目标

读取 app/src/main/java/com/wetest/uia2/stub/AutomatorService.java，解析出所有 JSON-RPC 方法定义， 写入 tools/methods.json。

原则：不需要写任何 Python/脚本解析器，你作为 AI 直接阅读理解 Java 源码，提取信息，手写 JSON。

1. 读取源文件

app/src/main/java/com/wetest/uia2/stub/AutomatorService.java

跳过文件开头的 license 注释和 package/import 声明，从 public interface AutomatorService { 开始解析。

2. 解析规则

2.1 分区识别

Java 文件中以 /********** 开头的大注释块是分区标记：

分区标记之后、下一个分区标记之前的所有方法，默认属于该 category。 第一个分区标记之前的方法（ping、getLastToast、clearLastToast 等），category 为 core。 最后一个分区标记之后的方法（Configurator、Clipboard、launchApp 等），按覆盖表决定 category。

2.2 方法提取

对每个方法，提取以下信息：

a) description — 从 Javadoc 注释（/** ... */）的第一句话提取。只取 @param / @return / @throws 之前的内容，合并为一行。

b) name — 方法名。不包含返回类型和参数。

c) params — 参数列表，每个参数提取 {"name": "...", "type": "..."}：

• 跳过 final 修饰符
• 类型保留完整写法（如 int[]、Selector[]、String、boolean、long）
• @JsonRpcErrors 等注解跳过，不影响解析

d) 忽略的条目：

• final static int ERROR_CODE_BASE = -32000 等字段声明
• 被 /** Deprecated APIs ... */ 包裹的注释中的方法签名
• 空行和纯注释行

注意：重载方法是独立条目，每个重载单独生成一条记录（如 click 有多个重载）。

2.3 分类覆盖表

以下方法不跟随分区的默认 category，必须使用指定的分类：

# watcher 分类
hasWatcherTriggered
hasAnyWatcherTriggered
registerClickUiObjectWatcher
registerPressKeyskWatcher
removeWatcher
resetWatcherTriggers
runWatchers
getWatchers

# configurator 分类
getConfigurator
setConfigurator

# clipboard 分类
setClipboard
getClipboard
pasteClipboard
clearInputText

# app 分类
launchApp
executeShellCommand

3. 输出格式

写入 tools/methods.json，UTF-8 编码，2 空格缩进。完整 schema：

{
  "methods": [
    {
      "name": "方法名",
      "category": "core|uidevice|uiobject|uiscrollable|watcher|configurator|clipboard|app",
      "description": "从Javadoc第一句话提取的描述，英文原文",
      "params": [
        {"name": "参数名", "type": "参数类型"}
      ],
      "example": []
    }
  ],
  "categories": {
    "core": "Core (connection, device info, toast)",
    "uidevice": "UiDevice (click, swipe, key, screenshot)",
    "uiobject": "UiObject (find, text, click, drag)",
    "uiscrollable": "UiScrollable (scroll, fling)",
    "watcher": "Watcher",
    "configurator": "Configurator",
    "clipboard": "Clipboard",
    "app": "App (launch, shell)"
  }
}

example 字段生成规则

按参数类型依次生成示例值：

4. 写入 & 校验

4.1 写入文件

tools/methods.json

4.2 JSON 合法性校验

写完之后必须执行以下命令验证：

python3 -c "import json; data=json.load(open('tools/methods.json')); print(f'OK: {len(data[\"methods\"])} methods, {len(data[\"categories\"])} categories')"

如果报错，根据错误信息定位并修复 JSON，重新写入后再次校验，直到输出 OK: N methods, 8 categories。

5. 完成确认

校验通过后，告知用户同步结果：总共多少个方法，与上次相比有什么变化（如果有旧版本 methods.json 可以对比）。