Android ADB使用之详细篇(一)

       Android开发环境中,ADB是我们进行Android开发经常要用的调试工具,它的使用当然是我们Android开发者必须要掌握的。

       ADB概述

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

       1、客户端部分,运行在开发用的电脑上,可以在命令行中运行adb命令来调用该客户端,像ADB插件和DDMS这样的Android工具也可以调用adb客户端。

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

       3、守护进程部分,运行于模拟器或手机的后台。

       当启动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>

       关于创建可安装的应用的更多信息,请参见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