logcat命令使用方法和查看android系统日志缓冲区内容的方法

*注：可以用 adb logcat > 路径/文件名 来保存，
此命令执行之时起的全部日志信息到一个文件里，ctrl + C 结束日志输出；
后面不加 > 路径/文件名 的话，则在 stdout (终端窗口)中输出！
例如：$ adb logcat -v long Checkin *:S > ~/桌面/log.txt

一、在 Java 与 C 语言中输出日志：
1) Java 代码在程序中输出日志, 使用 android.util.Log 类的以下 5 个方法：
   Log.v()、Log.d()、Log.i()、Log.w()、Log.e()。
   分对应 Verbose、Debug、INFO、Warn、Error 的首字母。
   例如：Log.i( "类::函数名", "日期_时间_源码文件名_行号_日志信息内容" );

2) C 代码在程序中输出日志，使用 log 的 API 函数：
   __android_log_write( 日志类型宏，日志标签字符串，日志令牌内容字符串 );
   需要：1. Android.mk 中添加 LOCAL_LDLIBS := -L$(SYSROOT)/usr/lib -llog
   2. *.c 中添加 #include <android/log.h>
   3. 日志类型宏有：

        // Android log priority values, in ascending priority order.
        typedef enum android_LogPriority {
            ANDROID_LOG_UNKNOWN = 0,
            // only for SetMinPriority()
            ANDROID_LOG_DEFAULT,
            ANDROID_LOG_VERBOSE,
            ANDROID_LOG_DEBUG,
            ANDROID_LOG_INFO,
            ANDROID_LOG_WARN,
            ANDROID_LOG_ERROR,
            ANDROID_LOG_FATAL,
            // only for SetMinPriority(); must be last
            ANDROID_LOG_SILENT,
        } android_LogPriority;

二、logcat 使用方法:     
Usage: logcat [options] [filterspecs]
用法：  logcat [选项] [过滤说明]

options include:
选项包含：
  -s              Set default filter to silent.
                  Like specifying filterspec '*:S'
                  设置默认过滤为无声的。
                  像指定过滤说明为 *:S ，见下面 过滤说明 部份详述

  -f <filename>   Log to file.
                  Default to stdout
                  输出日志到文件。
                  默认为 stdout

  -r [<kbytes>]   Rotate log every kbytes.
                  (16 if unspecified).
                  Requires -f
                  设置环形日志缓冲区的kbytes。
                  默认值为16。
                  需要和 -f 选项一起使用

  -n <count>      Sets max number of rotated logs to <count>, default 4
                  设置环形日志缓冲区的最大数目，默认值是4，需要和 -r 选项一起使用

  -v <format>     Sets the log print format, where <format> is one of:
                  设置 log 的打印格式,  格式有如下主要7种:(不能组合使用)

                  brief
                  process
                  tag
                  thread
                  raw
                  time
                  threadtime
                  long

  -c              clear (flush) the entire log and exit
                  清除所有 log 并退出

  -d              dump the log and then exit (don't block)
                  得到所有log并退出且不阻塞

  -t <count>      print only the most recent <count> lines (implies -d)
                  仅打印最近的由参数 count 指出的行数(必然包含 -d)

  -g              get the size of the log's ring buffer and exit
                  得到环形缓冲区的大小并退出

  -b <buffer>     Request alternate ring buffer, 'main', 'system', 'radio' or 'events'.
                  Multiple -b parameters are allowed and the results are interleaved.
                  The default is -b main -b system.
                  请求供替换的环形缓冲区，如：main，system，radio，events。
                  多个 -b 参数是被允许，并且结果是交错输出的。
                  -b main -b system 是默认的。

  -B              output the log in binary
                  输出 log 到二进制文件中。

filterspecs are a series of <tag>[:priority]
过滤说明是一系列 <tag>[:priority]

where <tag> is a log component tag (or * for all) and priority is:
tag 是 eclipse 中 logcat 图形界面中 Tag 的内容(或者有 * 表示全部)，它之后的冒号(:)后面跟优先级：
    日志类型标识符(优先级由低到高排列):
    1. V — Verbose 详细的 <- 最低优先权
    2. D — Debug   调试
    3. I — Info    消息
    4. W — Warn    警告
    5. E — Error   错误
    6. F — Fatal   致命的
    7. S — Silent  无声的 <- 最高优先权

'*' means '*:d' and <tag> by itself means <tag>:v
* 意味着 *:d 且 单孤地 tag 意味着 tag:V

If not specified on the commandline, filterspec is set from ANDROID_LOG_TAGS.
如果在命令行上没有详细说明，过滤规格即是 ANDROID_LOG_TAGS 结果集。

If no filterspec is found, filter defaults to '*:I'
如果没有过滤说明，过滤规格默认为 *:I

If not specified with -v, format is set from ANDROID_PRINTF_LOG or defaults to "brief"
如果没有 -v 指定格式，将是 ANDROID_PRINTF_LOG 或 brief 格式集。

1) 只输出指定 标签 和 类型 的日志
   格式：
   adb logcat <日志标签>:<日志类型标识符> <日志标签>:<日志类型标识符> ... *:S
   注：1. 可以写多个 <日志标签>:<日志类型标识符> 之间用空格分隔；
   2. 最后必须是 *:S ，表示其它的都不要显示出来
   例如：
   $ adb logcat dalvikvm:D Checkin:W *:S

   注：adb logcat Checkin *:S =等同于=> adb logcat Checkin:V *:S
   注：以上命令均没加 -v 来指出日志格式，即默认为: ANDROID_PRINTF_LOG 或 brief 格式集。

2) 输出指定 标签 和 类型 的带有格式的日志
注：以下测试日志内容为：test log format，
即 eclipse 中的 logcat 图形界面里的 Text 中的内容！

1. brief      - 日志类型/日志标签(进程ID): 日志内容
   例如：$ adb logcat -v brief Checkin *:S
   I/Checkin(24713): test log format
  
2. process    - 日志类型(进程ID) 日志内容 (日志标签)
   例如：$ adb logcat -v process Checkin *:S
   I(24713) test log format  (Checkin)
  
3. tag        - 日志类型/日志标签: 日志内容
   例如：$ adb logcat -v tag Checkin *:S
        I/Checkin: test log format

4. thread     - 日志类型(进程ID:线程ID)
   例如：$ adb logcat -v thread Checkin *:S
        I(24713:0x6089) test log format

5. raw        - 日志内容
   例如：$ adb logcat -v raw Checkin *:S
        test log format

6. time       - 日期 调用时间 日志类型/日志标签(进程ID): 日志内容
   例如：$ adb logcat -v time Checkin *:S
   05-27 11:25:33.854 I/Checkin(24713): test log format

7. threadtime - 日期 调用时间 进程ID 线程ID 日志类型 日志标签: 日志内容
   例如：$ adb logcat -v time Checkin *:S
   05-27 11:25:33.854 24713 24713 I Checkin: test log format
   注：只有此种格式时 线程ID 为十进制数。

8. long       - [ 日期 调用时间 进程ID:线程ID 日志类型/日志标签 ] 转行显示 日志内容
   例如：$ adb logcat -v long Checkin *:S
   [ 05-27 11:25:33.854 24713:0x6089 I/Checkin ]
   test log format