Android开发者指南(1) —— Android Debug Bridge(adb)(上)

前言

　　本章内容为开发者指南(Dev Guide)/Developing/Tools/adb，这是一篇很是优秀的译稿，翻译来自"移动云_文斌"，欢迎访问它的博客："http://blog.csdn.net/caowenbin"，再次感谢"移动云_文斌" ！期待你一块儿参与翻译Android的相关资料，联系我over140@gmail.com。
 

 

声明

　　欢迎转载，但请保留文章原始出处:)
 

　　　　农民伯伯：http://over140.blog.51cto.com/

　　　　Android中文翻译组：http://goo.gl/6vJQl
 

 

正文

　　Android Debug Bridge

　　Android调试桥接器，简称adb，是用于管理模拟器或真机状态的万能工具，采用了客户端-服务器模型，包括三个部分：

　　* 客户端部分，运行在开发用的电脑上，能够在命令行中运行adb命令来调用该客户端，像ADB插件和DDMS这样的Android工具也能够调用adb客户端。

　　* 服务端部分，是运行在开发用电脑上的后台进程，用于管理客户端与运行在模拟器或真机的守护进程通讯。

　　* 守护进程部分，运行于模拟器或手机的后台。

　　当启动adb客户端时，客户端首先检测adb服务端进程是否运行，若是没有运行，则启动服务端。当服务端启动时，它会绑定到本地的TCP5037端口，而且监遵从adb客户端发来的命令——全部的adb客户端都使用5037端口与adb服务端通讯。

　　接下来服务端与全部正在运行的模拟器或手机链接。它经过扫描5555-5585之间的奇数号端口来搜索模拟器或手机，一旦发现adb守护进程，就经过此端口进行链接。须要说明的是，每个模拟器或手机使用一对有序的端口，偶数号端口用于控制台链接，奇数号端口用于adb链接，例如：

Emulator  1 , console:  5554
Emulator  1 , adb:  5555
Emulator  2 , console:  5556
Emulator  2 , adb:  5557  ...

         即若是模拟器与adb在5555端口链接，则其与控制台的链接就是5554端口。

         当服务端与全部的模拟器创建链接以后，就可使用adb命令来控制或者访问了。由于服务端管理着链接而且能够接收到从多个adb客户端的命令，因此能够从任何一个客户端或脚原本控制任何模拟器或手机设备。

         下文介绍了能够用来管理模拟器或手机的这些adb命令。若是是在Eclipse而且安装了ADT插件的环境下开发Android应用程序，就不须要从命令行使用adb了，ADT插件已经提供了透明的集成。不过，仍是能够在调试等须要的时候直接使用adb。

 

　　使用adb命令

         从开发用电脑的命令行或脚本文件中使用adb命令的用法是：

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

         当使用的时候，程序会调用adb客户端。由于adb客户端不须要关联到任何模拟器，因此若是有多个模拟器或手机正在运行，就须要使用-d参数指定要操做的是哪个，更多关于这些选项参数的使用能够参见Directing Commands to a Specific Emulator/Device Instance。

 

　　查询模拟器或手机状态

         了解adb服务端链接的模拟器或手机能够帮助更好的使用adb命令，这能够经过devices命令列举出来：

 adb devices

         执行结果是adb为每个设备输出如下状态信息：

　 * 序列号(serialNumber) — 由adb建立的使用控制台端口号的用于惟一标识一个模拟器或手机设备的字符串，格式是 <设备类型>-<端口号>，例如： emulator-5554

 * 状态(state) — 链接状态，其值是：

 offline — 未链接或未响应

 device —已经链接到服务商。注意这个状态并不表示Android系统已经彻底启动起来，系统启动的过程当中已经能够链接adb，但这个状态是正常的可操做状态。

每个设备的输出形如：

 [serialNumber] [state]

下面是 devices 命令和其执行结果：

$ adb devices

List of devices attached 

emulator-5554  device

emulator-5556  device

emulator-5558  device

若是没有模拟器或手机在运行，该状态返回的是no device。

 

　　操做指定的模拟器或手机

         若是有多个模拟器或手机正在运行，当使用adb命令的时候就须要指定目标设备，这能够经过使用-s选项参数实现，用法是：

adb -s <serialNumber> <command> 

         便可以在adb命令中使用序列号指定特定的目标，前文已经提到的devices命令能够实现查询设备的序列号信息。

         例如：

adb -s emulator-5556 install helloWorld.apk

　　    须要注意的是，若是使用了-s而没有指定设备的话，adb会报错。

 

　　安装应用程序

　　　　可使用adb从开发用电脑中复制应用程序而且安装到模拟器或手机上，使用install命令便可，在这个命令中，必须指定待安装的.apk文件的路径：

adb install <path_to_apk>

　　　　关于建立可安装的应用的更多信息，请参见Android Asset Packaging Tool (aapt).

　　　　注意，若是使用了安装有ADT插件的Eclipse开发环境，就不须要直接使用adb或aapt命令来安装应用程序了，ADT插件能够自动完成这些操做。

 

　　转发端口

         可使用forward 命令转发端口 — 将特定端口上的请求转发到模拟器或手机的不一样的端口上。下例是从6100端口转到7100端口：

      adb forward tcp:6100 tcp:7100

         也可使用UNIX命名的socket标识：

      adb forward tcp:6100 local:logd 

 

　　与模拟器或手机传输文件

　　　　可使用adb的 pull 和 push 命令从模拟器或手机中复制文件，或者将文件复制到模拟器或手机中。与 install 命令不一样，它仅能复制.apk文件到特定的位置， pull 和 push 命令能够复制任意文件夹和文件到模拟器或手机的任何位置。

从模拟器或手机中复制一个文件或文件夹（递归的）使用：

adb pull <remote> <local>

　　　　复制一个文件或文件夹（递归的）到模拟器或手机中使用：

adb push <local> <remote>

　　　　在这个命令中<local>和<remote>引用的是文件或文件夹的路径，在开发用电脑上的是local，在模拟器或手机上的是remote。

　　　　例如：

adb push foo.txt /sdcard/foo.txt

 

　　adb命令列表

         下表列出了全部adb支持的命令及其说明：

类别	命令	说明	备注
可选项	-d	命令仅对USB设备有效	若是有多个USB设备就会返回错误
	-e	命令仅对运行中的模拟器有效	若是有多个运行中的模拟器就会返回错误
	-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>	安装应用程序（用完整路径指定.apk文件）
	pull <remote> <local>	从开发机COPY指定的文件到模拟器或手机
	push <local> <remote>	从模拟器或手机COPY文件到开发机
端口和网络项	forward <local> <remote>	从本地端口转换链接到模拟器或手机的指定端口	端口可使用如下格式表示： l tcp:<portnum> l local:<UNIX domain socket name> l dev:<character device name> l jdwp:<pid>
	ppp <tty> [parm]...	经过USB运行UPP l <tty> —PPP流中的tty。例如:/dev/omap_csmi_ttyl。 l [parm]... — 0到多个PPP/PPPD 选项, 例如 defaultroute, local, notty等等。 注意不用自动启动PPP链接
脚本项	get-serialno	输出adb对象的序列号	参见 Querying for Emulator/Device Instances以得到更多信息。
	get-state	输出adb设备的状态
	wait-for-device	阻塞执行直到设备已经链接，即设备状态是 device.	能够在其余命令前加上此项，那样的话adb就会等到模拟器或手机设备已经链接才会执行命令，例如:   注意该命令并不等待系统彻底启动，所以不能追加须要在系统彻底启动才能执行的命令，例如install 命令须要Android包管理器支持，但它必须在系统彻底启动后才有效。下面的命令   会在模拟器或手机与adb发生链接后就执行install，但系统尚未彻底启动，因此会引发错误。
服务端项	start-server	检测adb服务进程是否启动，若是没启动则启动它。
	kill-server	终止服务端进程
Shell	shell	在目标模拟器或手机上启动远程SHELL	参见 Issuing Shell Commands以得到更多信息。
	shell [<shellCommand>]	在目标模拟器或手机上执行shellCommand而后退出远程SHELL

 

　　执行Shell命令

         Adb提供了shell来在模拟器或手机上运行各类各样的命令，这些命令的二进制形式存在于这个路径中：

/system/bin/...

         不管是否进入adb远程shell，均可以使用 shell 命令来执。

         在未进入远程shell的状况下能够按下述格式执行单条命令：

adb [-d|-e|-s {<serialNumber>}] shell <shellCommand>

         启动远程shell使用下面的格式：       

adb [-d|-e|-s {<serialNumber>}] shell

　　  退出远程shell时使用CTRL+D 或 exit 终止会话。

　　  如下是可使用的shell命令的更多信息。

 

　　从远程shell检查sqlite3 数据库

         经过远程shell，可使用sqlite3命令行程序来管理由应用程序建立的SQLite数据库。 sqlite3 工具包含不少有用的命令，例如 .dump 用于输出表格的内容，.schema 用于为已经存在的表输出 SQL CREATE 语句。 而且该工具也提供了联机执行SQLite命令的能力。

         使用 sqlite3时，向前文描述的那样进入模拟器的远程shell，而后使用sqlite3 命令。也能够在调用 sqlite3时指定数据库的全路径。SQLite3数据库存储在/data/data/<package_name>/databases/路径下。

         示例:

$ adb -s emulator-5554 shell

# sqlite3 /data/data/com.example.google.rss.rssexample/databases/rssitems.db

SQLite version 3.3.12

Enter ".help" for instructions

.... enter commands, then quit...

sqlite> .exit 

         一旦运行了 sqlite3，就可使用 sqlite3 命令，退出并返回远程shell可使用 exit 或 CTRL+D。