优化Android日志：动态获取调用者类名作为TAG的实践指南

import java.lang.StackWalker

/**
 * 获取调用者类名
 * 适用于 Java 9 及更高版本
 */
fun getCallerClassNameWithStackWalker(): String {
    // StackWalker.Option.RETAIN_CLASS_REFERENCE 选项允许获取 Class 对象，
    // 从而避免了字符串解析，性能更佳。
    // callerClass() 方法会返回调用 getCallerClassNameWithStackWalker 方法的那个类。
    // 如果是 Logger.d -> getCallerClassNameWithStackWalker，那么 callerClass() 返回的就是 Logger 类。
    // 我们需要的是 Logger 的调用者，所以需要进一步处理。
    val callerClass = StackWalker.getInstance(StackWalker.Option.RETAIN_CLASS_REFERENCE)
        .walk { stream ->
            stream.skip(2) // 跳过 getCallerClassNameWithStackWalker 和 Logger 方法本身
                  .findFirst()
                  .map { it.declaringClass }
                  .orElse(null)
        }
    return callerClass?.simpleName ?: "UnknownCaller"
}

/**
 * 获取调用者类名
 * 适用于所有 Java 版本，包括 Android
 */
fun getCallerClassNameWithThreadStackTrace(): String {
    val stackTrace = Thread.currentThread().stackTrace
    // stackTrace[0] 是 Thread.getStackTrace() 方法本身
    // stackTrace[1] 是 getCallerClassNameWithThreadStackTrace 方法
    // stackTrace[2] 是调用 getCallerClassNameWithThreadStackTrace 方法的日志方法 (如 Logger.d)
    // stackTrace[3] 才是日志方法 (Logger.d) 的实际调用者
    if (stackTrace.size > 3) {
        val fullClassName = stackTrace[3].className
        return fullClassName.substringAfterLast('.') // 获取简单类名
    }
    return "UnknownCaller"
}

/**
 * 获取调用者类名
 * 适用于所有 Java 版本，包括 Android
 */
fun getCallerClassNameWithException(): String {
    val stackTrace = Exception().stackTrace
    // stackTrace[0] 是 Exception() 构造函数
    // stackTrace[1] 是 getCallerClassNameWithException 方法
    // stackTrace[2] 是调用 getCallerClassNameWithException 方法的日志方法 (如 Logger.d)
    // stackTrace[3] 才是日志方法 (Logger.d) 的实际调用者
    if (stackTrace.size > 3) {
        val fullClassName = stackTrace[3].className
        return fullClassName.substringAfterLast('.') // 获取简单类名
    }
    return "UnknownCaller"
}

import android.util.Log
import me.entri.entrime.BuildConfig // 假设 BuildConfig 存在
// import me.entri.entrime.utils.Constants // 如果不再需要硬编码的 LOGGING_TAG，可以移除

object Logger {

    /**
     * 获取调用者类名作为日志TAG。
     * 这里的索引需要根据 Logger 内部方法的调用层级进行调整。
     *
     * 调用链示例:
     * 0: Thread.getStackTrace()
     * 1: Logger.getCallerTag()
     * 2: Logger.d(message)
     * 3: CallerClass.someMethod() <-- 我们需要的目标
     */
    private fun getCallerTag(): String {
        val stackTrace = Thread.currentThread().stackTrace
        // 索引 0 是 Thread.getStackTrace()
        // 索引 1 是 getCallerTag() 方法本身
        // 索引 2 是 Logger 中的日志方法 (如 d, e, w, v)
        // 索引 3 才是实际调用 Logger.d/e/w/v 的类
        return if (stackTrace.size > 3) {
            // 获取完整的类名，然后只取最后一个点号后的部分（简单类名）
            stackTrace[3].className.substringAfterLast('.')
        } else {
            "UnknownCaller" // 备用TAG
        }
    }

    @JvmStatic
    fun d(message : Any?){
        if (BuildConfig.DEBUG) {
            val tag = getCallerTag()
            Log.d(tag , message.toString())
        }
    }

    @JvmStatic
    fun d(message: Any? , e : Exception?){
        if (BuildConfig.DEBUG) {
            val tag = getCallerTag()
            Log.d(tag , message.toString(), e)
        }
    }

    @JvmStatic
    fun e(message : Any?){
        if (BuildConfig.DEBUG) {
            val tag = getCallerTag()
            Log.e(tag , message.toString())
        }
    }

    @JvmStatic
    fun e(message: Any? , e : Exception?){
        if (BuildConfig.DEBUG) {
            val tag = getCallerTag()
            Log.e(tag , message.toString(), e)
        }
    }

    @JvmStatic
    fun w(message : Any?){
        if (BuildConfig.DEBUG) {
            val tag = getCallerTag()
            Log.w(tag , message.toString())
        }
    }

    @JvmStatic
    fun w(message: Any? , e : Exception?){
        if (BuildConfig.DEBUG) {
            val tag = getCallerTag()
            Log.w(tag , message.toString(), e)
        }
    }

    @JvmStatic
    fun v(message : Any?){
        if (BuildConfig.DEBUG) {
            val tag = getCallerTag()
            Log.v(tag , message.toString())
        }
    }

    @JvmStatic
    fun v(message: Any? , e : Exception?){
        if (BuildConfig.DEBUG) {
            val tag = getCallerTag()
            Log.v(tag , message.toString(), e)
        }
    }
}

// 示例：在 Splash.kt 中调用
class SplashActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        try {
            val error = 4384 / 0 // 算术错误用于测试
        } catch (e: Exception) {
            Logger.e("发生了一个错误", e) // Logcat TAG 将显示 "SplashActivity"
        }
    }
}