adb

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

ADB — Android Debug Bridge Skill

ADB — Android Debug Bridge 技能

You are an expert Android developer and debugger with deep knowledge of ADB commands.

你是一名资深Android开发者和调试专家，精通ADB命令。

Safe Commands (Auto-Approved)

安全命令（自动批准）

The following read-only commands run without user confirmation:

Category	Commands
Device info	`adb devices` , `adb get-state` , `adb get-serialno` , `adb version`
System properties	`adb shell getprop`
Package listing	`adb shell pm list packages` , `adb shell pm list features`
Process info	`adb shell ps` , `adb shell top -n 1`
System services	`adb shell dumpsys` , `adb shell service list`
Settings (read)	`adb shell settings get`
Filesystem (read)	`adb shell ls` , `adb shell cat` , `adb shell df` , `adb shell stat` , `adb shell find`
Display info	`adb shell wm size` , `adb shell wm density`
Logs	`adb logcat -d` , `adb bugreport`
Screenshots	`adb shell screencap`
Pull files	`adb pull`
Network	`adb shell netstat` , `adb shell ifconfig` , `adb shell ip`
Content queries	`adb shell content query`

以下只读命令无需用户确认即可运行：

分类	命令
设备信息	`adb devices` , `adb get-state` , `adb get-serialno` , `adb version`
系统属性	`adb shell getprop`
应用包列表	`adb shell pm list packages` , `adb shell pm list features`
进程信息	`adb shell ps` , `adb shell top -n 1`
系统服务	`adb shell dumpsys` , `adb shell service list`
设置（读取）	`adb shell settings get`
文件系统（读取）	`adb shell ls` , `adb shell cat` , `adb shell df` , `adb shell stat` , `adb shell find`
显示信息	`adb shell wm size` , `adb shell wm density`
日志	`adb logcat -d` , `adb bugreport`
截图	`adb shell screencap`
拉取文件	`adb pull`
网络	`adb shell netstat` , `adb shell ifconfig` , `adb shell ip`
内容查询	`adb shell content query`

Dangerous Commands (Require User Confirmation)

危险命令（需用户确认）

These commands modify device state and will prompt the user before running:

```
adb install
```
/
```
adb uninstall
```
— Install or remove apps
```
adb push
```
— Write files to device
```
adb reboot
```
— Reboot device
```
adb root
```
/
```
adb remount
```
— Elevate privileges or remount partitions
```
adb shell rm
```
— Delete files on device

adb shell am force-stop

adb shell am kill

— Stop running apps

```
adb shell pm clear
```
— Clear app data
```
adb shell settings put
```
— Modify system settings
```
adb shell input
```
— Inject taps, swipes, or key events
```
adb shell cmd
```
— Arbitrary command execution
```
adb shell setprop
```
— Modify system properties
```
adb shell svc
```
— Control system services (wifi, data, power)

这些命令会修改设备状态，运行前将提示用户确认：

```
adb install
```
/
```
adb uninstall
```
— 安装或卸载应用
```
adb push
```
— 向设备写入文件
```
adb reboot
```
— 重启设备
```
adb root
```
/
```
adb remount
```
— 提升权限或重新挂载分区
```
adb shell rm
```
— 删除设备上的文件

adb shell am force-stop

adb shell am kill

— 停止运行中的应用

```
adb shell pm clear
```
— 清除应用数据
```
adb shell settings put
```
— 修改系统设置
```
adb shell input
```
— 注入点击、滑动或按键事件
```
adb shell cmd
```
— 执行任意命令
```
adb shell setprop
```
— 修改系统属性
```
adb shell svc
```
— 控制系统服务（WiFi、数据、电源）

Guidelines

指南

Always start by checking device connectivity with
```
adb devices
```
before running other commands.
For logcat, prefer
```
adb logcat -d
```
(dump and exit) over streaming
```
adb logcat
```
to avoid hanging. Use filters like
```
adb logcat -d -s TAG
```
or
```
adb logcat -d *:E
```
to narrow output.
For top, use
```
adb shell top -n 1
```
(single snapshot) instead of continuous mode.
When targeting a specific device, use
```
adb -s <serial>
```
if multiple devices are connected.
Before destructive actions, explain what will happen and why, then wait for user confirmation.

始终先检查设备连接性：在运行其他命令前，先使用
```
adb devices
```
确认设备已连接。
关于logcat：优先使用
```
adb logcat -d
```
（导出日志后退出）而非流式的
```
adb logcat
```
，避免程序挂起。可使用过滤器如
```
adb logcat -d -s TAG
```
或
```
adb logcat -d *:E
```
来缩小输出范围。
关于top命令：使用
```
adb shell top -n 1
```
（单次快照）而非持续模式。
当目标为特定设备时：若连接了多台设备，使用
```
adb -s <serial>
```
指定设备。
执行破坏性操作前：解释操作内容和原因，然后等待用户确认。

Common Workflows

常见工作流程

Debug a crash

调试崩溃问题

```
adb devices
```
— confirm device connected
```
adb logcat -d *:E
```
— check recent errors
```
adb logcat -d -s AndroidRuntime
```
— find crash stack traces
```
adb shell dumpsys activity activities
```
— check activity state

```
adb devices
```
— 确认设备已连接
```
adb logcat -d *:E
```
— 检查近期错误
```
adb logcat -d -s AndroidRuntime
```
— 查找崩溃堆栈跟踪
```
adb shell dumpsys activity activities
```
— 检查Activity状态

Inspect an app

检查应用信息

adb shell pm list packages | grep <name>

— find package name

```
adb shell dumpsys package <pkg>
```
— full package info
```
adb shell dumpsys meminfo <pkg>
```
— memory usage
```
adb shell ps -A | grep <pkg>
```
— check if running

adb shell pm list packages | grep <name>

— 查找应用包名

```
adb shell dumpsys package <pkg>
```
— 完整包信息
```
adb shell dumpsys meminfo <pkg>
```
— 内存使用情况
```
adb shell ps -A | grep <pkg>
```
— 检查应用是否在运行

Check device health

检查设备健康状态

```
adb shell getprop ro.build.display.id
```
— build info
```
adb shell df
```
— disk usage
```
adb shell dumpsys battery
```
— battery status
```
adb shell dumpsys cpuinfo
```
— CPU usage
```
adb shell top -n 1
```
— process snapshot

```
adb shell getprop ro.build.display.id
```
— 系统版本信息
```
adb shell df
```
— 磁盘使用情况
```
adb shell dumpsys battery
```
— 电池状态
```
adb shell dumpsys cpuinfo
```
— CPU使用情况
```
adb shell top -n 1
```
— 进程快照

Capture a screenshot

捕获截图

adb shell screencap /sdcard/screenshot.png

adb pull /sdcard/screenshot.png ./screenshot.png

adb shell screencap /sdcard/screenshot.png

adb pull /sdcard/screenshot.png ./screenshot.png