Android 官方命令深入分析之Android Debug Bridge(adb)
作者:宋志辉
Android Debug Brideg(adb)是一个多用途的命令行工具。可以与Android虚拟机进行通信或连接真机。它同样提供了访问设备shell的高级命令行操作的权限。它是一个包含以下三部分的客户端-服务端程序:
- 一个客户端,运行在你的开发设备上。你可以通过adb命令来从shell中调用一个客户端。或者通过ADT插件和DDMS创建adb客户端。
- 一个服务端,作为一个后台进程运行在你的开发设备中。服务端负责客户端和虚拟机或设备中adb守护进程的通信。
- 一个守护进程,运行在虚拟机和设备中的一个后台进程。
你可以在/platform-tools/中找到adb工具。
当你启动一个adb客户端时,客户端首先检查这里是否已经有一个服务端进程在运行。如果没有,则启动服务端进程。当服务端进程运行后,与本地的TCP的5037端口,并且监听发自客户端的命令-所有的adb 客户端都通过5037端口与adb 服务端进行通信。
接下来服务端建立起与所有运行的虚拟机和设备的连接。它通过扫描5555到5585端口的奇数端口来确定运行的虚拟机或设备的实例。当服务端发现一个adb守护进程,就通过这个端口建立连接。需要注意的是,每个虚拟机或设备都需要两个端口:一个偶数端口用来进行控制台连接,一个奇数端口用来adb 连接。
比如:
宋志辉的虚拟机,控制台端口:5554
宋志辉的虚拟机,adb端口:5555
如上所示,虚拟机实例连接到5555端口,控制台监听5554端口。
一旦服务器建立起所有虚拟机的连接,你可以使用adb命令来访问这些设备。因为服务端管理与设备或虚拟机的连接并且处理来自adb客户端的命令。你可以使用任何的客户端来控制任意的虚拟机或设备。
允许adb 调试
为了使adb可以通过USB连接设备,必须在系统设置中找到 开发者选项 开启USB调试。
在Android 4.2及以上版本中,开发者选项默认是隐藏的。要显示出来,点击“设置”“关于”“构建版本”7次。返回之前的屏幕可以找到“开发者选项”。
在有些设备中,开发者选项 可能显示出来或者名称不同。
注意:当你连接一个高于Android4.2.2版本的设备到计算机时,手机会弹窗提示是否同意一个RSA密钥来运行这台计算机进行调试。这个安全机制用来保护用户的设备,因为除非你解锁设备,否则其他的adb命令无法运行。这需要adb版本大于等于1.0.31(SDK大于等于16.0.1)。
语法
你可以在你的电脑上通过命令行来运行adb命令。用法如下:
adb [-d|-e|-s <设备号>] <命令>
如果这里只有一个虚拟机或设备运行,adb默认发送到这台设备或虚拟机。如果有多个虚拟机或设备存在,你需要使用-d, -e, 或 -s选项指明运行命令的设备。
命令
下面的表格列出了所有的支持的adb命令并解释了含义和用途。
分类 | 命令 | 描述 |
---|---|---|
目标设备 | -d | 传递一个adb命令到仅有的usb设备上 |
-e | 传递一个adb命令到仅有的虚拟机上 | |
-s | 传递一个adb命令到指定的设备上 | |
通用 | devices | 列出当前运行的虚拟机或设备列表 |
help | 列出adb命令的帮助列表 | |
version | 输出adb的版本 | |
调试 | logcat [option] [filter-specs] | 打印log数据到屏幕上 |
bugreport | 输出dumpsys, dumpstate和logcat数据到屏幕上 | |
jdwp | 列出指定的设备的可用的JDWP进程 | |
数据 | install | 安装Android应用到虚拟机或设备中 |
pull | 从虚拟机或设备中复制文件到电脑上 | |
push | 从电脑上复制文件到虚拟机或设备中 | |
端口和网络 | forward | sockets连接用到的命令 |
ppp | 通过USB运行PPP | |
脚本 | get-serialno | 获取adb实例的序列号字符串 |
get-state | 获取虚拟机或设备的adb状态 | |
wait-for-device | 阻断执行直到设备在线 | |
服务端 | start-server | 检测adb服务端是否运行,如果不,则运行 |
stop-server | 终止adb服务端进程 | |
shell | shell | 在指定设备或虚拟机中启动远程的shell |
查询虚拟机或设备实例
在使用adb命令之前,了解当前运行了多少虚拟机或设备是很有必要的。可以通过指定的命令生成一个当前运行的列表:
adb devices
作为回应adb输出所有设备的状态信息:
- 序列号。由adb创建的用于唯一标示虚拟机或设备的字符串。
- 状态。实例运行的状态(offline,device,no device)。
输出的格式如下:
[序列号] [状态]
下面是devices命令的一个例子:
adb devices
List of devices attached
emulator-5554 device
emulator-5556 device
emulator-5558 device
指定特定的虚拟机或设备
如果是多个设备或虚拟机在运行,你需要指定运行adb命令的实例。可以使用命令中的-s来实现:
adb -s <序列号> <命令>
可以通过devices命令获取序列号。
adb -s emulator-5556 install helloWorld.apk
需要注意的是,当多个设备运行时,你没有通过-s指定设备,运行adb命令会报错。
如果有一个或多个设备,但只有一个虚拟机,可以使用-e命令在虚拟机运行;如果有一个或多个虚拟机,但只有设备,可以使用-d在设备运行。
安装一个应用
你可以使用adb命令从开发计算机中复制一个应用到虚拟机或设备中。可以使用install命令:
adb install <apk路径>
当然,安装apk到设备中不一定要使用命令行。
复制文件
你可以使用pull和push来复制虚拟机或设备中的文件。
停止adb服务端
在有些时候,我们需要停止adb服务端,重新启动来解决问题。
停止adb服务端,可以使用kill-server命令,之后就可以重启adb服务端运行任何命令了。
无线连接
通常adb命令通过usb连接设备来使用,当然也可以通过wifi来实现。
- 开发计算机和设备(通常是手机)连接了同一个网络(同一个wifi或在同一个局域网中)。(并不是所有的热点都支持,防火墙需要支持adb)。
- 使用usb线连接计算机。
- 确保计算机的adb命令运行在usb模式中。
$ adb usb
restarting in USB mode 通过usb连接设备。
$ adb devices
List of devices attached
######## device重启adb到tcipip模式。
$ adb tcpip 5555
restarting in TCP mode port: 5555找到android设备的ip地址。
- 通过ip地址连接到设备。
$ adb connect #.#.#.#
connected to #.#.#.#:5555 - 移除设备的usb线,确认你还可以对设备进行访问。
$ adb devices
List of devices attached
#.#.#.#:5555 device
如果adb连接丢失后:
- 确保你的计算机和手机接入同一个wifi。
- 通过adb connect重新连接。
- 如果没用的话,重启服务端进程。
adb kill-server
然后重新开始以上步骤。