Android(安卓)Debug Bridge 服务详解

本文尝试列举客户端能够发送给ADB服务器的所有请求。关于adb客户端、adb服务器、adbd守护进程、adb服务的概念，以及这些组件如何相互配合完成ADB工作的细节，请参考之前发的文章《Android Debug Bridge 技术实现》。

==============================
主机服务
==============================

host:version
请求ADB服务器的内部版本号。作为一个特殊的例外，服务器将用4字节的十六进制字符串回应，返回服务器内部版本号，回应中没有“OKAY”和“FAIL”。

host:kill
请求ADB服务器立即退出。用于ADB客户端检测到在升级之后有废弃的ADB服务器仍在运行的情况。

host:devices
请求返回可用的Android设备及其状态的列表。在“OKAY”之后是4个字节的长度定义，然后是指定长度的表明当前设备状况的字符串，返回之后连接关闭。

host:track-devices
“host:devices”的一个变种，它不关闭连接；相反，每次添加或移除设备或者指定设备的状态发生变化，一个新的设备列表描述被发送。这就使得像DDMS这样的工具能够实时跟踪连接设备的状态，而不用重复轮训服务器。

host:emulator:<port>
这是一个特殊的请求，当启动一个新的模拟器时，该请求被发送到ADB服务器。<port>是一个十进制数字代表模拟器的ADB协议端口号，比如：模拟器将自动转发到adbd守护进程的TCP端口号。这个机制使得ADB服务器能够知道新的模拟器实例启动。

host:transport:<serial-number>
请求切换连接到<serial-number>指示的设备或模拟器。接到“OKAY”回应之后，所有的客户端请求将被直接发送给运行在指定设备上的adbd守护进程。（用来实现-s）

host:transport-usb
请求切换连接到通过USB连接到主机的设备上。如果存在多个这样的设备，请求将失败。（用来实现-d）

host:transport-local
请求切换连接到通过TCP连接的模拟器。如果有多个这样的模拟器实例在运行，请求将失败。（用来实现-e）

host:transport-any
另一个“host:transport”变种。请求切换连接到已连接的设备或正在运行的模拟器。如果可用的设备或模拟器多于一个，请求将失败。（用在-s、-d、-e都不被提供时）

host-serial:<serial-number>:<request>
这是一个特殊形式的请求，前缀“host-serial:<serial-number>:”表明客户端正在请求ADB服务器获得指定设备的信息。<request>可以是下述格式的一种。

host-usb:<request>
host-serial的一个变种，用于将连接到主机的唯一USB设备作为目标。如果没有这样的设备或有多个这样的设备，请求将失败。

host-local:<request>
host-serial的一个变种，用于将运行在主机上唯一的模拟器实例作为目标。如果没有这样的模拟器或有多个这样的模拟器，请求将失败。

host:<request>
当请求设备相关的信息时，“host:”也能被解释为“任何连接到主机的唯一设备或运行在主机上的唯一模拟器”。

<host-prefix>:get-product
暂无解释。

<host-prefix>:get-serialno
返回对应设备或模拟器的序列号。注意模拟器序列号是“emulator-5544”的形式。

<host-prefix>:get-state
返回指定设备的状态字符串。

<host-prefix>:forward:<local>;<remote>
请求ADB服务器将本地连接从<local>转移到指定设备上的<remote>地址。
这里的<host-prefix>可以是上面描述的host-serial、host-usb、host-local、host的任意一个，它表明目标是哪个设备或模拟器。
<local>的格式有以下几种：
tcp:<port> -> 在localhost:<port>上的TCP连接
local:<path> -> 在<path>上的Unix本地域套接字（Unix domain socket）
<remote>的格式有以下几种：
tcp:<port> -> 在设备上localhost:<port>的TCP连接
local:<path> -> 在设备上的Unix本地域套接字
jdwp:<pid> -> 在虚拟机进程<pid>中的JDWP线程
或者下面所描述的本地服务的任何一种。

==============================
本地服务
==============================

下面所有的请求都假设你已经切换传输到实际的设备，或者你使用上面所描述的请求前缀。

shell:command arg1 arg2 ...
在设备的shell中运行“command arg1 arg2 ...”，返回输出流及错误流。注意命令参数必须用空格分隔。如果一个参数包含空格，应该对它使用双引号。参数不能包含双引号和其他会导致错误的符号。
这是“adb shell”的非交互版本。

shell:
在设备上启动一个交互的shell会话。恰当的重定向标准输入、标准输出和标准错误输出。ADB服务器使用这个服务来实现“adb shell”，但是在输入被发送到设备之前，ADB服务器也会对输入做加工。（参考commandline.c中的interactive_shell()函数）

remount:
请求adbd守护进程重新挂载设备的文件系统到读/写模式下，而不是只读模式。在执行“adb sync”或者“adb push”之前，通常都需要这个服务。
在不允许该操作的特定的系统中，这个请求可能不成功。

dev:<path>
打开一个设备文件，直接将客户端连接到这个文件去执行读写。该服务对于调试除错很有用，但是需要特殊的权限，不能在所有的设备上运行。<path>是从文件系统根目录开始的全路径。

tcp:<port>
尝试连接到loclhost的tcp端口<port>上。

tcp:<port>:<server-name>
尝试从设备连接到<server-name>所指定机器的tcp端口<port>上。这个服务对调试只能在设备上显示的网络或代理问题很有用。

local:<path>
尝试连接到设备上的Unix域套接字<path>。

localreserved:<path>
localabstract:<path>
localfilesystem:<path>
几个local:<path>的变种，用来访问其他Android套接字命名空间。

log:<name>
打开一个系统日志（/dev/log/<name>），允许客户端直接读取。用来实现“adb logcat”。数据流对客户端是只读的。

framebuffer:
这个服务用来向客户端发送framebuffer的快照。它需要足够的权限，工作原理如下：
在“OKAY”之后，服务发送包含下列字段的16字节的二进制结构（低位优先格式）：
depth: uint32_t: framebuffer深度
size: uint32_t: framebuffer大小（单位：字节）
width: uint32_t: framebuffer宽度（单位：像素）
height:uint32_t: framebuffer高度（单位：像素）
在当前的实现中，framebuffer深度总是16，大小总是：宽度*高度*2。
每当客户端想要一个快照时，它应该通过通道发送一个字节，触发服务将framebuffer数据按framebuffer大小指定的字节数发送给它。
如果adbd守护进程没有足够的权限打开framebuffer设备，那么连接会立即关闭。

dns:<server-name>
这个服务是个例外，因为它仅仅运行在ADB服务器中。它被用来实现USB联网，比如：通过主机为设备提供一个网络连接。
它用来在主机上执行gethostbyname(<address>)，IP地址以4个字节的字符串返回。

recover:<size>
这个服务上传一个recovery影像到设备中。<size>必须与recovery影像文件大小一样。工作原理如下：
- 创建一个命名为/tmp/update的文件；
- 从客户端读取<size>大小的字节数，将它们写入到/tmp/update；
- 当影像文件成功读取之后，创建一个命名为/tmp/update.start的文件。
只有当设备处于recovery模式时，这个服务才能工作。此外，如果/tmp目录不存在，连接会立即关闭。

jdwp:<pid>
连接到运行在虚拟机进程<pid>中的JDWP线程。

track-jdwp
用于周期性的向客户端发送JDWP pids列表。返回数据格式如下：
<hex4>: 4个字符的十六进制字符串指定所有内容的长度
<content>: 一连串的格式为<pid> "/n"的ASCII行
DDMS使用这个服务知道设备或模拟器上正在运行哪些可以调试的进程。
注意没有仅获取一次列表的单步服务。

sync:
这个请求启动文件系统同步服务，用来实现“adb push”和“adb pull”。因为这个服务相当复杂，需要专门的文章来解释说明，如果有朋友感兴趣，我们以后专门讨论。

更多相关文章

随机推荐