Android开发环境中,ADB是我们进行Android开发经常要用的调试工具,它的使用当然是我们Android开发者必须要掌握的。
ADB概述
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参数指定要操作的是哪一个。
查询模拟器或手机状态
了解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>
注意,如果使用了安装有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
执行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。
使用Monkey进行UI或应用程序测试
Monkey是运行于模拟器或手机上的一个程序,通过生成伪随机的大量的系统级的用户事件流来模拟操作,包括单击、触摸、手势等。从而为正在开发中的应用程序通过随机响应进行压力测试。
最简单使用monkey的方式是通过下面的命令行,它可以运行指定的应用程序并向其发送500个伪随机事件。
$ adb shell monkey -v -p your.package.name 500
其他Shell命令
下表列出了很多有效的adb shell命令,完整的列表可以通过启动模拟器并且使用adb –help命令获取。
adb shell ls /system/bin
帮助对于大部分命令是有效的。
Shell 命令 |
描述 |
备注 |
dumpsys |
在屏幕上显示系统数据 |
The Dalvik Debug Monitor Service (DDMS) 工具提供了更易于使用的智能的调试环境。 |
dumpstate |
将状态输出到文件 |
|
logcat [<option>]... [<filter-spec>]... |
输出日志信息 | |
dmesg |
在屏幕上输出核心调试信息 |
|
start |
启动或重新启动模拟器或手机 |
|
stop |
停止模拟器或手机 |
停止adb服务
在某些情况下,可能需要终止然后重启服务端进程,例如adb不响应命令的时候,可以通过重启解决问题。
使用adb kill-server可以终止服务端,然后使用adb start-server命令重启。