Awesome Adb——一份超全超详细的 ADB 用法大全

基本用法

命令语法

adb 命令的基本语法如下:





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

为命令指定目标设备

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

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





输出里的 cf264b8f 和 emulator-5554 即为 serialNumber。比如这时想指定 cf264b8f 这个设备来运行 adb 命令获取屏幕分辨率:





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

启动/停止

启动 adb server 命令:





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

停止 adb server 命令:





查看 adb 版本

命令:





示例输出:





以 root 权限运行 adbd

adb 的运行原理是 PC 端的 adb server 与手机端的守护进程 adbd 建立连接,然后 PC 端的 adb client 通过 adb server 转发命令,adbd 接收命令后解析运行。

所以如果 adbd 以普通权限执行,有些需要 root 权限才能执行的命令无法直接用 adb xxx 执行。这时可以 adb shell 然后 su 后执行命令,也可以让 adbd 以 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 的网络端口

命令:





默认端口为 5037。

设备连接管理

查询已连接设备/模拟器

命令:





输出示例:





输出格式为 [serialNumber] [state],serialNumber 即我们常说的 SN,state 有如下几种:

  • offline —— 表示设备未连接成功或无响应。
  • device —— 设备已连接。注意这个状态并不能标识 Android 系统已经完全启动和可操作,在设备启动过程中设备实例就可连接到 adb,但启动完毕后系统才处于可操作状态。
  • no device —— 没有设备/模拟器连接。

以上输出显示当前已经连接了两台设备/模拟器,cf264b8f 与 emulator-5554 分别是它们的 SN。从 emulator-5554 这个名字可以看出它是一个 Android 模拟器。

常见异常输出:

  1. 没有设备/模拟器连接成功。
  2. 设备/模拟器未连接到 adb 或无响应。

USB 连接

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

  1. 硬件状态正常。包括 Android 设备处于正常开机状态,USB 连接线和各种接口完好。
  2. Android 设备的开发者选项和 USB 调试模式已开启。可以到「设置」-「开发者选项」-「Android 调试」查看。如果在设置里找不到开发者选项,那需要通过一个彩蛋来让它显示出来:在「设置」-「关于手机」连续点击「版本号」7 次。
  3. 设备驱动状态正常。这一点貌似在 Linux 和 Mac OS X 下不用操心,在 Windows 下有可能遇到需要安装驱动的情况,确认这一点可以右键「计算机」-「属性」,到「设备管理器」里查看相关设备上是否有黄色感叹号或问号,如果没有就说明驱动状态已经好了。否则可以下载一个手机助手类程序来安装驱动先。
  4. 通过 USB 线连接好电脑和设备后确认状态。如果能看到说明连接成功。

无线连接

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

操作步骤:

  1. 将 Android 设备与将运行 adb 的电脑连接到同一个局域网,比如连到同一个 WiFi。
  2. 将设备与电脑通过 USB 线连接。应确保连接成功(可运行 adb devices 看是否能列出该设备)。
  3. 让设备在 5555 端口监听 TCP/IP 连接:
  4. 断开 USB 连接。
  5. 找到设备的 IP 地址。一般能在「设置」-「关于手机」-「状态信息」-「IP地址」找到。
  6. 通过 IP 地址连接设备。这里的 就是上一步中找到的设备 IP 地址。
  7. 确认连接状态。如果能看到说明连接成功。

如果连接不了,请确认 Android 设备与电脑是连接到了同一个 WiFi,然后再次执行 adb connect 那一步;

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

断开无线连接

命令:





应用管理

查看应用列表

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





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

所有应用

命令:





输出示例:





系统应用

命令:





第三方应用

命令:





包名包含某字符串的应用

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





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





安装 APK

命令:

参数:

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

完整参数列表及含义可以直接运行 adb 命令然后查看 adb install [-lrtsdg] 一节。

如果见到类似如下输出(状态为 Success)代表安装成功:





而如果状态为 Failure 则表示安装失败。常见安装失败输出代码、含义及可能的解决办法如下:

参考:PackageManager.java

卸载应用

命令:





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

命令示例:





表示卸载 360 手机卫士。

清除应用数据与缓存

命令:





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

命令示例:





表示清除 360 手机卫士的数据和缓存。

查看前台 Activity

命令:





输出示例:





其中的 com.cyanogenmod.trebuchet/com.android.launcher3.Launcher 就是当前处于前台的 Activity。

与应用交互

主要是使用 am 命令,常用的 如下:

 参数很灵活,和写 Android 程序时代码里的 Intent 相对应。

用于决定 intent 对象的选项如下:

 里还能带数据,就像写代码时的 Bundle 一样:

调起 Activity

命令格式:





例如:





表示调起微信主界面。





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

调起 Service

命令格式:





例如:





表示调起微信的某 Service。

发送广播

命令格式:





例如:





表示向 org.mazhuang.boottimemeasure/.BootCompletedReceiver 发送一个 BOOT_COMPLETED广播,这类用法在测试的时候很实用,比如某个广播的场景很难制造,可以考虑通过这种方式来发送广播。

强制停止应用

命令:





命令示例:





表示停止 360 安全卫士的一切进程与服务。

文件管理

复制设备里的文件到电脑

命令:





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

例:





小技巧:设备上的文件路径可能需要 root 权限才能访问,如果你的设备已经 root 过,可以先使用 adb shell 和 su 命令在 adb shell 里获取 root 权限后,先 cp /path/on/device /sdcard/filename 将文件复制到 sdcard,然后 adb pull /sdcard/filename /path/on/pc

复制电脑里的文件到设备

命令:





例:





小技巧:设备上的文件路径普通权限可能无法直接写入,如果你的设备已经 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 信息如下:

比如使用 adb shell input keyevent 命令,不同的 keycode 能实现不同的功能,完整的 keycode 列表详见 KeyEvent,摘引部分我觉得有意思的如下:

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

电源键

命令:





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

菜单键

命令:





HOME 键

命令:





返回键

命令:





音量控制

增加音量:





降低音量:





静音:





媒体控制

播放/暂停:





停止播放:





播放下一首:





播放上一首:





恢复播放:





暂停播放:





点亮/熄灭屏幕

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

点亮屏幕:





熄灭屏幕:





滑动解锁

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

命令(参数以机型 Nexus 5,向上滑动手势解锁举例):





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

输入文本

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

命令:





现在 hello 出现在文本框了。

查看日志

Android 系统的日志分为两部分,底层的 Linux 内核日志输出到 /proc/kmsg,Android 的日志输出到 /dev/log。

Android 日志

命令格式:





常用用法列举如下:

按级别过滤日志

Android 的日志分为如下几个级别:

  • V —— Verbose(最低,输出得最多)
  • D —— Debug
  • I —— Info
  • W —— Warning
  • E —— Error
  • F —— Fatal
  • S —— Silent(最高,啥也不输出)

按某级别过滤日志则会将该级别及以上的日志输出。

比如,命令:





会将 Warning、Error、Fatal 和 Silent 日志输出。

按 tag 和级别过滤日志

比如,命令:





表示输出 tag ActivityManager 的 Info 以上级别日志,输出 tag MyApp 的 Debug 以上级别日志,及其它 tag 的 Silent 级别日志(即屏蔽其它 tag 日志)。

日志格式

可以用 adb logcat -v 选项指定日志输出格式。

日志支持按以下几种 :

  • brief默认格式。格式为:示例:
  • process格式为:示例:
  • tag格式为:示例:
  • raw格式为:示例:
  • time格式为:示例:
  • threadtime格式为:示例:
  • long格式为:示例:

指定格式可与上面的过滤同时使用。比如:





清空日志





内核日志

命令:





输出示例:





中括号里的 [14201.684016] 代表内核开始启动后的时间,单位为秒。

通过内核日志我们可以做一些事情,比如衡量内核启动时间,在系统启动完毕后的内核日志里找到 Freeing init memory 那一行前面的时间就是。

查看设备信息

型号

命令:





输出示例:





电池状况

命令:





输入示例:





其中 scale 代表最大电量,level 代表当前电量。上面的输出表示还剩下 44% 的电量。

屏幕分辨率

命令:





输出示例:





该设备屏幕分辨率为 1080px * 1920px。

屏幕密度

命令:





输出示例:





该设备屏幕密度为 420dpi。

显示屏参数

命令:





输出示例:





其中 mDisplayId 为 显示屏编号,init 是初始分辨率和屏幕密度,app 的高度比 init 里的要小,表示屏幕底部有虚拟按键,高度为 1920 – 1794 = 126px 合 42dp。

android_id

命令:





输出示例:





IMEI

在 Android 4.4 及以下版本可通过如下命令获取 IMEI:





输出示例:





其中的 Device ID 就是 IMEI。

而在 Android 5.0 及以上版本里这个命令输出为空,得通过其它方式获取了(需要 root 权限):





输出示例:





把里面的有效内容提取出来就是 IMEI 了,比如这里的是 860955027785041

参考:adb shell dumpsys iphonesubinfo not working since Android 5.0 Lollipop

Android 系统版本

命令:





输出示例:





Mac 地址

命令:





输出示例:





CPU 信息

命令:





输出示例:





这是 Nexus 5 的 CPU 信息,我们从输出里可以看到使用的硬件是 Qualcomm MSM 8974,processor 的编号是 0 到 3,所以它是四核的,采用的架构是 ARMv7 Processor rev 0 (v71)

更多硬件与系统属性

设备的更多硬件与系统属性可以通过如下命令查看:





这会输出很多信息,包括前面几个小节提到的「型号」和「Android 系统版本」等。

输出里还包括一些其它有用的信息,它们也可通过 adb shell getprop <属性名> 命令单独查看,列举一部分属性如下:

实用功能

屏幕截图

命令:





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





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

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

录制屏幕

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





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

如果需要导出到电脑:





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

重新挂载 system 分区为可写

注:需要 root 权限。

/system 分区默认挂载为只读,但有些操作比如给 Android 系统添加命令、删除自带应用等需要对 /system 进行写操作,所以需要重新挂载它为可读写。

步骤:

  1. 进入 shell 并切换到 root 用户权限。命令:
  2. 查看当前分区挂载情况。命令:输出示例:找到其中我们关注的带 /system 的那一行:
  3. 重新挂载。命令:这里的 /dev/block/platform/msm_sdcc.1/by-name/system 就是我们从上一步的输出里得到的文件路径。

如果输出没有提示错误的话,操作就成功了,可以对 /system 下的文件为所欲为了。

查看连接过的 WiFi 密码

注:需要 root 权限。

命令:





输出示例:





ssid 即为我们在 WLAN 设置里看到的名称,psk 为密码,key_mgmt 为安全加密方式。

设置系统日期和时间

注:需要 root 权限。

命令:





表示将系统日期和时间更改为 2016 年 08 月 23 日 13 点 15 分 00 秒。

重启手机

命令:





检测设备是否已 root

命令:





此时命令行提示符是 $ 则表示没有 root 权限,是 # 则表示已 root。

使用 Monkey 进行压力测试

Monkey 可以生成伪随机用户事件来模拟单击、触摸、手势等操作,可以对正在开发中的程序进行随机压力测试。

简单用法:





表示向 指定的应用程序发送 500 个伪随机事件。

Monkey 的详细用法参考 官方文档

刷机相关命令

重启到 Recovery 模式

命令:





从 Recovery 重启到 Android

命令:





重启到 Fastboot 模式

命令:





通过 sideload 更新系统

如果我们下载了 Android 设备对应的系统更新包到电脑上,那么也可以通过 adb 来完成更新。

以 Recovery 模式下更新为例:

  1. 重启到 Recovery 模式。命令:
  2. 在设备的 Recovery 界面上操作进入 Apply updateApply from ADB。注:不同的 Recovery 菜单可能与此有差异,有的是一级菜单就有 Apply update from ADB
  3. 通过 adb 上传和更新系统。命令:

更多 adb shell 命令

Android 系统是基于 Linux 内核的,所以 Linux 里的很多命令在 Android 里也有相同或类似的实现,在 adb shell 里可以调用。本文档前面的部分内容已经用到了 adb shell 命令。

查看进程

命令:





输出示例:





各列含义:

查看实时资源占用情况

命令:





输出示例:





各列含义:

top 命令还支持一些命令行参数,详细用法如下:





其它

如下是其它常用命令的简单描述,前文已经专门讲过的命令不再额外说明:

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *