您的位置:首页 > 移动开发 > Android开发

【Android】ADB常用指令与logcat日志

2014-03-20 15:23 288 查看

【Android】ADB常用指令与logcat日志

http://***/html/itweb/20131015/168574.htm

ADB命令简介

  ADB是一个功能强大的命令行工具。通过它可以直接和模拟器或真机进行交互。它是一个具有客户端和服务器端的程序。

  它主要由三个部分组成:

客户端,它运行在你的开发机上,你可以通过执行adb命令来唤起一个客户端。其他的工具例如:ADT插件以及DDMS也可以创建一个ADB客户端。
服务端,它运行在你的后台进程,这个服务管理客户端和运行在你模拟起或真机上的守护进程。
守护进程,它运行在每台模拟器或真机的后台进程。

  当你启动一个adb客户端的时候,客户端会首先检测是否已经有adb服务进程运行,如果没有运行,那么它会首先启动一个服务进程,当服务进程启动后,服务进程绑定本地的5037端口,并且监听所有来自adb 客户端的命令,所有的adb客户端通过5037与adb 服务端进行交互。

  服务端运行之后与所有运行的模拟器或真机建立链接,它通过一组范围从5555 到5585的奇数的端口检索到所有的模拟器或真机。每一台模拟器或真机需要获取一对连续的端口,偶数端口用于控制台的链接,奇数端口用于adb的链接。

  当然,如果你用Eclipse开发,并且也安装了ADT插件,那么你没必要通过adb命令行与模拟器或真机交互,ADT插件已经完美的将adb整合进了Eclipse IDE.当然还是提倡多使用adb命令行,这样的话比较方便自定义debug方法,同时也可以更好的理解其工作原理。

Adb命令列表

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

CategoryCommandDescriptionComments
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.
  adb命令参数详解

int INSTALL_FAILED_ALREADY_EXISTS                       //程序已经存在
int INSTALL_FAILED_CONFLICTING_PROVIDER            //存在同名的内容提供者
int INSTALL_FAILED_DEXOPT                //dex优化验证失败
int INSTALL_FAILED_DUPLICATE_PACKAGE            //已存在同名程序
int INSTALL_FAILED_INSUFFICIENT_STORAGE            //没有足够的存储空间
int INSTALL_FAILED_INVALID_APK                //无效的APK
int INSTALL_FAILED_INVALID_URI                //无效的链接
int INSTALL_FAILED_MISSING_SHARED_LIBRARY        //需求的共享库已丢失
int INSTALL_FAILED_NO_SHARED_USER            //要求的共享用户不存在
int INSTALL_FAILED_OLDER_SDK                //系统版本过旧
int INSTALL_FAILED_REPLACE_COULDNT_DELETE
int INSTALL_FAILED_SHARED_USER_INCOMPATIBLE        //需求的共享用户签名错误
int INSTALL_FAILED_UPDATE_INCOMPATIBLE            //版本不能共存
int INSTALL_PARSE_FAILED_BAD_MANIFEST            //错误的MANIFEST配置文件
int INSTALL_PARSE_FAILED_BAD_PACKAGE_NAME        //错误的包名
int INSTALL_PARSE_FAILED_BAD_SHARED_USER_ID        //错误的共享用户
int INSTALL_PARSE_FAILED_CERTIFICATE_ENCODING        //证书编码无效
int INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES    //证书不一致
int INSTALL_PARSE_FAILED_MANIFEST_EMPTY            //MANIFEST配置文件为空
int INSTALL_PARSE_FAILED_MANIFEST_MALFORMED        //MANIFEST配置文件非法
int INSTALL_PARSE_FAILED_NOT_APK            //不是有效的APK文件
int INSTALL_PARSE_FAILED_NO_CERTIFICATES        //无认证证书
int INSTALL_PARSE_FAILED_UNEXPECTED_EXCEPTION        //异常
int INSTALL_SUCCEEDED                    //安装成功
int REPLACE_EXISTING_PACKAGE                //包名已存在


View Code

启用logcat日志

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

Logcat命令列表

OptionDescription
-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 .

使用logcat命令

  你可以用
logcat
命令来查看系统日志缓冲区的内容

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


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

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

$ adb logcat  //logcat


过滤日志输出

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



日志的标签是系统部件原始信息的一个简要的标志。(比如:“View”就是查看系统的标签).
优先级有下列集中,是按照从低到高顺利排列的:

V
— Verbose (lowest priority)
D
— Debug
I
— Info
W
— Warning
E
— Error
F
— Fatal
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


控制日志输出格式

  日志信息包括了许多元数据域包括标签和优先级。

  修改日志的输出格式,可以显示出特定的元数据域。可以通过
-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


不完全汇总


(1) 显示全部日志信息:adb logcat

(2) 显示某一TAG的日志信息:adb logcat -s TAG名称

(3) 显示某一TAG的某一级别的日志信息:adb logcat TAG名称:级别.....TAG名称:级别 *:S

  注:日志级别(V-verbose,D-debug,I-info,W-warning,E-error,F-fatal,S-silent),*:S(确保日志输出的时候是按照过滤器的说明限制)

(4) 显示某一级别以上的全部日志信息:adb logcat *:级别

(5) 以某种格式显示日志信息:adb logcat -v 格式

  注:日志格式(brief,process,tag,thread,raw,time,long)

(6) 显示缓冲区中的日志信息:adb logcat -b 缓冲区类型

  注:缓冲区类型(radio-无线缓冲区,events-事件缓冲区,main-主缓冲区,默认)

(7) 清理已经存在的日志:adb logcat -c

(8) 将日志显示在控制台后退出:adb logcat -d

(9) 将日志输出到文件:adb logcat -f 文件名


参考文章

  http://www.cnblogs.com/playing/archive/2010/09/19/1830799.html

  http://www.cnblogs.com/ithouge/archive/2012/12/09/ithouge_android_adb.html
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: