Android开发环境搭建之Android adb

接着服务器将全部运行中的模拟器或设备实例创建链接。它经过扫描全部5555到5585范围内的奇数端口来定位全部的模拟器或设备。一旦服务器找到了adb守护程序，它将创建一个到该端口的链接。请注意任何模拟器或设备实例会取得两个连续的端口——一个偶数端口用来相应控制台的链接，和一个奇数端口用来响应adb链接。好比说:

模拟器1，控制台：端口5554
模拟器1，Adb端口5555
控制台：端口 5556
Adb端口5557...

如上所示，模拟器实例经过5555端口链接adb，就如同使用5554端口链接控制台同样.

一旦服务器与全部模拟器实例创建链接，就可使用adb命令控制和访问该实例。由于服务器管理模拟器/设备实例的链接，和控制处理历来自多个adb客户端来的命令，你能够经过任何客户端(或脚本)来控制任何模拟器或设备实例.

如下的部分描述经过命令使用adb和管理模拟器/设备的状态。要注意的是若是你用，装有ADT插件的Eclipse开发Android程序，你就不须要经过命令行使用adb。ADT插件已经透明的把adb集成到Eclipse中了，固然，若是必要的话你也能够仍然直接使用adb，好比说调试.

发出adb命令

发出Android命令：你能够在你的开发机上的命令行或脚本上发布Android命令，使用方法:

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

当你发出一个命令，系统启用Android客户端。客户端并不与模拟器实例相关，因此若是双服务器/设备是运行中的，你须要用 -d 选项去为应被控制的命令肯定目标实例。关于使用这个选项的更多信息，能够查看模拟器/设备实例术语控制命令 .

查询模拟器/设备实例

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

adb devices

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

· • 序列号——由adb建立的一个字符串，这个字符串经过本身的控制端口<type>-<consolePort> 惟一地识别一个模拟器/设备实例。下面是一个序列号的例子： emulator-5554

· 实例的链接状态有三种状态:

o offline — 此实例没有与adb相链接或者没法响应.

o 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

注意这点，若是没有指定一个目标模拟器/设备实例就执行 -s 这个命令的话，adb会产生一个错误.

安装软件

你可使用adb从你的开发电脑上复制一个应用程序，而且将其安装在一个模拟器/设备实例。像这样作，使用install 命令。这个install 命令要求你必须指定你所要安装的.apk文件的路径:

adb install <path_to_apk>

为了获取更多的关于怎样建立一个能够安装在模拟器/设备实例上的.apk文件的信息，可参照 Android Asset Packaging Tool (aapt).

要注意的是，若是你正在使用Eclipse IDE而且已经安装过ADT插件，那么就不须要直接使用adb（或者aapt）去安装模拟器/设备上的应用程序。不然，ADT插件代你全权处理应用程序的打包和安装.

转发端口

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

adb forward tcp:6100 tcp:7100

一样地，可使用adb来创建命名为抽象的UNIX域套接口，上述过程以下所示:

adb forward tcp:6100 local:logd

从模拟器/设备中拷入或拷出文件

可使用adbpull ,push 命令将文件复制到一个模拟器/设备实例的数据文件或是从数据文件中复制。install 命令只将一个.apk文件复制到一个特定的位置，与其不一样的是，pull 和 push 命令可令你复制任意的目录和文件到一个模拟器/设备实例的任何位置。

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

adb pull <remote> <local>

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

adb push <local> <remote>

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

下面是一个例子：:

adb push foo.txt /sdcard/foo.txt

Adb命令列表

下列表格列出了adb支持的全部命令,并对它们的意义和使用方法作了说明.

Category	Command	Description	Comments
Options	-d	仅仅经过USB接口来管理abd.	若是不仅是用USB接口来管理则返回错误.
-e	仅仅经过模拟器实例来管理adb.	若是不是仅仅经过模拟器实例管理则返回错误.
-s <serialNumber>	经过模拟器/设备的容许的命令号码来发送命令来管理adb (好比: "emulator-5556").	若是没有指定号码，则会报错.
General	devices	查看全部链接模拟器/设备的设施的清单.	查看 Querying for Emulator/Device Instances 获取更多相关信息.
help	查看adb所支持的全部命令。.
version	查看adb的版本序列号.
Debug	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
Data	install <path-to-apk>	安装Android为（能够模拟器/设施的数据文件.apk指定完整的路径）.
pull <remote> <local>	将指定的文件从模拟器/设施的拷贝到电脑上.
push <local> <remote>	将指定的文件从电脑上拷贝到模拟器/设备中.
Ports and Networking	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链接.
Scripting	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系统彻底启动前执行就会有错误发生.
Server	start-server	选择服务是否启动adb服务进程.
kill-server	终止adb服务进程.
Shell	shell	经过远程shell命令来控制模拟器/设备实例.	查看获取更多信息 for more information.
shell [<shellCommand>]	链接模拟器/设施执行shell命令，执行完毕后退出远程shell端l.

启动shell命令

Adb 提供了shell端，经过shell端你能够在模拟器或设备上运行各类命令。这些命令以2进制的形式保存在本地的模拟器或设备的文件系统中:

/system/bin/...

无论你是否彻底进入到模拟器/设备的adb远程shell端，你都能 shell 命令来执行命令.

当没有彻底进入到远程shell的时候，这样使用shell 命令来执行一条命令:

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

在模拟器/设备中不用远程shell端时，这样使用shell 命 :

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

经过操做CTRL+D 或exit 就能够退出shell远程链接.

下面一些就将告诉你更多的关于shell命令的知识.

经过远程shell端运行sqllite3链接数据库

经过adb远程shell端，你能够经过Android软 sqlite3 命令程序来管理数据库。sqlite3 工具包含了许多使用命令，好比：.dump 显示表的内容，.schema 能够显示出已经存在的表空间的SQL CREATE结果集。Sqlite3还容许你远程执行sql命令.

经过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的时候，你就能够经过shell端发送 sqlite3 ,命令了。用exit 或 CTRL+D 退出adb远程shell端.

UI/软件试验程序 Monkey

当Monkey程序在模拟器或设备运行的时候，若是用户出发了好比点击，触摸，手势或一些系统级别的事件的时候，它就会产生随机脉冲，因此能够用Monkey用随机重复的方法去负荷测试你开发的软件.

最简单的方法就是用用下面的命令来使用Monkey，这个命令将会启动你的软件而且触发500个事件.

$ adb shell monkey -v -p your.package.name 500

更多的关于命令Monkey的命令的信息，能够查看 UI/Application Exerciser Monkey documentation page.

文档页面

其它的shell命令

下面的表格列出了一些adbshell命令，若是须要所有的命令和程序，能够启动模拟器实例而且用adb -help 命令 .

adb shell ls /system/bin

对大部门命令来讲，help都是可用的.

Shell Command	Description	Comments
dumpsys	清除屏幕中的系统数据n.	Dalvik Debug Monitor Service (DDMS)工具提供了完整的调试、.
dumpstate	清除一个文件的状态.
logcat [<option>]... [<filter-spec>]...	启动信息日志而且但因输出到屏幕上.
dmesg	输出主要的调试信息到屏幕上.
start	启动或重启一个模拟器/设备实例.
stop	关闭一个模拟器/设备实例.

启用logcat日志

Android日志系统提供了记录和查看系统调试信息的功能。日志都是从各类软件和一些系统的缓冲区中记录下来的，缓冲区能够经过 logcat 命令来查看和使用.

使用logcat命令

你能够用 logcat 命令来查看系统日志缓冲区的内容:

[adb] logcat [<option>] ... [<filter-spec>] ...

请查看 Listing of logcat Command Options ，它对logcat命令有详细的描述 .

你也能够在你的电脑或运行在模拟器/设备上的远程adb shell端来使用logcat 命令，也能够在你的电脑上查看日志输出。

$ adb logcat

你也这样使用：

# logcat

过滤日志输出

每个输出的Android日志信息都有一个标签和它的优先级.

· 日志的标签是系统部件原始信息的一个简要的标志。（好比：“View”就是查看系统的标签）.

· 优先级有下列集中，是按照从低到高顺利排列的:

o V — Verbose (lowest priority)

o D — Debug

o I — Info

o W — Warning

o E — Error

o F — Fatal

o S — Silent (highest priority, on which nothing is ever printed)

在运行logcat的时候在前两列的信息中你就能够看到 logcat 的标签列表和优先级别,它是这样标出的:<priority>/<tag> .

下面是一个logcat输出的例子,它的优先级就彷佛I,标签就是ActivityManage:

I/ActivityManager( 585): Starting activity: Intent { action=android.intent.action...}

为了让日志输出能体现管理的级别,你还能够用过滤器来控制日志输出,过滤器能够帮助你描述系统的标签等级.

过滤器语句按照下面的格式描tag:priority ... , tag 表示是标签, priority 是表示标签的报告的最低等级. 从上面的tag的中能够获得日志的优先级. 你能够在过滤器中屡次写tag:priority .

这些说明都只到空白结束。下面有一个列子，例子表示支持全部的日志信息，除了那些标签为”ActivityManager”和优先级为”Info”以上的和标签为” MyApp”和优先级为” Debug”以上的。小等级,优先权报告为tag.

adb logcat ActivityManager:I MyApp:D *:S

上面表达式的最后的元素 *:S ,，是设置全部的标签为"silent"，全部日志只显示有"View" and "MyApp"的，用 *:S 的另外一个用处是可以确保日志输出的时候是按照过滤器的说明限制的，也让过滤器也做为一项输出到日志中.

下面的过滤语句指显示优先级为warning或更高的日志信息:

adb logcat *:W

若是你电脑上运行logcat ，相比在远程adbshell端，你还能够为环境变量ANDROID_LOG_TAGS :输入一个参数来设置默认的过滤

export ANDROID_LOG_TAGS="ActivityManager:I MyApp:D *:S"

须要注意的是ANDROID_LOG_TAGS 过滤器若是经过远程shell运行logcat 或用adb shell logcat 来运行模拟器/设备不能输出日志.

控制日志输出格式

日志信息包括了许多元数据域包括标签和优先级。能够修改日志的输出格式，因此能够显示出特定的元数据域。能够经过 -v 选项获得格式化输出日志的相关信息.

· brief — Display priority/tag and PID of originating process (the default format).

· process — Display PID only.

· tag — Display the priority/tag only.

· thread — Display process:thread and priority/tag only.

· raw — Display the raw log message, with no other metadata fields.

· time — Display the date, invocation time, priority/tag, and PID of the originating process.

· long — Display all metadata fields and separate messages with a blank lines.

当启动了logcat ，你能够经过-v 选项来指定输出格式:

[adb] logcat [-v <format>]

下面是用 thread 来产生的日志格式:

adb logcat -v thread

须要注意的是你只能-v 选项来规定输出格式 option.

查看可用日志缓冲区

Android日志系统有循环缓冲区，并非全部的日志系统都有默认循环缓冲区。为了获得日志信息，你须要经过-b 选项来启动logcat 。若是要使用循环缓冲区，你须要查看剩余的循环缓冲期:

· radio — 查看缓冲区的相关的信息.

· events — 查看和事件相关的的缓冲区.

· main — 查看主要的日志缓冲区

-b 选项使用方法:

[adb] logcat [-b <buffer>]

下面的例子表示怎么查看日志缓冲区包含radio 和 telephony信息:

adb logcat -b radio

查看stdout 和stderr

在默认状态下，Android系统有stdout 和 stderr (System.out 和System.err )输出到/dev/null ，在运行Dalvik VM的进程中，有一个系统能够备份日志文件。在这种状况下，系统会用stdout 和stderr 和优先级 I.来记录日志信息

经过这种方法指定输出的路径，中止运行的模拟器/设备，而后经过用 setprop 命令远程输入日志

$ adb shell stop

$ adb shell setprop log.redirect-stdio true

$ adb shell start

系统直到你关闭模拟器/设备前设置会一直保留，能够经过添加/data/local.prop 可使用模拟器/设备上的默认设置

Logcat命令列表

Option	Description
-b <buffer>	加载一个可以使用的日志缓冲区供查看，好比event 和radio . 默认值是main 。具体查看 Viewing Alternative Log Buffers.
-c	清楚屏幕上的日志.
-d	输出日志到屏幕上.
-f <filename>	指定输出日志信息的<filename> ，默认是stdout .
-g	输出指定的日志缓冲区，输出后退出.
-n <count>	设置日志的最大数目<count> .，默认值是4，须要和 -r 选项一块儿使用。
-r <kbytes>	每<kbytes> 时输出日志，默认值为16，须要和-f 选项一块儿使用.
-s	设置默认的过滤级别为silent.
-v <format>	设置日志输入格式，默认的是brief 格式，要知道更多的支持的格式，参看 Controlling Log Output Format .

Stopping the adb Server

在某些状况下，你可能须要终止Android 调试系统的运行,而后再从新启动它。例如,若是Android 调试系统不响应命令，你能够先终止服务器而后再重启，这样就可能解决这个问题.

用kill-server 能够终止adb server。你能够用adb发出的任何命令来从新启动服务器.