前言

  本章内容为开发者指南(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 ...

即如果模拟器与adb5555端口连接,则其与控制台的连接就是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开发环境,就不需要直接使用adbaapt命令来安装应用程序了,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>

从本地端口转换连接到模拟器或手机的指定端口

端口可以使用以下格式表示:

ltcp:<portnum>

llocal:<UNIX domain socket name>

ldev:<character device name>

ljdwp:<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

更多相关文章

  1. Android系列教程(3):Android(安卓)SDK中常用命令行工具
  2. 如何在Android中启动JAVA程序
  3. Android命令大全
  4. android中adb命令大全
  5. Android的UI结构试图工具hierarchyviewer
  6. android adb shell 命令大全
  7. Android(安卓)adb shell 命令大全
  8. Android(安卓)adb shell 命令大全
  9. android adb shell 命令大全

随机推荐

  1. android获取组件尺寸
  2. android aidl-cpp方式接口调用出现问题
  3. Android极光推送通过不同的通知内容跳入
  4. android Toast只显示一次
  5. android中数据存储的ContentProvider的使
  6. Android(安卓)-- AndroidX库
  7. Android(安卓)文件IO操作
  8. android fragment生命周期
  9. build.gradle配置变量,在Activity中使用
  10. android 反射解析xml文件成为java对象