浅谈Android系统开发中LOG的使用

在程序开发过程中，LOG是广泛使用的用来记录程序执行过程的机制，它既可以用于程序调试，也可以用于产品运营中的事件记录。在Android系统中，提供了简单、便利的LOG机制，开发人员可以方便地使用。在这一篇文章中，我们简单介绍在Android内核空间和用户空间中LOG的使用和查看方法。

        一. 内核开发时LOG的使用。Android内核是基于Linux Kerne 2.36的，因此，Linux Kernel的LOG机制同样适合于Android内核，它就是有名的printk，与C语言的printf齐名。与printf类似，printk提供格式化输入功能，同时，它也具有所有LOG机制的特点--提供日志级别过虑功能。printk提供了8种日志级别（<linux/kernel.h>）：

1. #define KERN_EMERG  "<0>"   /* system is unusable           */  
2. #define KERN_ALERT  "<1>"   /* action must be taken immediately */  
3. #define KERN_CRIT   "<2>"   /* critical conditions          */  
4. #deinfe KERN_ERR    "<3>"   /* error conditions         */  
5. #deinfe KERN_WARNING    "<4>"   /* warning conditions           */  
6. #deinfe KERN_NOTICE "<5>"   /* normal but significant condition */  
7. #deinfe KERN_INFO   "<6>"   /* informational            */  
8. #deinfe KERN_DEBUG  "<7>"   /* debug-level messages         */ 

  printk的使用方法：

       printk(KERN_ALERT"This is the log printed by printk in linux kernel space.");

       KERN_ALERT表示日志级别，后面紧跟着要格式化字符串。

       在Android系统中，printk输出的日志信息保存在/proc/kmsg中，要查看/proc/kmsg的内容，参照在Ubuntu上下载、编译和安装Android最新内核源代码（Linux Kernel）一文，在后台中运行模拟器：

       USER-NAME@MACHINE-NAME:~/Android$ emulator &

       启动adb shell工具：

       USER-NAME@MACHINE-NAME:~/Android$ adb shell

       查看/proc/kmsg文件：

       root@android:/ # cat  /proc/kmsg

       二. 用户空间程序开发时LOG的使用。Android系统在用户空间中提供了轻量级的logger日志系统，它是在内核中实现的一种设备驱动，与用户空间的logcat工具配合使用能够方便地跟踪调试程序。在Android系统中，分别为C/C++ 和Java语言提供两种不同的logger访问接口。C/C++日志接口一般是在编写硬件抽象层模块或者编写JNI方法时使用，而Java接口一般是在应用层编写APP时使用。

       Android系统中的C/C++日志接口是通过宏来使用的。在system/core/include/android/log.h定义了日志的级别：

1. /*  
2.  * Android log priority values, in ascending priority order.  
3.  */  
4. typedef enum android_LogPriority {  
5.     ANDROID_LOG_UNKNOWN = 0,  
6.     ANDROID_LOG_DEFAULT,    /* only for SetMinPriority() */  
7.     ANDROID_LOG_VERBOSE,  
8.     ANDROID_LOG_DEBUG,  
9.     ANDROID_LOG_INFO,  
10.     ANDROID_LOG_WARN,  
11.     ANDROID_LOG_ERROR,  
12.     ANDROID_LOG_FATAL,  
13.     ANDROID_LOG_SILENT, /* only for SetMinPriority(); must be last */  
14. } android_LogPriority; 

   在system/core/include/cutils/log.h中，定义了对应的宏，如对应于ANDROID_LOG_VERBOSE的宏LOGV：

1. /*  
2.  * This is the local tag used for the following simplified  
3.  * logging macros. You can change this preprocessor definition  
4.  * before using the other macros to change the tag.  
5.  */  
6. #ifndef LOG_TAG  
7. #define LOG_TAG NULL 
8. #endif  
9.  
10. /*  
11.  * Simplified macro to send a verbose log message using the current LOG_TAG.  
12.  */  
13. #ifndef LOGV  
14. #if LOG_NDEBUG  
15. #define LOGV(...)   ((void)0)  
16. #else 
17. #define LOGV(...)   ((void)LOG(LOG_VERBOSE, LOG_TAG, __VA_ARGS__))  
18. #endif  
19. #endif  
20.  
21. /*  
22.  * Basic log message macro.  
23.  *  
24.  * Example:  
25.  *  LOG(LOG_WARN, NULL, "Failed with error %d", errno);  
26.  *  
27.  * The second argument may be NULL or "" to indicate the "global" tag.  
28.  */  
29. #ifndef LOG  
30. #define LOG(priority, tag, ...) \  
31.      LOG_PRI(ANDROID_##priority, tag, __VA_ARGS__)  
32. #endif  
33.  
34. /*  
35.  * Log macro that allows you to specify a number for priority.  
36.  */  
37. #ifndef LOG_PRI  
38. #define LOG_PRI(priority, tag, ...) \  
39.      android_printLog(priority, tag, __VA_ARGS__)  
40. #endif  
41.  
42. /*  
43.  * ================================================================  
44.  *  
45.  * The stuff in the rest of this file should not be used directly.  
46.  */  
47. #define android_printLog(prio, tag, fmt...) \  
48.      __android_log_print(prio, tag, fmt) 

  因此，如果要使用C/C++日志接口，只要定义自己的LOG_TAG宏和包含头文件system/core/include/cutils/log.h就可以了：

         #define LOG_TAG "MY LOG TAG"

         #include <cutils/log.h>

         就可以了，例如使用LOGV：

         LOGV("This is the log printed by LOGV in android user space.");

         再来看Android系统中的Java日志接口。Android系统在Frameworks层中定义了Log接口（frameworks/base/core/java/android/util/Log.java）：

1. ................................................  
2.  
3. public final class Log {  
4.  
5. ................................................  
6.  
7.     /**  
8.      * Priority constant for the println method; use Log.v.  
9.          */  
10.     public static final int VERBOSE = 2;  
11.  
12.     /**  
13.      * Priority constant for the println method; use Log.d.  
14.          */  
15.     public static final int DEBUG = 3;  
16.  
17.     /**  
18.      * Priority constant for the println method; use Log.i.  
19.          */  
20.     public static final int INFO = 4;  
21.  
22.     /**  
23.      * Priority constant for the println method; use Log.w.  
24.          */  
25.     public static final int WARN = 5;  
26.  
27.     /**  
28.      * Priority constant for the println method; use Log.e.  
29.          */  
30.     public static final int ERROR = 6;  
31.  
32.     /**  
33.      * Priority constant for the println method.  
34.          */  
35.     public static final int ASSERT = 7;  
36.  
37. .....................................................  
38.  
39.     public static int v(String tag, String msg) {  
40.         return println_native(LOG_ID_MAIN, VERBOSE, tag, msg);  
41.     }  
42.  
43.     public static int v(String tag, String msg, Throwable tr) {  
44.         return println_native(LOG_ID_MAIN, VERBOSE, tag, msg + '\n' + getStackTraceString(tr));  
45.     }  
46.  
47.     public static int d(String tag, String msg) {  
48.         return println_native(LOG_ID_MAIN, DEBUG, tag, msg);  
49.     }  
50.  
51.     public static int d(String tag, String msg, Throwable tr) {  
52.         return println_native(LOG_ID_MAIN, DEBUG, tag, msg + '\n' + getStackTraceString(tr));  
53.     }  
54.  
55.     public static int i(String tag, String msg) {  
56.         return println_native(LOG_ID_MAIN, INFO, tag, msg);  
57.     }  
58.  
59.     public static int i(String tag, String msg, Throwable tr) {  
60.         return println_native(LOG_ID_MAIN, INFO, tag, msg + '\n' + getStackTraceString(tr));  
61.     }  
62.  
63.     public static int w(String tag, String msg) {  
64.         return println_native(LOG_ID_MAIN, WARN, tag, msg);  
65.     }  
66.  
67.     public static int w(String tag, String msg, Throwable tr) {  
68.         return println_native(LOG_ID_MAIN, WARN, tag, msg + '\n' + getStackTraceString(tr));  
69.     }  
70.  
71.     public static int w(String tag, Throwable tr) {  
72.         return println_native(LOG_ID_MAIN, WARN, tag, getStackTraceString(tr));  
73.     }  
74.       
75.     public static int e(String tag, String msg) {  
76.         return println_native(LOG_ID_MAIN, ERROR, tag, msg);  
77.     }  
78.  
79.     public static int e(String tag, String msg, Throwable tr) {  
80.         return println_native(LOG_ID_MAIN, ERROR, tag, msg + '\n' + getStackTraceString(tr));  
81.     }  
82.  
83. ..................................................................  
84.  
85.     /**@hide */ public static native int println_native(int bufID,  
86.         int priority, String tag, String msg);  
87. } 

     因此，如果要使用Java日志接口，只要在类中定义的LOG_TAG常量和引用android.util.Log就可以了：

        private static final String LOG_TAG = "MY_LOG_TAG";

        Log.i(LOG_TAG, "This is the log printed by Log.i in android user space.");

        要查看这些LOG的输出，可以配合logcat工具。如果是在Eclipse环境下运行模拟器，并且安装了Android插件，那么，很简单，直接在Eclipse就可以查看了：

 如果是在自己编译的Android源代码工程中使用，则在后台中运行模拟器：

       USER-NAME@MACHINE-NAME:~/Android$ emulator &

       启动adb shell工具：

       USER-NAME@MACHINE-NAME:~/Android$ adb shell

       使用logcat命令查看日志：

       root@android:/ # logcat

       这样就可以看到输出的日志了。