Android调试指令收录

记录一下陌生指令。

dumpsys

1
2
3
4
5
6
dumpsys activity top | grep ACTIVITY

dumpsys:Android 系统自带的“系统服务状态转储”命令,可以查看系统各服务的当前状态。
activity:指定查看 Activity 管理服务(ActivityManagerService)的状态。
top:只看当前处于前台/栈顶的 Activity。
| grep ACTIVITY:用管道过滤,只保留包含 ACTIVITY 关键字的行。

pm

pm 是 Package Manager(包管理器)的缩写,是 Android 系统内置的一个命令行工具,用来管理设备上安装的应用包。
类似于apt,apt-get,或者archlinux的pacman

1
2
3
4
5
6
7
8
9
10
11
12
13
pm list packages                    # 列出所有已安装应用
pm list packages -s # 只列出系统应用
pm list packages -3 # 只列出第三方应用
pm list packages -d # 列出已禁用应用
pm list packages -i # 列出应用安装来源
pm list packages | grep tencent # 按关键字过滤
pm path 包名 # 查某个应用的APK路径
pm dump 包名 # 查看应用详细信息
pm uninstall 包名 # 卸载应用
pm install /sdcard/xxx.apk # 安装应用
pm clear 包名 # 清除应用数据
pm disable-user 包名 # 禁用应用
pm enable 包名 # 启用应用

uiautomator

1
2
3
4
5
6
7
uiautomator dump 路径                      # 把当前手机屏幕上所有可见控件的“对象清单”导出成一份 XML 文件,存在手机里。
uiautomator dump --compressed <文件路径> # 压缩模式导出,省略部分冗余属性,文件更小
uiautomator dump --windows <文件路径> # 导出所有可见窗口层级(默认只导出当前 Activity)
uiautomator dump /dev/stdout # 导出到标准输出,配合 grep 快速筛选控件
uiautomator events # 实时打印无障碍事件,观察界面变化/交互
uiautomator events -v # 打印详细事件,包含来源节点信息
uiautomator events --format json # 以 JSON 格式输出事件流,方便程序解析

am

adb shell 中最常用的命令之一,用于启动应用、启动服务、发送广播、管理任务等。

  1. start —— 启动 Activity
1
2
3
4
5
6
adb shell am start -n com.example.app/.MainActivity                              # 按包名/Activity 名启动
adb shell am start -n com.example.app/.MainActivity -e key value # 启动并传参
adb shell am start -n com.example.app/.MainActivity --ez flag true --ei num 123 # 传 boolean / int 等类型
adb shell am start -a android.intent.action.VIEW -d https://www.example.com # 指定 Action
adb shell am start -W -S -n com.example.app/.MainActivity # 强制停止后重启(-S),等待启动完成(-W)
adb shell am start -n com.example.app/.MainActivity --activity-new-task # 新任务栈中启动
参数 含义
-n <pkg>/<cls> 指定组件
-a <action> Intent Action
-d  Intent Data
-t <mime> MIME 类型
-c <category> Category
-e/--es <key> <val> String extra
--ez <key> <bool> Boolean extra
--ei <key> <int> Int extra
--el <key> <long> Long extra
-f <flags> Intent flags(如 0x10000000)
-W 等待启动完成并输出耗时
-S 启动前先 force-stop
-D 开启调试等待
2. startservice / stopservice —— 服务
1
2
adb shell am startservice -n com.example.app/.MyService
adb shell am stopservice -n com.example.app/.MyService

(Android 8.0+ 对后台启动服务有限制,可能失败。)
3. broadcast —— 发送广播

1
2
3
adb shell am broadcast -a com.example.MY_ACTION
adb shell am broadcast -a android.intent.action.BOOT_COMPLETED
adb shell am broadcast -n com.example.app/.MyReceiver -a com.example.MY_ACTION -e msg hello
  1. force-stop —— 强制停止应用
1
adb shell am force-stop com.example.app
  1. kill —— 杀进程
1
2
adb shell am kill com.example.app          # 杀后台进程
adb shell am kill-all # 杀所有后台进程
  1. 任务栈与 Activity 管理
1
2
3
4
5
adb shell am stack list                    # 列出任务栈(旧版本)
adb shell am task list # 列出任务
adb shell am task lock <taskId> # 锁定任务(屏幕固定)
adb shell am task resize <taskId> w h # 调整任务窗口大小
adb shell am start -n ... --activity-clear-task # 清空任务栈
  1. 其他常用
1
2
3
4
5
6
7
adb shell am instrument -w com.example.test/androidx.test.runner.AndroidJUnitRunner   # 跑测试
adb shell am monitor # 监控崩溃/ANR
adb shell am hang # 挂起(调试)
adb shell am dumpheap <pid> <file> # dump 堆内存
adb shell am profile start <process> <file> # 性能采样
adb shell am set-debug-app -w com.example.app # 设为调试应用并等待
adb shell am clear-debug-app
作者

纹云

发布于

2026-10-26

更新于

2026-10-26

许可协议

豫ICP备2023004969号-2 | 公安备案 川公网安备51010702042859号