ADB,即 Android Debug Bridge,它是 Android 开发/测试人员不可替代的强大工具,也是 Android 设备玩家的好玩具。html
持续更新中,欢迎补充指正,以为有用的能够将 此 GitHub 仓库 Star 收藏备用。java
注:有部分命令的支持状况可能与 Android 系统版本及定制 ROM 的实现有关。node
基本用法
命令语法
adb 命令的基本语法以下:linux
adb [-d|-e|-s ]
若是只有一个设备/模拟器链接时,能够省略掉 [-d|-e|-s ]
这一部分,直接使用 adb
。android
为命令指定目标设备
若是有多个设备/模拟器链接,则须要为命令指定目标设备。git
参数 | 含义 |
---|---|
-d | 指定当前惟一经过 USB 链接的 Android 设备为命令目标 |
-e | 指定当前惟一运行的模拟器为命令目标 |
-s |
指定相应 serialNumber 号的设备/模拟器为命令目标 |
在多个设备/模拟器链接的状况下较经常使用的是 -s
参数,serialNumber 能够经过 adb devices
命令获取。如:github
$ adb devices List of devices attached cf264b8f device emulator-5554 device
输出里的 cf264b8f
和 emulator-5554
即为 serialNumber。好比这时想指定 cf264b8f
这个设备来运行 adb 命令获取屏幕分辨率:web
adb -s cf264b8f shell wm size
遇到多设备/模拟器的状况均使用这几个参数为命令指定目标设备,下文中为简化描述,再也不重复。shell
启动/中止
启动 adb server 命令:数组
adb start-server
(通常无需手动执行此命令,在运行 adb 命令时若发现 adb server 没有启动会自动调起。)
中止 adb server 命令:
adb kill-server
查看 adb 版本
命令:
adb version
示例输出:
Android Debug Bridge version 1.0.32 Revision 09a0d98bebce-android
以 root 权限运行 adbd
adb 的运行原理是 PC 端的 adb server 与手机端的守护进程 adbd 创建链接,而后 PC 端的 adb client 经过 adb server 转发命令,adbd 接收命令后解析运行。
因此若是 adbd 以普通权限执行,有些须要 root 权限才能执行的命令没法直接用 adb xxx
执行。这时能够 adb shell
而后 su
后执行命令,也可让 adbd 以 root 权限执行,这个就能随意执行高权限命令了。
命令:
adb root
正常输出:
restarting adbd as root
如今再运行 adb shell
,看看命令行提示符是否是变成 #
了?
有些手机 root 后也没法经过 adb root
命令让 adbd 以 root 权限执行,好比三星的部分机型,会提示 adbd cannot run as root in production builds
,此时能够先安装 adbd Insecure,而后 adb root
试试。
相应地,若是要恢复 adbd 为非 root 权限的话,可使用 adb unroot
命令。
指定 adb server 的网络端口
命令:
adb -P start-server
默认端口为 5037。
设备链接管理
查询已链接设备/模拟器
命令:
adb devices
输出示例:
List of devices attached cf264b8f device emulator-5554 device
输出格式为 [serialNumber] [state]
,serialNumber 即咱们常说的 SN,state 有以下几种:
-
offline
—— 表示设备未链接成功或无响应。 -
device
—— 设备已链接。注意这个状态并不能标识 Android 系统已经彻底启动和可操做,在设备启动过程当中设备实例就可链接到 adb,但启动完毕后系统才处于可操做状态。 -
no device
—— 没有设备/模拟器链接。
以上输出显示当前已经链接了两台设备/模拟器,cf264b8f
与 emulator-5554
分别是它们的 SN。从 emulator-5554
这个名字能够看出它是一个 Android 模拟器。
常见异常输出:
-
没有设备/模拟器链接成功。
List of devices attached
-
设备/模拟器未链接到 adb 或无响应。
List of devices attached cf264b8f offline
USB 链接
经过 USB 链接来正常使用 adb 须要保证几点:
-
硬件状态正常。
包括 Android 设备处于正常开机状态,USB 链接线和各类接口无缺。
-
Android 设备的开发者选项和 USB 调试模式已开启。
能够到「设置」-「开发者选项」-「Android 调试」查看。
若是在设置里找不到开发者选项,那须要经过一个彩蛋来让它显示出来:在「设置」-「关于手机」连续点击「版本号」7 次。
-
设备驱动状态正常。
这一点貌似在 Linux 和 Mac OS X 下不用操心,在 Windows 下有可能遇到须要安装驱动的状况,确认这一点能够右键「计算机」-「属性」,到「设备管理器」里查看相关设备上是否有黄色感叹号或问号,若是没有就说明驱动状态已经好了。不然能够下载一个手机助手类程序来安装驱动先。
-
经过 USB 线链接好电脑和设备后确认状态。
adb devices
若是能看到
xxxxxx device
说明链接成功。
无线链接
除了能够经过 USB 链接设备与电脑来使用 adb,也能够经过无线链接——虽然链接过程当中也有须要使用 USB 的步骤,可是链接成功以后你的设备就能够在必定范围内摆脱 USB 链接线的限制啦!
操做步骤:
-
将 Android 设备与将运行 adb 的电脑链接到同一个局域网,好比连到同一个 WiFi。
-
将设备与电脑经过 USB 线链接。
应确保链接成功(可运行
adb devices
看是否能列出该设备)。 -
让设备在 5555 端口监听 TCP/IP 链接:
adb tcpip 5555
-
断开 USB 链接。
-
找到设备的 IP 地址。
通常能在「设置」-「关于手机」-「状态信息」-「IP地址」找到。
-
经过 IP 地址链接设备。
adb connect
这里的
就是上一步中找到的设备 IP 地址。
-
确认链接状态。
adb devices
若是能看到
:5555 device
说明链接成功。
若是链接不了,请确认 Android 设备与电脑是链接到了同一个 WiFi,而后再次执行 adb connect
那一步;
若是仍是不行的话,经过 adb kill-server
从新启动 adb 而后从头再来一次试试。
断开无线链接
命令:
adb disconnect
应用管理
查看应用列表
查看应用列表的基本命令格式是
adb shell pm list packages [-f] [-d] [-e] [-s] [-3] [-i] [-u] [--user USER_ID] [FILTER]
即在 adb shell pm list packages
的基础上能够加一些参数进行过滤查看不一样的列表,支持的过滤参数以下:
参数 | 显示列表 |
---|---|
无 | 全部应用 |
-f | 显示应用关联的 apk 文件 |
-d | 只显示 disabled 的应用 |
-e | 只显示 enabled 的应用 |
-s | 只显示系统应用 |
-3 | 只显示第三方应用 |
-i | 显示应用的 installer |
-u | 包含已卸载应用 |
包名包含 字符串 |
全部应用
命令:
adb shell pm list packages
输出示例:
package:com.android.smoketest package:com.example.android.livecubes package:com.android.providers.telephony package:com.google.android.googlequicksearchbox package:com.android.providers.calendar package:com.android.providers.media package:com.android.protips package:com.android.documentsui package:com.android.gallery package:com.android.externalstorage ... // other packages here ...
系统应用
命令:
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
参数:
adb install
后面能够跟一些参数来控制安装 APK 的行为,经常使用参数及含义以下:
参数 | 含义 |
---|---|
-r | 容许覆盖安装。 |
-s | 将应用安装到 sdcard。 |
-d | 容许降级覆盖安装。 |
完整参数列表及含义能够直接运行 adb
命令而后查看 adb install [-lrtsdg]
一节。
若是见到相似以下输出(状态为 Success
)表明安装成功:
12040 KB/s (22205609 bytes in 1.801s) pkg: /data/local/tmp/SogouInput_android_v8.3_sweb.apk Success
而若是状态为 Failure
则表示安装失败。常见安装失败输出代码、含义及可能的解决办法以下:
输出 | 含义 | 解决办法 |
---|---|---|
INSTALL_FAILED_ALREADY_EXISTS | 应用已经存在 | 使用 -r 参数 |
INSTALL_FAILED_INVALID_APK | 无效的 APK 文件 | |
INSTALL_FAILED_INVALID_URI | 无效的 APK 文件名 | 确保 APK 文件名里无中文 |
INSTALL_FAILED_INSUFFICIENT_STORAGE | 空间不足 | 清理空间 |
INSTALL_FAILED_DUPLICATE_PACKAGE | 已经存在同名程序 | |
INSTALL_FAILED_NO_SHARED_USER | 请求的共享用户不存在 | |
INSTALL_FAILED_UPDATE_INCOMPATIBLE | 已经安装过签名不同的同名应用,且数据没有移除 | |
INSTALL_FAILED_SHARED_USER_INCOMPATIBLE | 请求的共享用户存在但签名不一致 | |
INSTALL_FAILED_MISSING_SHARED_LIBRARY | 安装包使用了设备上不可用的共享库 | |
INSTALL_FAILED_REPLACE_COULDNT_DELETE | 替换时没法删除 | |
INSTALL_FAILED_DEXOPT | dex 优化验证失败或空间不足 | |
INSTALL_FAILED_OLDER_SDK | 设备系统版本低于应用要求 | |
INSTALL_FAILED_CONFLICTING_PROVIDER | 设备里已经存在与应用里同名的 content provider | |
INSTALL_FAILED_NEWER_SDK | 设备系统版本高于应用要求 | |
INSTALL_FAILED_TEST_ONLY | 应用是 test-only 的,但安装时没有指定 -t 参数 |
|
INSTALL_FAILED_CPU_ABI_INCOMPATIBLE | 包含不兼容设备 CPU 应用程序二进制接口的 native code | |
INSTALL_FAILED_MISSING_FEATURE | 应用使用了设备不可用的功能 | |
INSTALL_FAILED_CONTAINER_ERROR | sdcard 访问失败 | 确认 sdcard 可用,或者安装到内置存储 |
INSTALL_FAILED_INVALID_INSTALL_LOCATION | 不能安装到指定位置 | 切换安装位置,添加或删除 -s 参数 |
INSTALL_FAILED_MEDIA_UNAVAILABLE | 安装位置不可用 | 通常为 sdcard,确认 sdcard 可用或安装到内置存储 |
INSTALL_FAILED_VERIFICATION_TIMEOUT | 验证安装包超时 | |
INSTALL_FAILED_VERIFICATION_FAILURE | 验证安装包失败 | |
INSTALL_FAILED_PACKAGE_CHANGED | 应用与调用程序指望的不一致 | |
INSTALL_FAILED_UID_CHANGED | 之前安装过该应用,与本次分配的 UID 不一致 | 清除之前安装过的残留文件 |
INSTALL_FAILED_VERSION_DOWNGRADE | 已经安装了该应用更高版本 | 使用 -d 参数 |
INSTALL_FAILED_PERMISSION_MODEL_DOWNGRADE | 已安装 target SDK 支持运行时权限的同名应用,要安装的版本不支持运行时权限 | |
INSTALL_PARSE_FAILED_NOT_APK | 指定路径不是文件,或不是以 .apk 结尾 |
|
INSTALL_PARSE_FAILED_BAD_MANIFEST | 没法解析的 AndroidManifest.xml 文件 | |
INSTALL_PARSE_FAILED_UNEXPECTED_EXCEPTION | 解析器遇到异常 | |
INSTALL_PARSE_FAILED_NO_CERTIFICATES | 安装包没有签名 | |
INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES | 已安装该应用,且签名与 APK 文件不一致 | 先卸载设备上的该应用,再安装 |
INSTALL_PARSE_FAILED_CERTIFICATE_ENCODING | 解析 APK 文件时遇到 CertificateEncodingException |
|
INSTALL_PARSE_FAILED_BAD_PACKAGE_NAME | manifest 文件里没有或者使用了无效的包名 | |
INSTALL_PARSE_FAILED_BAD_SHARED_USER_ID | manifest 文件里指定了无效的共享用户 ID | |
INSTALL_PARSE_FAILED_MANIFEST_MALFORMED | 解析 manifest 文件时遇到结构性错误 | |
INSTALL_PARSE_FAILED_MANIFEST_EMPTY | 在 manifest 文件里找不到找可操做标签(instrumentation 或 application) | |
INSTALL_FAILED_INTERNAL_ERROR | 因系统问题安装失败 | |
INSTALL_FAILED_USER_RESTRICTED | 用户被限制安装应用 | |
INSTALL_FAILED_DUPLICATE_PERMISSION | 应用尝试定义一个已经存在的权限名称 | |
INSTALL_FAILED_NO_MATCHING_ABIS | 应用包含设备的应用程序二进制接口不支持的 native code | |
INSTALL_CANCELED_BY_USER | 应用安装须要在设备上确认,但未操做设备或点了取消 | 在设备上赞成安装 |
INSTALL_FAILED_ACWF_INCOMPATIBLE | 应用程序与设备不兼容 | |
does not contain AndroidManifest.xml | 无效的 APK 文件 | |
is not a valid zip file | 无效的 APK 文件 | |
Offline | 设备未链接成功 | 先将设备与 adb 链接成功 |
unauthorized | 设备未受权容许调试 | |
error: device not found | 没有链接成功的设备 | 先将设备与 adb 链接成功 |
protocol failure | 设备已断开链接 | 先将设备与 adb 链接成功 |
Unknown option: -s | Android 2.2 如下不支持安装到 sdcard | 不使用 -s 参数 |
No space left on devicerm | 空间不足 | 清理空间 |
Permission denied ... sdcard ... | sdcard 不可用 |
卸载应用
命令:
adb uninstall [-k]
表示应用的包名,
-k
参数可选,表示卸载应用但保留数据和缓存目录。
命令示例:
adb uninstall com.qihoo360.mobilesafe
表示卸载 360 手机卫士。
清除应用数据与缓存
命令:
adb shell pm clear
表示应用名包,这条命令的效果至关于在设置里的应用信息界面点击了「清除缓存」和「清除数据」。
命令示例:
adb shell pm clear com.qihoo360.mobilesafe
表示清除 360 手机卫士的数据和缓存。
查看前台 Activity
命令:
adb shell dumpsys activity activities | grep mFocusedActivity
输出示例:
mFocusedActivity: ActivityRecord{8079d7e u0 com.cyanogenmod.trebuchet/com.android.launcher3.Launcher t42}
其中的 com.cyanogenmod.trebuchet/com.android.launcher3.Launcher
就是当前处于前台的 Activity。
与应用交互
主要是使用 am
命令,经常使用的 以下:
command | 用途 |
---|---|
start [options] |
启动 指定的 Activity |
startservice [options] |
启动 指定的 Service |
broadcast [options] |
发送 指定的广播 |
force-stop |
中止 相关的进程 |
参数很灵活,和写 Android 程序时代码里的 Intent 相对应。
用于决定 intent 对象的选项以下:
参数 | 含义 |
---|---|
-a |
指定 action,好比 android.intent.action.VIEW |
-c |
指定 category,好比 android.intent.category.APP_CONTACTS |
-n |
指定完整 component 名,用于明确指定启动哪一个 Activity,如 com.example.app/.ExampleActivity |
里还能带数据,就像写代码时的 Bundle 同样:
参数 | 含义 |
---|---|
--esn |
null 值(只有 key 名) |
-e|--es |
string 值 |
--ez |
boolean 值 |
--ei |
integer 值 |
--el |
long 值 |
--ef |
float 值 |
--eu |
URI |
--ecn |
component name |
--eia [, |
integer 数组 |
--ela [, |
long 数组 |
调起 Activity
命令格式:
adb shell am start [options]
例如:
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
。
调起 Service
命令格式:
adb shell am startservice [options]
例如:
adb shell am startservice -n com.tencent.mm/.plugin.accountsync.model.AccountAuthenticatorService
表示调起微信的某 Service。
发送广播
命令格式:
adb shell am broadcast [options]
例如:
adb shell am broadcast -a android.intent.action.BOOT_COMPLETED -n org.mazhuang.boottimemeasure/.BootCompletedReceiver
表示向 org.mazhuang.boottimemeasure/.BootCompletedReceiver
发送一个 BOOT_COMPLETED
广播,这类用法在测试的时候很实用,好比某个广播的场景很难制造,能够考虑经过这种方式来发送广播。
强制中止应用
命令:
adb shell am force-stop
命令示例:
adb shell am force-stop com.qihoo360.mobilesafe
表示中止 360 安全卫士的一切进程与服务。
文件管理
复制设备里的文件到电脑
命令:
adb pull <设备里的文件路径> [电脑上的目录]
其中 电脑上的目录
参数能够省略,默认复制到当前目录。
例:
adb pull /sdcard/sr.mp4 ~/tmp/
小技巧:设备上的文件路径可能须要 root 权限才能访问,若是你的设备已经 root 过,能够先使用 adb shell
和 su
命令在 adb shell 里获取 root 权限后,先 cp /path/on/device /sdcard/filename
将文件复制到 sdcard,而后 adb pull /sdcard/filename /path/on/pc
。
复制电脑里的文件到设备
命令:
adb push <电脑上的文件路径> <设备里的目录>
例:
adb push ~/sr.mp4 /sdcard/
小技巧:设备上的文件路径普通权限可能没法直接写入,若是你的设备已经 root 过,能够先 adb push /path/on/pc /sdcard/filename
,而后 adb shell
和 su
在 adb shell 里获取 root 权限后,cp /sdcard/filename /path/on/device
。
模拟按键/输入
在 adb shell
里有个很实用的命令叫 input
,经过它能够作一些有趣的事情。
input
命令的完整 help 信息以下:
Usage: input [] [...] The sources are: mouse keyboard joystick touchnavigation touchpad trackball stylus dpad gesture touchscreen gamepad The commands and default sources are: text (Default: touchscreen) keyevent [--longpress] ... (Default: keyboard) tap (Default: touchscreen) swipe [duration(ms)] (Default: touchscreen) press (Default: trackball) roll (Default: trackball)
好比使用 adb shell input keyevent
命令,不一样的 keycode 能实现不一样的功能,完整的 keycode 列表详见 KeyEvent,摘引部分我以为有意思的以下:
keycode | 含义 |
---|---|
3 | HOME 键 |
4 | 返回键 |
5 | 打开拨号应用 |
6 | 挂断电话 |
24 | 增长音量 |
25 | 下降音量 |
26 | 电源键 |
27 | 拍照(须要在相机应用里) |
64 | 打开浏览器 |
82 | 菜单键 |
85 | 播放/暂停 |
86 | 中止播放 |
87 | 播放下一首 |
88 | 播放上一首 |
122 | 移动光标到行首或列表顶部 |
123 | 移动光标到行末或列表底部 |
126 | 恢复播放 |
127 | 暂停播放 |
164 | 静音 |
176 | 打开系统设置 |
187 | 切换应用 |
207 | 打开联系人 |
208 | 打开日历 |
209 | 打开音乐 |
210 | 打开计算器 |
220 | 下降屏幕亮度 |
221 | 提升屏幕亮度 |
223 | 系统休眠 |
224 | 点亮屏幕 |
231 | 打开语音助手 |
276 | 若是没有 wakelock 则让系统休眠 |
下面是 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
出如今文本框了。
查看日志
Android 系统的日志分为两部分,底层的 Linux 内核日志输出到 /proc/kmsg,Android 的日志输出到 /dev/log。
Android 日志
命令格式:
[adb] logcat [