Android ADB使用之详细篇(二)

       执行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。

       使用Monkey进行UI或应用程序测试

       Monkey是运行于模拟器或手机上的一个程序,通过生成伪随机的大量的系统级的用户事件流来模拟操作,包括单击、触摸、手势等。从而为正在开发中的应用程序通过随机响应进行压力测试。

       最简单使用monkey的方式是通过下面的命令行,它可以运行指定的应用程序并向其发送500个伪随机事件。

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

       关于monkey更多的选项及详细信息,请参见UI/Application Exerciser Monkey

       其他Shell命令

       下表列出了很多有效的adb shell命令,完整的列表可以通过启动模拟器并且使用adb –help命令获取。

       adb shell ls /system/bin   

       帮助对于大部分命令是有效的。

Shell 命令

描述

备注

dumpsys

在屏幕上显示系统数据

The 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

        可以在开发机中通过远程shell的方式使用logcat命令查看日志输出:

        $ adb logcat

        如果是在远程shell中可直接使用命令:

        # logcat

        过滤日志输出

        每一条日志消息都有一个标记和优先级与其关联。

        标记是一个简短的字符串,用于标识原始消息的来源 (例如"View" 来源于显示系统)。

        优先级是下面的字符,顺序是从低到高:

         V — 明细 (最低优先级)

         D — 调试

         I — 信息

        W — 警告

         E — 错误

         F — 严重错误

         S — 无记载 (最高优先级,没有什么会被记载)

       通过运行logcat ,可以获得一个系统中使用的标记和优先级的列表,观察列表的前两列,给出的格式是<priority>/<tag>。

       这里是一个日志输出的消息,优先级是“I”,标记是“ActivityManager”:

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

       如果想要减少输出的内容,可以加上过滤器表达式进行限制,过滤器可以限制系统只输出感兴趣的标记-优先级组合。

       过滤器表达式的格式是tag:priority ... ,其中tag是标记, priority是最小的优先级, 该标记标识的所有大于等于指定优先级的消息被写入日志。也可以在一个过滤器表达式中提供多个这样的过滤,它们之间用空格隔开。

       下面给出的例子是仅输出标记为“ActivityManager”并且优先级大于等于“Info”和标记为“MyApp”并且优先级大于等于“Debug”的日志:

       adb logcat ActivityManager:I MyApp:D *:S

       上述表达式最后的 *:S 用于设置所有标记的日志优先级为S,这样可以确保仅有标记为“View”(译者注:应该为ActivityManager,原文可能是笔误)和“MyApp”的日志被输出,使用 *:S 是可以确保输出符合指定的过滤器设置的一种推荐的方式,这样过滤器就成为了日志输出的“白名单”。

       下面的表达是显示所有优先级大于等于“warning”的日志:

       adb logcat *:W

       如果在开发用电脑上运行 logcat  (相对于运行运程shell而言),也可以通过ANDROID_LOG_TAGS环境变量设置默认的过滤器表达式:

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

       需要注意的是,如果是在远程shell或是使用adb shell logcat 命令运行logcat , ANDROID_LOG_TAGS 不会导出到模拟器或手机设备上。

       控制日志格式

       日志消息在标记和优先级之外还有很多元数据字段,这些字段可以通过修改输出格式来控制输出结果,-v 选项加上下面列出的内容可以控制输出字段:

       brief — 显示优先级/标记和原始进程的PID (默认格式)

       process — 仅显示进程PID

       tag — 仅显示优先级/标记

       thread — 仅显示进程:线程和优先级/标记

       raw — 显示原始的日志信息,没有其他的元数据字段

       time — 显示日期,调用时间,优先级/标记,PID

       long —显示所有的元数据字段并且用空行分隔消息内容

       可以使用 -v启动 logcat来控制日志格式:

       [adb] logcat [-v <format>]

       例如使用 thread 输出格式:

       adb logcat -v thread

       注意只能在 -v 选项中指定一种格式。

       Viewing Alternative Log Buffers

       Android日志系统为日志消息保持了多个循环缓冲区,而且不是所有的消息都被发送到默认缓冲区,要想查看这些附加的缓冲区,可以使用-b 选项,以下是可以指定的缓冲区:

       radio — 查看包含在无线/电话相关的缓冲区消息

       events — 查看事件相关的消息

       main — 查看主缓冲区 (默认缓冲区)

       -b 选项的用法:

       [adb] logcat [-b <buffer>]

       例如查看radio缓冲区:

       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命令选项列表

选项

描述

-b <buffer>

加载不同的缓冲区日志,例如 event 或radiomain 缓冲区是默认项,参见Viewing Alternative Log Buffers.

-c

清空(刷新)所有的日志并且退出

-d

在屏幕上输出日志并退出

-f <filename>

将日志输出到文件<filename>,默认输出是stdout.

-g

输出日志的大小

-n <count>

设置最大的循环数据<count>,默认是4,需要-r选项

-r <kbytes>

每<kbytes>循环日志文件,默认是16,需要 -f 选项

-s

设置默认的过滤器为无输出

-v <format>

设置输出格式,默认的是brief,支持的格式列表参见Controlling Log Output Format.

       停止adb服务

       在某些情况下,可能需要终止然后重启服务端进程,例如adb不响应命令的时候,可以通过重启解决问题。

       使用kill-server可以终止服务端,然后使用其他的adb命令重启。