浅谈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>）：

 #defineKERN_EMERG"<0>"/*systemisunusable*/
 #defineKERN_ALERT"<1>"/*actionmustbetakenimmediately*/
 #defineKERN_CRIT"<2>"/*criticalconditions*/
 #deinfeKERN_ERR"<3>"/*errorconditions*/
 #deinfeKERN_WARNING"<4>"/*warningconditions*/
 #deinfeKERN_NOTICE"<5>"/*normalbutsignificantcondition*/
 #deinfeKERN_INFO"<6>"/*informational*/
 #deinfeKERN_DEBUG"<7>"/*debug-levelmessages*/

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定义了日志的级别：

 /*
 *Androidlogpriorityvalues,inascendingpriorityorder.
 */
 typedefenumandroid_LogPriority{
 ANDROID_LOG_UNKNOWN=0,
 ANDROID_LOG_DEFAULT,/*onlyforSetMinPriority()*/
 ANDROID_LOG_VERBOSE,
 ANDROID_LOG_DEBUG,
 ANDROID_LOG_INFO,
 ANDROID_LOG_WARN,
 ANDROID_LOG_ERROR,
 ANDROID_LOG_FATAL,
 ANDROID_LOG_SILENT,/*onlyforSetMinPriority();mustbelast*/
 }android_LogPriority;

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

 /*
 *Thisisthelocaltagusedforthefollowingsimplified
 *loggingmacros.Youcanchangethispreprocessordefinition
 *beforeusingtheothermacrostochangethetag.
 */
 #ifndefLOG_TAG
 #defineLOG_TAGNULL
 #endif

 /*
 *SimplifiedmacrotosendaverboselogmessageusingthecurrentLOG_TAG.
 */
 #ifndefLOGV
 #ifLOG_NDEBUG
 #defineLOGV(...)((void)0)
 #else
 #defineLOGV(...)((void)LOG(LOG_VERBOSE,LOG_TAG,__VA_ARGS__))
 #endif
 #endif

 /*
 *Basiclogmessagemacro.
 *
 *Example:
 *LOG(LOG_WARN,NULL,"Failedwitherror%d",errno);
 *
 *ThesecondargumentmaybeNULLor""toindicatethe"global"tag.
 */
 #ifndefLOG
 #defineLOG(priority,tag,...)\
 LOG_PRI(ANDROID_##priority,tag,__VA_ARGS__)
 #endif

 /*
 *Logmacrothatallowsyoutospecifyanumberforpriority.
 */
 #ifndefLOG_PRI
 #defineLOG_PRI(priority,tag,...)\
 android_printLog(priority,tag,__VA_ARGS__)
 #endif

 /*
 *================================================================
 *
 *Thestuffintherestofthisfileshouldnotbeuseddirectly.
 */
 #defineandroid_printLog(prio,tag,fmt...)\
 __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）：

 ................................................

 publicfinalclassLog{

 ................................................

 /**
 *Priorityconstantfortheprintlnmethod;useLog.v.
 */
 publicstaticfinalintVERBOSE=2;

 /**
 *Priorityconstantfortheprintlnmethod;useLog.d.
 */
 publicstaticfinalintDEBUG=3;

 /**
 *Priorityconstantfortheprintlnmethod;useLog.i.
 */
 publicstaticfinalintINFO=4;

 /**
 *Priorityconstantfortheprintlnmethod;useLog.w.
 */
 publicstaticfinalintWARN=5;

 /**
 *Priorityconstantfortheprintlnmethod;useLog.e.
 */
 publicstaticfinalintERROR=6;

 /**
 *Priorityconstantfortheprintlnmethod.
 */
 publicstaticfinalintASSERT=7;

 .....................................................

 publicstaticintv(Stringtag,Stringmsg){
 returnprintln_native(LOG_ID_MAIN,VERBOSE,tag,msg);
 }

 publicstaticintv(Stringtag,Stringmsg,Throwabletr){
 returnprintln_native(LOG_ID_MAIN,VERBOSE,tag,msg+'\n'+getStackTraceString(tr));
 }

 publicstaticintd(Stringtag,Stringmsg){
 returnprintln_native(LOG_ID_MAIN,DEBUG,tag,msg);
 }

 publicstaticintd(Stringtag,Stringmsg,Throwabletr){
 returnprintln_native(LOG_ID_MAIN,DEBUG,tag,msg+'\n'+getStackTraceString(tr));
 }

 publicstaticinti(Stringtag,Stringmsg){
 returnprintln_native(LOG_ID_MAIN,INFO,tag,msg);
 }

 publicstaticinti(Stringtag,Stringmsg,Throwabletr){
 returnprintln_native(LOG_ID_MAIN,INFO,tag,msg+'\n'+getStackTraceString(tr));
 }

 publicstaticintw(Stringtag,Stringmsg){
 returnprintln_native(LOG_ID_MAIN,WARN,tag,msg);
 }

 publicstaticintw(Stringtag,Stringmsg,Throwabletr){
 returnprintln_native(LOG_ID_MAIN,WARN,tag,msg+'\n'+getStackTraceString(tr));
 }

 publicstaticintw(Stringtag,Throwabletr){
 returnprintln_native(LOG_ID_MAIN,WARN,tag,getStackTraceString(tr));
 }

 publicstaticinte(Stringtag,Stringmsg){
 returnprintln_native(LOG_ID_MAIN,ERROR,tag,msg);
 }

 publicstaticinte(Stringtag,Stringmsg,Throwabletr){
 returnprintln_native(LOG_ID_MAIN,ERROR,tag,msg+'\n'+getStackTraceString(tr));
 }

 ..................................................................

 /**@hide*/publicstaticnativeintprintln_native(intbufID,
 intpriority,Stringtag,Stringmsg);
 }

因此，如果要使用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

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