Android 调试桥

概述

Android调试桥(adb)是个很强大的工具，该工具可以管理设备或模拟器的状态。

当启动一个adb客户端时，客户端首先确认是否已有一个adb服务进程在运行。如果没有，则启动服务进程。服务器运行时，adb服务器会绑定本地的TCP端口5037并监听adb客户端发来的命令，所有的adb客户端都是用端口5037与adb服务器对话的。

接着服务器将与所有运行中的模拟器或设备实例建立连接。并通过扫描所有5555到5585范围内的奇数端口来定位所有的模拟器或设备。一旦服务器找到了 adb守护程序，它将建立一个到该端口的连接。任何模拟器或设备实例会取得两个连续的端口，一个偶数端口用来和相应控制台连接，一个奇数端口用来响应 adb连接。

比如说:

模拟器1：控制台端口5554

模拟器1：Adb端口5555

模拟器2：控制台端口 5556

模拟器2：Adb端口5557

……

如上所示，模拟器实例通过5555端口连接adb，就如同使用5554端口连接控制台一样。

一旦服务器与模拟器实例建立连接，就可以使用adb命令控制和访问该实例。因为服务器管理模拟器/设备实例的连接，并可以控制处理来自多个adb客户端来的命令，所以可以通过任何客户端(或脚本)来控制任何模拟器或设备实例。

要注意的是如果用装有ADT插件的Eclipse开发Android程序，就不需要通过命令行使用adb。ADT插件已经透明的把adb集成到Eclipse中了，当然，如果必要的话你也可以仍然直接使用adb，比如说调试。

ADB系统的组成

Android调试系统是一个面对客户服务系统，包括三个组成部分:

ADB-server

运行在PC端，是一个始终在后台运行的进程，作为与手机端交互的唯一接口。ADB-server处理ADB-client的请求，一部分请求无须与设备交 互，直接在PC本地完成;剩下的请求需要与设备端的adbd交互，ADB-server起到了一个switcher的作用。

ADB-client

运行在PC端，可以同时存在多个。每个ADB-client由用户启动，完成多种功能。其作用是与ADB-server交互，实现用户请求的功能。

adbd

运行在设备端的常驻进程，同时只存在一个。作用是接收PC端的ADB-server发来的请求，并作出对应操作。

以上三个可执行程序都是同一套代码编译出来的，位于<Android Source Dir>/system/core/adb/

ADB-client和ADB-server对应同一个可执行文件“adb(.exe)”，编译时有-DADB_HOST=1宏。而adbd对应目标设备上的可执行文件”adbd”，编译时的参数是-DADB_HOST=0。

ADB主要功能

Adb主要可以实现以下功能:

• 在设备上运行shell命令
• 通过端口转发来管理模拟器或设备
• 在模拟器或设备上拷出或拷入文件

ADB命令详述

命令行格式

可以在开发机上的命令行或脚本上发布ADB命令，使用方法:

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

发出一个命令后，系统会启动ADB客户端。客户端并不与模拟器实例相关，所以如果双服务器/设备是运行中的，需要用-d选项去为应被控制的命令确定目标实例。关于使用这个选项的更多信息，可以查看模拟器/设备实例术语控制命令。

查询模拟器/设备实例

在发送adb命令之前，有必要知道什么样的模拟器/设备实例与adb服务器是相连的。可以通过使用devices命令来得到一系列相关联的模拟器/设备:

adb devices

作为回应，adb为每个实例都制定了相应的状态信息:

• 序列号：由adb创建的一个字符串，这个字符串通过自己的控制端口<type>-<consolePort> 唯一地识别一个模拟器/设备实例。下面是一个序列号的例子：emulator-5554
• 实例的连接状态有三种状态:
  • offline 此实例没有与adb相连接或者无法响应.
  • device 此实例正与adb服务器连接。注意这个状态并不能百分之百地表示在运行和操作Android系统，因此这个实例是当系统正在运行的时候与adb连接的。然而，在系统启动之后，就是一个模拟器/设备状态的正常运行状态了.

每个实例的输出都有如下固定的格式:

[serialNumber] [state]

下面是一个展示devices 命令和输出的例子 :

$ adb devices

List of devices attached 

emulator-5554  device

emulator-5556  device

emulator-5558  device

如果当前没有模拟器/设备运行，adb则返回 no device。

给特定的模拟器/设备实例发送命令

如果有多个模拟器/设备实例在运行，在发布adb命令时需要指定一个目标实例。这样做，需使用-s 选项的命令。在使用的-s 选项是

adb -s <serialNumber> <command> 

如上所示，给一个命令指定了目标实例，这个目标实例使用由adb分配的序列号。你可以使用devices命令来获得运行着的模拟器/设备实例的序列号。

示例如下:

adb -s emulator-5556 install helloWorld.apk

利用ADB安装软件

可以adb的install命令从开发电脑上复制一个应用程序，并且将其安装在一个模拟器/设备实例上。这个install命令要求指定所要安装的.apk文件的路径，命令格式如下:

adb install <path_to_apk>

如果使用Eclipse IDE并且已经安装过ADT插件，那么不需要直接使用adb（或者aapt）来安装模拟器/设备的应用程序，ADT插件将会全权处理应用程序的打包和安装。

在模拟器/设备上拷入或拷出文件

可以使用 adb pull 命令从一个模拟器/设备实例中拷出文件；使用 adb push 命令将文件复制到一个模拟器/设备实例中。install 命令是将一个.apk文件复制到一个特定的位置，而pull和push命令可以复制任意的目录和文件到一个模拟器/设备实例的任何位置。

从模拟器或者设备中复制文件或目录，使用(如下命):

adb pull <remote> <local>

将文件或目录复制到模拟器或者设备，使用（如下命令）

adb push <local> <remote>

在这些命令中，<local>和<remote>分别自己的开发机（本地）和模拟器/设备实例（远程）上的目标文件/目录的路径。

下面是一个例子：:

adb push foo.txt /sdcard/foo.txt

利用ADB重启设备

可以使用reboot重启设备：

adb reboot [bootloader|recovery] 

利用ADB转发端口

可以使用forward命令进行任意端口的转发。即通过模拟器/设备实例的某一特定主机端口向另一不同端口的转发请求。下面演示了如何建立从主机端口6100到模拟器/设备端口7100的转发。

adb forward tcp:6100 tcp:7100

同样地，也可以使用adb来建立命名为抽象的UNIX域套接口，如:

adb forward tcp:6100 local:logd 有待验证

转发过程说明

PC			Device
[ADB-client]↔[Port A:]				[:Port A']↔[Program A]
[ADB-client]↔[Port B:]		ADB-server↔adbd		[:Port B']↔[Program B]
[ADB-client]↔[Port C:]				[:Port C']↔(empty)
← Android Debug Bridge →

ADB提供了PC与设备交互的桥梁，结构上清晰明了。其中adb forward功能提供了端口映射，希望给用户提供透明的socket通信。但可惜，这与真实的网络socket有点区别。

在TCP网络编程中，Client的Socket如果调用Connect()成功，就说明已经和Server端的Socket连接上，可以通讯了。但是如果使用adb forward做端口映射就有些不同了。

这里端口映射的实质，是让ADB-server作为一个switcher转发ADB-client的数据包，送给adbd，adbd再发给设备端的对应端 口。因此一旦建立了映射，就相当于ADB-server开始监听这个目标端口。而此时如果有客户端去尝试Connect这个端口，是一定会成功的，因为与 客户端连接的是ADB-server，而非真正的设备上的目标程序。这就出现了即使Connect()成功，却完全无法知道究竟是否成功连接到设备上的服 务程序的情况。

因此，判断真正连接成功的方法，只有收发握手数据包。程序中约定好事先做个交互：客户端发送一个数据包，等待设备上的服务程序回复。客户端如果收到了回复 包，说明连通，如果接收超时，则认为没有连通。在没有连通的情况下，需要重新建立Socket，并Connect()，然后再尝试握手。

ADB命令列表

分类	命令	描述	说明
选项	-d	仅仅通过USB接口来管理abd。	如果不只是用USB接口来管理则返回错误。
	-e	仅仅通过模拟器实例来管理adb。	如果不是仅仅通过模拟器实例管理则返回错误。
	-s <serialNumber>	通过模拟器/设备的标识号码来发送命令来管理adb (比如: “emulator-5556”)。	如果没有指定号码，则会报错
通用	devices	查看所有连接模拟器/设备的清单。	查看Querying for Emulator/Device Instances 获取更多相关信息。
	help	查看adb所支持的所有命令。
	version	查看adb的版本序列号。
调试	logcat [<option>] [<filter-specs>]	将日志数据输出到屏幕上。
	bugreport	查看bug的报告，如dumpsys,dumpstate,和logcat信息。
	jdwp	查看指定的设备可用的JDWP信息。	可以用forward jdwp:<pid> 端口映射信息来连接指定的JDWP进程.例如： adb forward tcp:8000 jdwp:472 jdb -attach localhost:8000
数据	install <path-to-apk>	安装Android应用
	pull <remote> <local>	将指定的文件从模拟器/设备的拷贝到电脑上
	push <local> <remote>	将指定的文件从电脑上拷贝到模拟器/设备中
网络	forward <local> <remote>	用本地指定的端口通过socket方法远程连接模拟器/设备 端口	需要描述下列信息: * tcp:<portnum> * local:<UNIX domain socket name> * dev:<character device name> * jdwp:<pid>
	ppp <tty> [parm]…	通过USB运行ppp	* <tty> — the tty for PPP stream. For example dev:/dev/omap_csmi_ttyl * [parm]… &mdash zero or more PPP/PPPD options, such as defaultroute , local , notty , etc. 注:不能自动启动PDP连接.
脚本	get-serialno	查看adb实例的序列号。	查看Querying for Emulator/Device Instances可以获得更多信息
	get-state	查看模拟器/设备的当前状态。
	wait-for-device	如果设备不联机就不让执行,也就是实例状态是device时，可以提前把命令转载在adb的命令器中,命令器中的命令在模拟器/设备连接之前不会执行其它命令。	示例如下: adb wait-for-device shell getprop 注:这些命令在所有的系统启动起来之前不会启动adb,所以在所有的系统启动起来之前也不能执行其它的命令。比如：运用install的时候就需要Android包，这些包需要系统完全启动。例如： adb wait-for-device install <app>.apk 上面的命令只有模拟器/设备连接上了adb服务才会被执行，而在Android系统完全启动前执行就会有错误发生。
服务器	start-server	启动adb服务进程
	kill-server	终止adb服务进程
Shell	shell	通过远程shell命令来控制模拟器/设备实例
	shell [<shellCommand>]	连接模拟器/设施执行shell命令，执行完毕后退出远程shell。