adb 命令常用命令基本语法

adb 命令的基本语法如下：

adb [-d|-e|-s <serialNumber>] <command>

如果只有一个设备/模拟器连接时，可以省略掉 [-d|-e|-s <serialNumber>] 这一部分，直接使用 adb <command>。

为命令指定目标设备

如果有多个设备/模拟器连接，则需要为命令指定目标设备。

在多个设备/模拟器连接的情况下较常用的是 -s <serialNumber> 参数，serialNumber 可以通过 adb devices 命令获取。如：

$ adb devices

List of devices attached

cf264b8f device

emulator-5554 device

10.129.164.6:5555 device

输出里的 cf264b8f、emulator-5554 和 10.129.164.6:5555 即为 serialNumber。

比如这时想指定 cf264b8f 这个设备来运行 adb 命令获取屏幕分辨率：

adb -s cf264b8f shell wm size

又如想给 10.129.164.6:5555 这个设备安装应用（这种形式的 serialNumber 格式为 <IP>:<Port>，一般为无线连接的设备或 Genymotion 等第三方 Android 模拟器）：

adb -s 10.129.164.6:5555 install test.apk

遇到多设备/模拟器的情况均使用这几个参数为命令指定目标设备，下文中为简化描述，不再重复。

启动/停止

启动 adb server 命令：

adb start-server

（一般无需手动执行此命令，在运行 adb 命令时若发现 adb server 没有启动会自动调起。）

停止 adb server 命令：

adb kill-server

查看 adb 版本

命令： adb version

指定 adb server 的网络端口

命令： adb -P <port> start-server

默认端口为 5037。

设备连接管理

查询已连接设备/模拟器

命令：

adb devices

USB 连接

通过 USB 连接来正常使用 adb 需要保证几点：

1. 硬件状态正常。

包括 Android 设备处于正常开机状态，USB 连接线和各种接口完好。

1. Android 设备的开发者选项和 USB 调试模式已开启。

可以到「设置」-「开发者选项」-「Android 调试」查看。

如果在设置里找不到开发者选项，那需要通过一个彩蛋来让它显示出来：在「设置」-「关于手机」连续点击「版本号」7 次。

1. 设备驱动状态正常。
2. 通过 USB 线连接好电脑和设备后确认状态。
3. adb devices

如果能看到

xxxxxx device

说明连接成功。

无线连接（需要借助 USB 线）

除了可以通过 USB 连接设备与电脑来使用 adb，也可以通过无线连接——虽然连接过程中也有需要使用 USB 的步骤，但是连接成功之后你的设备就可以在一定范围内摆脱 USB 连接线的限制啦！

操作步骤：

1. 将 Android 设备与要运行 adb 的电脑连接到同一个局域网，比如连接到同一个 WiFi。
2. 将设备与电脑通过 USB 线连接。

应确保连接成功（可运行 adb devices 看是否能列出该设备）。

1. 让设备在 5555 端口监听 TCP/IP 连接：
2. adb tcpip 5555
3. 断开 USB 连接。
4. 找到设备的 IP 地址。
5. 通过 IP 地址连接设备。
6. adb connect <device-ip-address>

这里的 <device-ip-address> 就是上一步中找到的设备 IP 地址。

1. 确认连接状态。
2. adb devices

如果能看到

<device-ip-address>:5555 device

说明连接成功。

如果连接不了，请确认 Android 设备与电脑是否连接到了同一个 WiFi，然后再次执行 adb connect <device-ip-address> 那一步；

如果还是不行的话，通过 adb kill-server 重新启动 adb 然后从头再来一次试试。

断开无线连接

命令：

adb disconnect <device-ip-address>

应用管理

查看应用列表

查看应用列表的基本命令格式是

adb shell pm list packages [-f] [-d] [-e] [-s] [-3] [-i] [-u] [--user USER_ID] [FILTER]

即在 adb shell pm list packages 的基础上可以加一些参数进行过滤查看不同的列表，支持的过滤参数如下：

所有应用

命令：

adb shell pm list packages

系统应用

命令：

adb shell pm list packages -s

第三方应用

命令：

adb shell pm list packages -3

包名包含某字符串的应用

比如要查看包名包含字符串 mazhuang 的应用列表，命令：

adb shell pm list packages mazhuang

当然也可以使用 grep 来过滤：

adb shell pm list packages | grep mazhuang

安装 APK

命令格式：

adb install [-lrtsdg] <path_to_apk>

参数：

adb install 后面可以跟一些可选参数来控制安装 APK 的行为，可用参数及含义如下：

运行命令后如果见到类似如下输出（状态为 Success）代表安装成功：

[100%] /data/local/tmp/1.apk

pkg: /data/local/tmp/1.apk

Success

卸载应用

命令：

adb uninstall [-k] <packagename>

<packagename> 表示应用的包名，-k 参数可选，表示卸载应用但保留数据和缓存目录。

清除应用数据与缓存

命令：

adb shell pm clear <packagename>

<packagename> 表示应用名包，这条命令的效果相当于在设置里的应用信息界面点击了「清除缓存」和「清除数据」。

查看前台 Activity

命令：

adb shell dumpsys activity activities | grep mFocusedActivity

查看正在运行的 Services

命令：

adb shell dumpsys activity services [<packagename>]

<packagename> 参数不是必须的，指定 <packagename> 表示查看与某个包名相关的 Services，不指定表示查看所有 Services。

<packagename> 不一定要给出完整的包名，比如运行 adb shell dumpsys activity services org.mazhuang，那么包名 org.mazhuang.demo1、org.mazhuang.demo2 和 org.mazhuang123 等相关的 Services 都会列出来。

查看应用详细信息

命令：

adb shell dumpsys package <packagename>

输出中包含很多信息，包括 Activity Resolver Table、Registered ContentProviders、包名、userId、安装后的文件资源代码等路径、版本信息、权限信息和授予状态、签名版本信息等。

<packagename> 表示应用包名。

查看应用安装路径

命令:

adb shell pm path <PACKAGE>

输出应用安装路径

输出示例:

adb shell pm path ecarx.weather

package:/data/app/ecarx.weather-1.apk

启动应用/ 调起 Activity

命令格式：

adb shell am start [options] <INTENT>

例如：

adb shell am start -n com.tencent.mm/.ui.LauncherUI

表示调起微信主界面。

adb shell am start -n org.mazhuang.boottimemeasure/.MainActivity --es "toast" "hello, world"

表示调起 org.mazhuang.boottimemeasure/.MainActivity 并传给它 string 数据键值对 toast - hello, world。

发送广播

命令格式：

adb shell am broadcast [options] <INTENT>

可以向所有组件广播，也可以只向指定组件广播。

这类用法在测试的时候很实用，比如某个广播的场景很难制造，可以考虑通过这种方式来发送广播。

既能发送系统预定义的广播，也能发送自定义广播。如下是部分系统预定义广播及正常触发时机：

（以上广播均可使用 adb 触发）

强制停止应用

命令：

adb shell am force-stop <packagename>

文件管理

复制设备里的文件到电脑

命令：

adb pull <设备里的文件路径> [电脑上的目录]

其中 电脑上的目录 参数可以省略，默认复制到当前目录。

例：

adb pull /sdcard/sr.mp4 ~/tmp/

复制电脑里的文件到设备

命令：

adb push <电脑上的文件路径> <设备里的目录>

模拟按键/输入

在 adb shell 里有个很实用的命令叫 input，通过它可以做一些有趣的事情。

下面是 input 命令的一些用法举例。

电源键

命令：

adb shell input keyevent 26

执行效果相当于按电源键。

菜单键

命令：

adb shell input keyevent 82

HOME 键

命令：

adb shell input keyevent 3

返回键

命令：

adb shell input keyevent 4

音量控制

增加音量：

adb shell input keyevent 24

降低音量：

adb shell input keyevent 25

静音：

adb shell input keyevent 164

媒体控制

播放/暂停：

adb shell input keyevent 85

停止播放：

adb shell input keyevent 86

播放下一首：

adb shell input keyevent 87

播放上一首：

adb shell input keyevent 88

恢复播放：

adb shell input keyevent 126

暂停播放：

adb shell input keyevent 127

点亮/熄灭屏幕

可以通过上文讲述过的模拟电源键来切换点亮和熄灭屏幕，但如果明确地想要点亮或者熄灭屏幕，那可以使用如下方法。

点亮屏幕：

adb shell input keyevent 224

熄灭屏幕：

adb shell input keyevent 223

滑动解锁

如果锁屏没有密码，是通过滑动手势解锁，那么可以通过 input swipe 来解锁。

命令（参数以机型 Nexus 5，向上滑动手势解锁举例）：

adb shell input swipe 300 1000 300 500

参数 300 1000 300 500 分别表示起始点x坐标 起始点y坐标 结束点x坐标 结束点y坐标。

输入文本

在焦点处于某文本框时，可以通过 input 命令来输入文本。

命令：

adb shell input text hello

现在 hello 出现在文本框了。

查看设备信息

型号

命令：

adb shell getprop ro.product.model

电池状况

命令：

adb shell dumpsys battery

屏幕分辨率

命令：

adb shell wm size

屏幕密度

命令：

adb shell wm density

显示屏参数

命令：

adb shell dumpsys window displays

android_id

命令：

adb shell settings get secure android_id

Android 系统版本

命令：

adb shell getprop ro.build.version.release

命令：

adb shell wm size 480x1024

表示将分辨率修改为 480px * 1024px。

恢复原分辨率命令：

adb shell wm size reset

实用功能

屏幕截图

截图保存到电脑：

adb exec-out screencap -p > sc.png

如果 adb 版本较老，无法使用 exec-out 命令，这时候建议更新 adb 版本。无法更新的话可以使用以下麻烦点的办法：

先截图保存到设备里：

adb shell screencap -p /sdcard/sc.png

然后将 png 文件导出到电脑：

adb pull /sdcard/sc.png

可以使用 adb shell screencap -h 查看 screencap 命令的帮助信息，下面是两个有意义的参数及含义：

实测如果指定文件名以 .png 结尾时可以省略 -p 参数；否则需要使用 -p 参数。如果不指定文件名，截图文件的内容将直接输出到 stdout。

另外一种一行命令截图并保存到电脑的方法：

Linux 和 Windows

adb shell screencap -p | sed "s/\r$//" > sc.png

Mac OS X

adb shell screencap -p | gsed "s/\r$//" > sc.png

这个方法需要用到 gnu sed 命令，在 Linux 下直接就有，在 Windows 下 Git 安装目录的 bin 文件夹下也有。如果确实找不到该命令，可以下载 sed for Windows 并将 sed.exe 所在文件夹添加到 PATH 环境变量里。

录制屏幕

录制屏幕以 mp4 格式保存到 /sdcard：

adb shell screenrecord /sdcard/filename.mp4

需要停止时按 Ctrl-C，默认录制时间和最长录制时间都是 180 秒。

如果需要导出到电脑：

adb pull /sdcard/filename.mp4

可以使用 adb shell screenrecord --help 查看 screenrecord 命令的帮助信息，下面是常见参数及含义：