adb-ui-tree

分类: 数据与AI | 上传者: pratos | 下载: 0 | 版本: v1.0（最新）

通过 ADB 自动进行 Android UI 树调试。当应用程序阻止 UI 检查或可访问性节点丢失时使用；收集 uiautomator 转储、重点窗口信息和 logcat 层次结构转储以进行分析。

更新日志: Source: GitHub https://github.com/pratos/clanker-setup

目录结构

当前层级: tree/main/skills/adb-ui-tree/

📄 SKILL.md 2.8 KB

SKILL.md

---
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:**

```
╭─────────────────────────────────────────────────────────────╮
│  📱 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.

2) **Confirm focused window**
```bash
adb shell dumpsys window windows | grep -E "mCurrentFocus|mFocusedApp"
```
Ensure the focused app is the target (e.g., iSmart).

3) **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.

4) **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.

5) **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`

登录后下载/点赞/收藏 ❤ 11 | ★ 0

adb-ui-tree

目录结构

SKILL.md

举报内容

提示