首页 > 代码库 > android的logcat详细用法

android的logcat详细用法

2024-10-25 16:07:02   210人阅读

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

使用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

如果你电脑上运行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 .

摘录自ITEYE：
Android的Logcat用于显示系统的调试信息，可在分别以下几个地方查看和调用logcat： 
1.eclipse的Debug模式或DDMS模式下的会有一个Logcat窗口，用于显示log日志 

只需在eclipse中启动Android模拟器，切换到DDMS或debug模式下，就会有Logcat窗口，窗口右上方有一系列图标，其中V、D、I、W、E五个图标为五个调试信息过滤器： 

V：不过滤输出所有调试信息 包括 VERBOSE、DEBUG、INFO、WARN、ERROR 
D：debug过滤器，输出DEBUG、INFO、WARN、ERROR调试信息 
I：info过滤器，输出INFO、WARN、ERROR调试信息 
W：waring过滤器，输出WARN和ERROR调试信息 
E：error过滤器，只输出ERROR调试信息 

2.Android命令模式下，在启动一个模拟器是可以选择是否需要启动logcat： 

Android Emulator命令的用法: emulator [options] [-qemu args] 
1.Android Emulator命令的用法: emulator [options] [-qemu args] 

启动模拟器命令：emulator -avd <name> -logcat <tags>; 
name：模拟器名字，tags调试信息过滤器类型 
例如：emulator -avd GPhone -logcat w 
启动GPhone模拟器并运行logcat显示调试信息，调试信息的过滤器是w（可替换为v、d、i、e），代表只显示waring和error两类调试信息。 

2.Android adb 命令：adb logcat [ <filter-spec> ] - View device log 
<filter-spec> == <priority>/<tag>,(pritrity标签，tag为过滤类型) 
例如：2.1、adb logcat 显示所有调试信息 
      2.2、adb logcat *:w 显示waring过滤器过滤后的调试信息 
      2.3、adb logcat Test1:V Test2:D 显示标签为Test1的所有调试信息，以及显示标签为Test2Debug过滤器过滤后的调试信息 

3.Android程序中访问调试日志，并显示： 

摘自：http://www.iteye.com/topic/477112 
logcat介绍命令选项。 
-s 默认设置过滤器 
-f      输出到日志文件 
-c 清除日志 
-d 获取日志 
-g 获取日志的大小 
-v      格式设置日志（见下面的格式打印格式） 


-v 格式 例 
brief W/tag ( 876): message 
process W( 876) message (tag) 
tag W/tag : message 
thread W( 876:0x37c) message 
raw message 
time 09-08 05:40:26.729 W/tag ( 876): message 
threadtime 09-08 05:40:26.729 876 892 W tag : message 
long [ 09-08 05:40:26.729 876:0x37c W/tag ] message 


代码例子： 

AndroidManifest.xml添加读取权限 
<uses-permission android:name="android.permission.READ_LOGS" />  

清除日志 
try {   
    Runtime.getRuntime().exec("logcat -c");   
} catch(Exception e) {   

获取日志 
try {   
    ArrayList<String> commandLine = new ArrayList<String>();   
    commandLine.add( "logcat");   
    commandLine.add( "-d");   
    commandLine.add( "-v");   
    commandLine.add( "time");   
    commandLine.add( "-s");   
    commandLine.add( "tag:W");   
    Process process = Runtime.getRuntime().exec( commandLine.toArray( new String[commandLine.size()]));   
    BufferedReader bufferedReader = new BufferedReader( new InputStreamReader(process.getInputStream()), 1024);   
    String line = bufferedReader.readLine();   
    while ( line != null) {   
        log.append(line);   
        log.append("\n")   
    }   
   } catch ( IOException e) {   
}  

结果： 
09-08 09:44:42.267 W/tag     (  754): message1   
09-08 09:44:42.709 W/tag     (  754): message2   
09-08 09:44:43.187 W/tag     (  754): message3   
09-08 09:44:45.295 E/tag     (  754): message8 

android的logcat详细用法


联系
我们