Android logcat 使用方法

Android logcat 使用方法

Android的日志系统

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

1、JAVA应用程序使用日志系统

要使用Android的日志系统来调试JAVA应用程序的话，只需要调用Android提供的android.util.Log类的日志接口就可以实现增加自己开发的应用程序的调试信息，来协助调试程序。常用的调试调用的代码实现如下：

java代码

import android.util.Log ;
Log. e ( "mytag", “Test” ) ;
Log. d ( "mytag1", "Hello word!" ) ;

日志输出优先级由低到高一共有7种，其对应的java的Log接口如下：

• V — Verbose (lowest priority) Log.v()
• D — Debug Log.d()
• I — Info Log.i()
• W — Warning Log.w()
• E — Error Log.e()
• F — Fatal Log.wtf()
• S — Silent (highest priority, on which nothing is ever printed)

日志输出有两种模式，一种是固定Tag输出，一种是自定义Tag输出。

固定Tag输出：

java代码

( new exception ( ) ). printStackTrace ( ) ;

这种固定Tag的日志打印输出是固定System.err，一旦打印的堆栈信息过多，不容易区分，容易混淆。问题定位比较麻烦。所以使用自定义的Tag来输出日志会比较灵活。

自定义Tag的日志打印：

java代码

Log. e ( "mytag", "Test for Log!!!", new exception ( ) ) ;

打印效果如下：

2、lib库或c程序的调试

想要在lib库程序内打印日志信息的话，需要按照以下的步骤来实现：

首先，在程序前加以下代码：

c代码

#define LOG_TAG "my_lib_log" //显示在logcat里的tag
#undef LOG
#include <utils/Log.h>

然后，在需要输出日志信息的地方，加上以下代码进行输出。

c代码

LOGE ( "I am %s, and I am %d years old." , "TopGun"， years ) ; //第一个参数中可以携带各种%s %d等格式化参数 years是年龄int型

最后，在编译lib库或者c程序的Android.mk文件中加入以下语句：

xml代码

LOCAL_SHARED_LIBRARIES:=libutils //大多数Android.mk里已经加了这句

这样就可以在lib库或者c程序里使用Android的日志系统接口来实现日志打印功能了。

3、logcat的详细用法

前面讲了Android的日志系统在JAVA程序以及lib库和C语言程序中的用法。接下来，就要看看怎么来查看这些调试信息了。

3.1 使用logcat命令

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

bash代码

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

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

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

bash代码

$ adb logcat

你也这样使用：

bash代码

# logcat

3.2 过滤日志输出

每一个输出的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:

bash代码

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

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

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

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

bash代码

adb logcat ActivityManager:I MyApp:D *:S

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

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

bash代码

adb logcat *:W

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

bash代码

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

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

3.3 控制日志输出格式

日志信息包括了许多元数据域包括标签和优先级。可以修改日志的输出格式，所以可以显示出特定的元数据域。可以通过 -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 选项来指定输出格式:

bash代码

[adb ] logcat [-v <format > ]

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

bash代码

adb logcat -v thread

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

3.4 查看可用日志缓冲区

Android日志系统有循环缓冲区，并不是所有的日志系统都有默认循环缓冲区。为了得到日志信息，你需要通过-b 选项来启动logcat 。如果要使用循环缓冲区，你需要查看剩余的循环缓冲期:

• radio — 查看缓冲区的相关的信息.
• events — 查看和事件相关的的缓冲区.
• main — 查看主要的日志缓冲区

-b 选项使用方法:

bash代码

[adb ] logcat [-b <buffer > ]

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

bash代码

adb logcat -b radio

3.5 查看stdout 和stderr

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

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

bash代码

$ adb shell stop
$ adb shell setprop log.redirect-stdio true
$ adb shell start

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

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

3.7 Eclipse下logcat的使用

Eclipse下运行好模拟器后，可以通过点击DDMS->Device内选定模拟器->点击logcat就能看到日志信息。如下图：

注意必须要选定模拟器，否则有时候Eclipse下的logcat里会不打印任何信息。

大家注意下logcat里面还提供了过滤器编辑的功能以及日志类型选择过滤的功能，挺好用的功能。

要添加日志过滤器的话，点击Saved Filters的右侧的“+”按钮，就会出现过滤器设置界面，如下图：

然后点击OK进行保存，保存后会出现保存好的过滤器列表。如下图：

点击刚添加的“TestFilter”过滤器，右侧信息就会自动过滤只显示MediaScanner相关的调试信息了。很方便吧。

想删除过滤器的话，直接选中左侧窗口内直接选中要删除的过滤器，然后点“-”图标就可以轻松删除。真的很方便。

以上是对Android的日志系统的一个小小的总结，希望对大家以后调试Android程序，以及Android下的开发能有点帮助。