Logcat 的使用方法详解

做android有些日子了，不过对基本的logcat的详细用法还是很模糊，今天有空，学习一下。

logcat可以在adb中使用，也可以直接在命令行下使用。
 
logcat [options] [filterspecs] 
logcat的选项包括: 
  -s                      默认设置过滤器，如指定'*:s'. 
  -f <filename>    输出到文件，默认情况是标准输出.
  -r [<kbytes>]    循环log的字节数(默认为16)，需要-f.
  -n <count>       设置循环log的最大数目，默认是4
  -v <format>      设置log的打印格式,  <format> 是下面的一种: 
                            brief process tag thread raw time threadtime long.
  -c                      清除所有log并退出.
  -d                     得到所有log并退出 (不阻塞).
  -g                     得到环形缓冲区的大小并退出. 
  -b <buffer>      请求不同的环形缓冲区('main' (默认), 'radio', 'events').
  -B                     输出log到二进制中.

 

1.  日志过滤器设置
  每一个输出的Android日志信息都有一个标签和它的优先级.
  日志的标签是系统部件原始信息的一个简要的标志。（比如：“View”就是查看系统log的标签，“RFID_HAL”就是查看RFID的HAL层log的标签）。
  优先级有下列集中，是按照从低到高顺利排列的:
  V — Verbose (lowest priority)
  D — Debug
  I — Info
  W — Warning
  E — Error
  F — Fatal
  S — Silent (highest priority, on which nothing is ever printed)无log打印

  在运行logcat的时候在前两列的信息中你就可以看到 logcat 的标签列表和优先级别,它是这样标出的:<priority>/<tag>.
  下面是一个logcat输出的例子,它的优先级就似乎I,标签就是ActivityManage:
  I/ActivityManager(  585): Starting activity: Intent { action=android.intent.action...}
  
  过滤器语句按照下面的格式描述：tag:priority, tag 表示是标签,priority是表示标签log的最低等级， 
  你可以在过滤器中多次写tag:priority。
  
  例如：adb logcat ActivityManager:I MyApp:D *:S  或者 adb logcat -s ActivityManager:I MyApp:D
  上面表达式的最后的元素 *:S ,，是设置所有的标签为”silent”，所有日志只显示有”ActivityManager”和“MyApp”的，用 *:S 的另一个用处是能够确保日志输出的时候是按照过滤器的说明限制的，也让过滤器也作为一项输出写到日志中。
  
2.  log输出格式设置
  可以修改日志的输出格式，所以可以显示出特定的元数据域。可以通过 -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.
  例子：
  brief -- P/tag (876): message  (默认格式)
  process -- (876): message
  tag -- P/tag: message
  thread -- P/tag( 876:0x37c) message
  raw -- message
  time -- 09-08 05:40:26.729 P/tag ( 876): message
  threadtime -- 09-08 05:40:26.729 876 892 P/tag : message
  long -- [ 09-08 05:40:26.729 876:0x37c P/tag ] message

 

3.  查看可用日志缓冲区
  Android日志系统有循环缓冲区，并不是所有的日志系统都有默认循环缓冲区。
  [adb] logcat [-b <buffer>]
  radio —  查看和radio telephony相关的缓冲区
  events —  查看和事件相关的的缓冲区
  main —   查看主要的日志缓冲区
  
4. log源码头文件
 4.1 java
   事实上LogCat的功能是由Android的类android.util.Log决定的，在程序中log的使用方法如下所示： 
   Log.v() －－－－－－－－－－－－－－－－－－－－ VERBOSE 
   Log.d() －－－－－－－－－－－－－－－－－－－－ DEBUG 
   Log.i() －－－－－－－－－－－－－－－－－－－－ INFO 
   Log.w() －－－－－－－－－－－－－－－－－－－－ WARN 
   Log.e() －－－－－－－－－－－－－－－－－－－－ ERROR 
   以上log的级别依次升高，Debug信息应当只存在于开发中，INFO、 WARN、ERROR这3种log将出现在发布版本中。

   对于Java类，可以声明一个字符串常量TAG，LogCat可以根据它来区分不同的log.
   例如，在计算器（Calculator）的类中，定义如下所示： 
   public class Calculator extends Activity { 
   /* ...... */ 
       private static final String LOG_TAG = "Calculator"; 
       private static final boolean DEBUG  = false; 
       private static final boolean LOG_ENABLED = DEBUG ? Config.LOGD : Config.LOGV; 
   /* ...... */ 
     由此，所有在Calculator中使用的log，均以“Calculator”为开头。
   
  4.2 FW and HAL
     JNI层代码需包含头文件frameworks/base/include/utils/Log.h，实际上这个头文件include了HAL层代码使用的头文件system/core/include/cutils/log.h
     //#define  NDEBUG
     //#define  LOG_NDEBUG  0
     #define  LOG_TAG  "RFID_HAL"
   #include <cutils/log.h>
   
   这里对能够输出Verbose级别的log的设置，逻辑上有点反，实际上在log.h文件开始就有如下定义：
   #ifndef LOG_NDEBUG
   #ifdef NDEBUG
   #define LOG_NDEBUG 1
   #else
   #define LOG_NDEBUG 0
   #endif
   #endif
   
   #ifndef LOG_TAG
   #define LOG_TAG NULL
   #endif
   默认情况下，LOG_NDEBUG = 0
   
   下面是和Verbose基本的log相关的宏定义：
   #ifndef LOGV
   #if LOG_NDEBUG
   #define LOGV(...)   ((void)0)
   #else
   #define LOGV(...) ((void)LOG(LOG_VERBOSE, LOG_TAG, __VA_ARGS__))// 只有在为0的情况下这个宏才有意义
   #endif
   #endif
   
   #define CONDITION(cond)     (__builtin_expect((cond)!=0, 0))
   
   #ifndef LOGV_IF
   #if LOG_NDEBUG
   #define LOGV_IF(cond, ...)   ((void)0)
   #else      // 只有在为0的情况下这个宏才有意义
   #define LOGV_IF(cond, ...) /
       ( (CONDITION(cond)) /
       ? ((void)LOG(LOG_VERBOSE, LOG_TAG, __VA_ARGS__)) /
       : (void)0 )
   #endif
   #endif
   
   ...
   #ifndef IF_LOGV
   #if LOG_NDEBUG
   #define IF_LOGV() if (false)
   #else
   #define IF_LOGV() IF_LOG(LOG_VERBOSE, LOG_TAG)
   #endif
   #endif

   综上，代码中如果需要打开VERBOSE级别的log，只需要定义#define  LOG_NDEBUG  0或者干脆不要定义；如果需要关闭VERBOSE级别的log，可以定义#define  LOG_NDEBUG  1或者#define  NDEBUG，二者选一即可。
   
参考文件：
   http://blog.youkuaiyun.com/czbever/archive/2010/09/27/5910640.aspx
   http://jiahuhuan.blog.163.com/blog/static/13024124620099179491291/
   http://www.javaeye.com/topic/477112