系列目录第一篇全景图与架构概览| 第二篇logd守护进程—启动、初始化与Socket通信 | 第三篇liblog库—日志写入的完整链路 | 第四篇日志写入接口—Java层与Native层 | 第五篇日志读取—logcat源码深度分析 | 第六篇日志缓冲区管理—容量、裁剪与统计机制 | 第七篇实战调试与常见问题分析本篇面向开发者讲清各种日志接口的源码实现与使用场景。所有接口最终都收敛到__android_log_buf_write()。一、写入接口全景图Java层 Native层 (liblog) ───────────────────────────────────────────────── Log.d(TAG, msg) ────┐ Slog.d(TAG, msg) ────┤ EventLog.writeEvent()────┤ __android_log_buf_write(bufID, prio, tag, msg) Rlog.d(TAG, msg) ────┤ │ │ ▼ ALOGD(msg) ────┘ write_to_log() → sendmsg(logdw) ALOGI/ALOGW/ALOGE ────┐ │二、android.util.Log — 应用层日志源码分析// frameworks/base/core/java/android/util/Log.javapublicfinalclassLog{publicstaticfinalintVERBOSE2;publicstaticfinalintDEBUG3;publicstaticfinalintINFO4;publicstaticfinalintWARN5;publicstaticfinalintERROR6;publicstaticfinalintASSERT7;// 核心方法所有 Log.d/v/i/w/e 最终调用这里publicstaticintprintln_native(intbufID,intpriority,Stringtag,Stringmsg){// Native 方法实现在 android_util_Log.cpp 中}// ── d/v/i/w/e 快捷方法 ──publicstaticintd(Stringtag,Stringmsg){returnprintln_native(LOG_ID_MAIN,DEBUG,tag,msg);}publicstaticintv(Stringtag,Stringmsg){returnprintln_native(LOG_ID_MAIN,VERBOSE,tag,msg);}publicstaticinti(Stringtag,Stringmsg){returnprintln_native(LOG_ID_MAIN,INFO,tag,msg);}publicstaticintw(Stringtag,Stringmsg){returnprintln_native(LOG_ID_MAIN,WARN,tag,msg);}publicstaticinte(Stringtag,Stringmsg){returnprintln_native(LOG_ID_MAIN,ERROR,tag,msg);}// ── wtf (What a Terrible Failure) ──publicstaticintwtf(Stringtag,Stringmsg){returnprintln_native(LOG_ID_MAIN,ASSERT,tag,msg);}// ── 带异常参数的版本 ──publicstaticintd(Stringtag,Stringmsg,Throwabletr){returnprintln_native(LOG_ID_MAIN,DEBUG,tag,msg\ngetStackTraceString(tr));}// ── 日志开关检测 ──publicstaticbooleanisLoggable(Stringtag,intlevel){// 读取系统属性 log.tag.TAGNAME// 例如adb shell setprop log.tag.MyTag DEBUG// 返回 true 时才打印用于性能优化}}关键常量// 缓冲区 IDstaticfinalintLOG_ID_MAIN0;staticfinalintLOG_ID_RADIO1;staticfinalintLOG_ID_EVENTS2;staticfinalintLOG_ID_SYSTEM3;staticfinalintLOG_ID_CRASH4;三、android_util_Log.cpp — JNI 桥接层// frameworks/base/core/jni/android_util_Log.cpp// println_native 的 JNI 实现staticjintandroid_util_Log_println_native(JNIEnv*env,jobject clazz,jint bufID,jint priority,jstring tagObj,jstring msgObj){// ── 步骤1从 Java 字符串获取 C 字符串 ──constchar*tagenv-GetStringUTFChars(tagObj,NULL);constchar*msgenv-GetStringUTFChars(msgObj,NULL);// ── 步骤2参数处理 ──// 注意priority 需要映射// Java 层 VERBOSE2, DEBUG3, INFO4, WARN5, ERROR6, ASSERT7// Native 层 ANDROID_LOG_VERBOSE2, ANDROID_LOG_DEBUG3, ...// 两者恰好一致无需转换// ── 步骤3调用 liblog 核心函数 ──intres__android_log_buf_write(bufID,(android_LogPriority)priority,tag,msg);// ── 步骤4释放 C 字符串 ──env-ReleaseStringUTFChars(tagObj,tag);env-ReleaseStringUTFChars(msgObj,msg);returnres;}// JNI 方法注册表staticJNINativeMethod gMethods[]{{println_native,(IILjava/lang/String;Ljava/lang/String;)I,(void*)android_util_Log_println_native},// ...};JNI 层极简Java 层的所有重载d/v/i/w/e Throwable在进入 JNI 之前就已展开为 tagmsg 字符串JNI 层只需透传参数到__android_log_buf_write()。四、android.util.Slog — 系统框架日志// frameworks/base/core/java/android/util/Slog.javapublicfinalclassSlog{privateSlog(){}// 不可实例化publicstaticintd(Stringtag,Stringmsg){returnLog.println_native(Log.LOG_ID_SYSTEM,Log.DEBUG,tag,msg);}publicstaticinte(Stringtag,Stringmsg){returnLog.println_native(Log.LOG_ID_SYSTEM,Log.ERROR,tag,msg);}// ... 与 Log.java 完全相同的 API唯一区别bufID LOG_ID_SYSTEM}Slog 与 Log 的唯一区别bufID参数不同。Log.d()→LOG_ID_MAIN(0)→ logd 的main缓冲区Slog.d()→LOG_ID_SYSTEM(3)→ logd 的system缓冲区两者共享Log.java的println_native()JNI 方法。日志命名约定Android 7 源码中系统服务的 TAG 命名通常使用服务名缩写// frameworks/base/services/core/java/com/android/server/am/ActivityManagerService.javastaticfinalStringTAGActivityManager;Slog.d(TAG,Some system message);// frameworks/base/services/core/java/com/android/server/wm/WindowManagerService.javastaticfinalStringTAGWindowManager;五、android.util.EventLog — 事件日志// frameworks/base/core/java/android/util/EventLog.javapublicclassEventLog{// event-log-tags 文件中定义的 tag → 编号映射// 例如42 am_proc_start (User|1|5),(PID|1|5)...publicstaticintwriteEvent(inttag,Object...values){returnwriteEvent(tag,Arrays.asList(values));}publicstaticintwriteEvent(inttag,ListObjectlist){// ── 步骤1将事件编码为二进制格式 ──// 每个 value 按照其类型编码// Integer → 4 字节小端// Long → 8 字节小端// String → 4 字节长度 UTF-8 字符串// Float → 4 字节 IEEE 754byte[]bytesencodeEvents(list);// ── 步骤2写入 events 缓冲区 ──// 底层仍然调用 println_native(LOG_ID_EVENTS, ...)returnLog.println_native(LOG_ID_EVENTS,ANDROID_LOG_INFO,Integer.toString(tag),newString(bytes,ISO-8859-1));}}EventLog 的特殊之处写入LOG_ID_EVENTS(2)缓冲区日志内容为二进制编码非纯文本字符串event-log-tags文件定义 tag 编号与字段类型的映射logcat -b events读取时会根据映射表解码为可读文本event-log-tags 文件示例# system/core/logcat/event.logtags 42 am_proc_start (User|1|5),(PID|1|5),(UID|1|5),(Process Name|3) 43 am_proc_bound (User|1|5),(PID|1|5),(Process Name|3) 44 am_anr (User|1|5),(PID|1|5),(Package Name|3),(Flags|1|5) ...格式tag编号 tag名称 (字段1名称|类型|字节数),...六、android.util.Rlog — 无线通信日志// 与 Log 完全相同的实现仅 bufID 不同publicstaticintv(Stringtag,Stringmsg){returnLog.println_native(Log.LOG_ID_RADIO,Log.VERBOSE,tag,msg);}七、Java 层四大接口对比接口缓冲区bufID格式典型用途Log.d()main0纯文本应用调试Slog.d()system3纯文本系统服务日志EventLog.writeEvent()events2二进制系统关键事件Rlog.d()radio1纯文本无线通信调试所有接口都收敛到同一个 JNI 方法Log.println_native(bufID, priority, tag, msg)。八、Native 层日志宏 — ALOGD 系列// system/core/include/log/log.h// ── 日志宏定义 ──#ifndefLOG_TAG#defineLOG_TAGNULL// 必须在 include 前定义#endif// ── 带 isLoggable 检查的宏条件编译优化 ──#ifLOG_NDEBUG#defineALOGV(...)((void)0)// 发布版直接编译为空#else#defineALOGV(...)__android_log_print(ANDROID_LOG_VERBOSE,LOG_TAG,__VA_ARGS__)#endif#defineALOGD(...)__android_log_print(ANDROID_LOG_DEBUG,LOG_TAG,__VA_ARGS__)#defineALOGI(...)__android_log_print(ANDROID_LOG_INFO,LOG_TAG,__VA_ARGS__)#defineALOGW(...)__android_log_print(ANDROID_LOG_WARN,LOG_TAG,__VA_ARGS__)#defineALOGE(...)__android_log_print(ANDROID_LOG_ERROR,LOG_TAG,__VA_ARGS__)// ── 条件编译的 DEBUG 和非 DEBUG 版本 ──#ifndefLOG_NDEBUG#defineIF_ALOGVif(1)#else#defineIF_ALOGVif(0)#endifALOGV 的特殊控制// 使用方式// 文件开头#define LOG_NDEBUG 0 (启用 verbose)// 或通过 Android.mkLOCAL_CFLAGS -DLOG_NDEBUG0// 构建系统默认行为// userdebug/eng 版本LOG_NDEBUG 0输出 ALOGV// user 版本LOG_NDEBUG 1ALOGV 编译为空九、__android_log_print() 宏展开 — 通往 liblog 的最后一公里// system/core/include/log/log_main.h#define__android_log_print(prio,tag,fmt...)\__android_log_buf_print(LOG_ID_MAIN,prio,tag,fmt)// __android_log_buf_print 内部实现int__android_log_buf_print(intbufID,intprio,constchar*tag,constchar*fmt,...){va_list ap;charbuf[LOG_BUF_SIZE];// 栈上缓冲区通常 1024 字节va_start(ap,fmt);vsnprintf(buf,LOG_BUF_SIZE,fmt,ap);// 格式化字符串va_end(ap);return__android_log_buf_write(bufID,prio,tag,buf);}完整的宏展开链路ALOGD(value%d, x) │ 展开 ▼ __android_log_print(ANDROID_LOG_DEBUG, LOG_TAG, value%d, x) │ 展开 ▼ __android_log_buf_print(LOG_ID_MAIN, ANDROID_LOG_DEBUG, LOG_TAG, value%d, x) │ 内部调用 ▼ vsnprintf → 格式化字符串 __android_log_buf_write(LOG_ID_MAIN, ANDROID_LOG_DEBUG, LOG_TAG, value42)十、各接口的缓冲区映射总表接口bufID缓冲区权限要求Log.d/v/i/w/e/wtf()0main任何进程ALOGD/V/I/W/E/F()0main任何进程Slog.d/v/i/w/e()3system系统进程 (UID1000)EventLog.writeEvent()2events系统服务Rlog.d()1radiorild 及无线相关进程(内部)4crash系统崩溃处理普通应用只能写入main缓冲区这是 Android 安全模型的一部分。尝试写 system/events/radio 会被 SELinux 或 UID 权限检查阻止。十一、性能优化建议使用 isLoggable() 前置判断// ❌ 不好的写法 — 即使不输出字符串拼接仍会执行Log.d(TAG,Processing item: heavyToString(obj));// ✅ 好的写法 — 不满足条件时跳过字符串拼接if(Log.isLoggable(TAG,Log.DEBUG)){Log.d(TAG,Processing item: heavyToString(obj));}Native 层使用 IF_ALOGV/RLOGV// ❌ ALOGV 内部的 vsnprintf 即使最终不输出也会执行ALOGV(complex data: %s,expensive_format(data));// ✅ 使用 IF_ALOGV 保护IF_ALOGV{ALOGV(complex data: %s,expensive_format(data));}日志级别的选择策略级别何时使用VERBOSE详细调试信息不应出现在发布版中DEBUG开发调试信息user版本可关闭INFO值得记录的正常事件如启动完成、连接成功WARN异常但可恢复的情况ERROR错误、失败的操作ASSERT/wtf不可能发生的情况应视为 bug十二、本篇总结Java 层四个接口Log/Slog/EventLog/Rlog的唯一区别是bufID参数JNI 层极简透传不做额外处理Native 层 ALOGD 宏通过vsnprintf格式化后同样调用__android_log_buf_write()LOG_NDEBUG控制 verbose 日志的编译时开关所有调用最终汇聚到同一个函数__android_log_buf_write()下一篇将分析logcat 的源码看它如何从 logd 读取、过滤和格式化日志。