AgentSkillsCN

adb-ui-tree

借助 ADB 自动化 Android UI 树的调试过程。当应用阻止 UI 检查，或缺失无障碍节点时，此功能可派上用场；它会收集 uiautomator 转储、焦点窗口信息，以及 logcat 层次结构转储，供后续分析使用。

SKILL.md
--- frontmatter
name: adb-ui-tree
description: Automates Android UI-tree debugging via ADB. Use when an app blocks UI inspection or accessibility nodes are missing; collects uiautomator dumps, focused window info, and logcat hierarchy dumps for analysis.

ADB UI Tree Debugging Skill

Activation

When this skill is triggered, ALWAYS display this banner first:

code
╭─────────────────────────────────────────────────────────────╮
│  📱 SKILL ACTIVATED: adb-ui-tree                            │
├─────────────────────────────────────────────────────────────┤
│  Target: [app/screen being inspected]                       │
│  Action: Collecting UI hierarchy via ADB...                 │
│  Output: ui.xml, screen.png, accessibility logs             │
╰─────────────────────────────────────────────────────────────╯

Use this skill when you need to inspect Android UI trees, especially when an app blocks normal debugging/inspection. It provides a repeatable, automatic flow to collect UI hierarchy data, focused window info, and accessibility logs.

Preconditions

  • •ADB is installed and available.
  • •A device is connected and authorized (adb devices).
  • •The target app is open on screen.

Steps

  1. •Verify device connectivity
bash
adb devices

If multiple devices are attached, use -s <serial> for all commands.

  1. •Confirm focused window
bash
adb shell dumpsys window windows | grep -E "mCurrentFocus|mFocusedApp"

Ensure the focused app is the target (e.g., iSmart).

  1. •Try UIAutomator dump (may be blocked)
bash
adb shell uiautomator dump /sdcard/ui.xml
adb pull /sdcard/ui.xml .

If the app blocks the dump, note the error and continue to step 4.

  1. •Collect accessibility hierarchy logs If the project includes a custom AccessibilityService that logs a hierarchy dump, trigger the automation and capture logcat:
bash
adb logcat -s BatteryTrackerA11y

Save the output for analysis.

  1. •Capture a screenshot for manual inspection
bash
adb exec-out screencap -p > screen.png

Use the screenshot to verify UI state and map coordinates if needed.

Notes / Fallbacks

  • •If the app exposes no accessibility nodes, consider coordinate-based taps as a fallback.
  • •If uiautomator dump is prohibited by the app, rely on AccessibilityService logs and screenshots.

Output to share

  • •ui.xml (if available)
  • •adb logcat -s BatteryTrackerA11y output
  • •screen.png