转自:http://www.cnblogs.com/playing/archive/2010/09/19/1830799.html
Android调试桥(adb)是多种用途的工具,该工具可以帮助你你管理设备或模拟器
可以通过下列几种方法加入adb:
- 在设备上运行shell命令
- 通过端口转发来管理模拟器或设备
- 从模拟器或设备上拷贝来或拷贝走文件
下面对adb进行了介绍并描述了常见的使用.
Contents
-
概要
发出adb命令
查询模拟器/设备实例
给特定的模拟器/设备实例发送命令
安装软件
转发端口
从模拟器/设备中拷入或拷出文件
Adb命令列表
启动shell命令
- 通过远程shell端运行sqllite3连接数据库
- UI/软件 试验程序 Monkey
- 其它的shell命令 启用logcat日志
- 使用logcat命令
- 过滤日志输出
- 控制日志输出格式
- 查看可用日志缓冲区
- 查看stdout 和stderr
- Logcat命令列表 停止adb服务
概要
Android 调试系统是一个面对客户服务系统,包括三个组成部分:
- 一个在你用于开发程序的电脑上运行的客户端。你可以通过shell端使用adb命令启动客户端。其他Android工具比如说ADT插件和DDMS同样可以产生adb客户端.
- 在你用于发的机器上作为后台进程运行的服务器。该服务器负责管理客户端与运行于模拟器或设备上的adb守护程序(daemon)之间的通信。.
- 一个以后台进程的形式运行于模拟器或设备上的守护程序(daemon)。.
当你启动一个adb客户端,客户端首先确认是否已有一个adb服务进程在运行。如果没有,则启动服务进程。当服务器运行,adb服务器就会绑定本地的TCP端口5037并监听adb客户端发来的命令,—所有的adb客户端都是用端口5037与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
- 实例的连接状态有三种状态:
offline
—此实例没有与adb相连接或者无法响应. device
—此实例正与adb服务器连接。注意这个状态并不能百分之百地表示在运行和操作Android系统,因此这个实例是当系统正在运行的时候与adb连接的。然而,在系统启动之后,就是一个模拟器/设备状态的正常运行状态了.
每个实例的输出都有如下固定的格式:
[serialNumber] [state]
下面是一个展示devices
$ adb devicesList of devices attached emulator-5554deviceemulator-5556 deviceemulator-5558 device
如果当前没有模拟器/设备运行,adb则返回 nodevice
给特定的模拟器/设备实例发送命令
如果有多个模拟器/设备实例在运行,在发布adb命令时需要指定一个目标实例。这样做,请使用-s
-s
adb -s <serialNumber> <command>
如上所示,给一个命令指定了目标实例,这个目标实例使用由adb分配的序列号。你可以使用 devices
示例如下:
adb -s emulator-5556 install helloWorld.apk
注意这点,如果没有指定一个目标模拟器/设备实例就执行 -s
安装软件
你可以使用adb从你的开发电脑上复制一个应用程序,并且将其安装在一个模拟器/设备实例。像这样做,使用install
install
adb install <path_to_apk>
为了获取更多的关于怎样创建一个可以安装在模拟器/设备实例上的.apk文件的信息,可参照Android AssetPackaging Tool
要注意的是,如果你正在使用EclipseIDE并且已经安装过ADT插件,那么就不需要直接使用adb(或者aapt)去安装模拟器/设备上的应用程序。否则,ADT插件代你全权处理应用程序的打包和安装.
转发端口
可以使用 forward
adb forward tcp:6100 tcp:7100
同样地,可以使用adb来建立命名为抽象的UNIX域套接口,上述过程如下所示:
adb forward tcp:6100 local:logd
从模拟器/设备中拷入或拷出文件
可以使用adbpull
push
install
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 | 通过模拟器/设备的允许的命令号码来发送命令来管理adb (比如: "emulator-5556"). | 如果没有指定号码,则会报错. | |
General | devices | 查看所有连接模拟器/设备的设施的清单. | 查看 |
help | 查看adb所支持的所有命令。. | | |
version | 查看adb的版本序列号. | | |
Debug | logcat | 将日志数据输出到屏幕上. | |
bugreport | 查看bug的报告,如dumpsys dumpstate logcat | | |
jdwp | 查看指定的设施的可用的JDWP信息. | 可以用 forwardjdwp:<pid> adb forward tcp:8000 jdwp:472 jdb -attach localhost:8000 | |
Data | install | 安装Android为(可以模拟器/设施的数据文件.apk指定完整的路径). | |
pull | 将指定的文件从模拟器/设施的拷贝到电脑上. | | |
push | 将指定的文件从电脑上拷贝到模拟器/设备中. | | |
Ports and Networking | forward | 用本地指定的端口通过socket方法远程连接模拟器/设施 | 端口需要描述下列信息:
|
ppp | 通过USB运行ppp:
需要提醒你的不能自动启动PDP连接. | ||
Scripting | get-serialno | 查看adb实例的序列号. | 查看 |
get-state | 查看模拟器/设施的当前状态. | ||
wait-for-device | 如果设备不联机就不让执行,--也就是实例状态是 device | 你可以提前把命令转载在adb的命令器中,在命令器中的命令在模拟器/设备连接之前是不会执行其它命令的. 示例如下: adb wait-for-device shell getprop需要提醒的是这些命令在所有的系统启动启动起来之前是不会启动adb的 所以在所有的系统启动起来之前你也不能执行其它的命令.比如:运用 install adb wait-for-device install <app>.apk上面的命令只有连接上了模拟器/设备连接上了adb服务才会被执行,而在Android系统完全启动前执行就会有错误发生. | |
Server | start-server | 选择服务是否启动adb服务进程. | |
kill-server | 终止adb服务进程. | | |
Shell | shell | 通过远程shell命令来控制模拟器/设备实例. | 查看 |
shell | 连接模拟器/设施执行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端运行sqllite3连接数据库
通过adb远程shell端,你可以通过Android软sqlite3 sqlite3
.dump
.schema
通过sqlite3
sqlite3
sqlite3
/data/data/<package_name>/databases/
示例如下:
$ adb -s emulator-5554 shell# sqlite3 /data/data/com.example.google.rss.rssexample/databases/rssitems.dbSQLite version 3.3.12Enter ".help" for instructions.... enter commands, then quit...sqlite> .exit
当你启动sqlite3的时候,你就可以通过shell端发送 sqlite3
exit
CTRL+D
UI/软件 试验程序 Monkey
当Monkey程序在模拟器或设备运行的时候,如果用户出发了比如点击,触摸,手势或一些系统级别的事件的时候,它就会产生随机脉冲,所以可以用Monkey用随机重复的方法去负荷测试你开发的软件.
最简单的方法就是用用下面的命令来使用Monkey,这个命令将会启动你的软件并且触发500个事件.
$ adb shell monkey -v -p your.package.name 500
更多的关于命令Monkey的命令的信息,可以查看UI/Application ExerciserMonkey
文档页面
其它的shell命令
下面的表格列出了一些adbshell命令,如果需要全部的命令和程序,可以启动模拟器实例并且用adb-help
adb shell ls /system/bin
对大部门命令来说,help都是可用的.
Shell Command | Description | Comments |
---|---|---|
dumpsys | 清除屏幕中的系统数据n. | Dalvik Debug MonitorService |
dumpstate | 清除一个文件的状态. | |
logcat | 启动信息日志并且但因输出到屏幕上. | |
dmesg | 输出主要的调试信息到屏幕上. | |
start | 启动或重启一个模拟器/设备实例. | |
stop | 关闭一个模拟器/设备实例. | |
启用logcat日志
Android日志系统提供了记录和查看系统调试信息的功能。日志都是从各种软件和一些系统的缓冲区中记录下来的,缓冲区可以通过 logcat
使用logcat命令
你可以用 logcat
[adb] logcat [<option>] ... [<filter-spec>] ...
请查看Listing of logcat CommandOptions
你也可以在你的电脑或运行在模拟器/设备上的远程adbshell端来使用logcat
$ adb logcat
你也这样使用:
# logcat
过滤日志输出
每一个输出的Android日志信息都有一个标签和它的优先级.
- 日志的标签是系统部件原始信息的一个简要的标志。(比如:“View”就是查看系统的标签).
- 优先级有下列集中,是按照从低到高顺利排列的:
V
— Verbose (lowestpriority) D
— Debug I
— Info W
— Warning E
— Error F
— Fatal S
— Silent (highest priority, onwhich 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:priority
这些说明都只到空白结束。下面有一个列子,例子表示支持所有的日志信息,除了那些标签为”ActivityManager”和优先级为”Info”以上的和标签为”MyApp”和优先级为” Debug”以上的。 小等级,优先权报告为tag.
adb logcat ActivityManager:I MyApp:D *:S
上面表达式的最后的元素 *:S
*:S
下面的过滤语句指显示优先级为warning或更高的日志信息:
adb logcat *:W
如果你电脑上运行logcat
ANDROID_LOG_TAGS
export ANDROID_LOG_TAGS="ActivityManager:I MyApp:D *:S"
需要注意的是ANDROID_LOG_TAGS
logcat
adbshell logcat
控制日志输出格式
日志信息包括了许多元数据域包括标签和优先级。可以修改日志的输出格式,所以可以显示出特定的元数据域。可以通过 -v
brief
— Display priority/tag andPID of originating process (the default format). process
— Display PID only. tag
— Display the priority/tagonly. thread
— Display process:threadand priority/tag only. raw
— Display the raw logmessage, with no other metadata fields. time
— Display the date,invocation time, priority/tag, and PID of the originatingprocess. long
— Display all metadatafields and separate messages with a blank lines.
当启动了logcat
-v
[adb] logcat [-v <format>]
下面是用 thread
adb logcat -v thread
需要注意的是你只能-v
查看可用日志缓冲区
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
stdout
stderr
通过这种方法指定输出的路径,停止运行的模拟器/设备,然后通过用 setprop
$ adb shell stop$ adb shell setprop log.redirect-stdio true$ adb shell start
系统直到你关闭模拟器/设备前设置会一直保留,可以通过添加/data/local.prop
Logcat命令列表
Option | Description |
---|---|
-b | 加载一个可使用的日志缓冲区供查看,比如event radio main |
-c | 清楚屏幕上的日志. |
-d | 输出日志到屏幕上. |
-f | 指定输出日志信息的<filename> stdout |
-g | 输出指定的日志缓冲区,输出后退出. |
-n | 设置日志的最大数目<count> -r |
-r | 每<kbytes> -f |
-s | 设置默认的过滤级别为silent. |
-v | 设置日志输入格式,默认的是brief |
Stopping the adb Server
在某些情况下,你可能需要终止Android 调试系统的运行,然后再重新启动它。 例如,如果Android调试系统不响应命令,你可以先终止服务器然后再重启,这样就可能解决这个问题.
用kill-server
1. 显示系统中全部Android平台:
2. 显示系统中全部AVD(模拟器):
3. 创建AVD(模拟器):
4. 启动模拟器:
5. 删除AVD(模拟器):
6. 创建SDCard:
7. AVD(模拟器)所在位置:
8. 启动DDMS:
9. 显示当前运行的全部模拟器:
10. 对某一模拟器执行命令:
11. 安装应用程序:
12. 获取模拟器中的文件:
13. 向模拟器中写文件:
14. 进入模拟器的shell模式:
15. 启动SDK,文档,实例下载管理器:
16. 缷载apk包:
17. 查看adb命令帮助信息:
18. 在命令行中查看LOG信息:
19. adb shell后面跟的命令主要来自:
20. 删除系统应用:
21. 获取管理员权限:
22. 启动Activity:
23、发布端口:
adb forward tcp:5555 tcp:8000
24、复制文件:
25、搜索模拟器/设备的实例:
26、查看bug报告:
adb bugreport
27、记录无线通讯日志:
28、获取设备的ID和序列号:
29、访问数据库SQLite3
#cd system/sd/data //进入系统内指定文件夹
#ls //列表显示当前文件夹内容
#rm -r xxx //删除名字为xxx的文件夹及其里面的所有文件
#rm xxx //删除文件xxx
#rmdir xxx //删除xxx的文件夹
试试下面的命令吧。
或简单一些。
其中"breakan.test/breakan.test.TestActivity"中的"breakan.test"是程序的包名,"TestActivity"是程序Activity类的类名(注意看你的xml描述文件)。
我们来看下adb shell am命令的帮助。
start an Activity: am start [ - D][ - W] < INTENT >
- D: enabledebugging
- W:wait for launch to complete
start a Service: am startservice < INTENT >
send a broadcast Intent: am broadcast < INTENT >
start an Instrumentation: am instrument [flags] < COMPONENT >
- r: print rawresults (otherwise decode REPORT_KEY_STREAMRESULT)
- e < NAME > < VALUE > : set argument < NAME > to < VALUE >
- p < FILE > : write profiling data to < FILE >
- w:wait for instrumentation to finish before returning
start profiling: am profile < PROCESS > start < FILE >
stop profiling: am profile < PROCESS > stop
< INTENT > specifications include these flags:
[ - a < ACTION > ] [ - d < DATA_URI > ] [ - t < MIME_TYPE > ]
[ - c < CATEGORY > [ - c < CATEGORY > ] ...]
[ - e |-- es < EXTRA_KEY > < EXTRA_STRING_VALUE > ...]
[ -- esn < EXTRA_KEY > ...]
[ -- ez < EXTRA_KEY > < EXTRA_BOOLEAN_VALUE > ...]
[ - e |-- ei < EXTRA_KEY > < EXTRA_INT_VALUE > ...]
[ - n < COMPONENT > ] [ - f < FLAGS > ]
[ -- grant - read - uri - permission][ -- grant - write - uri - permission]
[ -- debug - log - resolution]
[ -- activity - brought - to - front][ -- activity - clear - top]
[ -- activity - clear - when - task - reset][ -- activity - exclude - from - recents]
[ -- activity - launched - from - history][ -- activity - multiple - task]
[ -- activity - no - animation][ -- activity - no - history]
[ -- activity - no - user - action][ -- activity - previous - is - top]
[ -- activity - reorder - to - front][ -- activity - reset - task - if - needed]
[ -- activity - single - top]
[ -- receiver - registered - only][ -- receiver - replace - pending]
[ < URI > ]