feat(logger): Implement a custom logger with configurable log levels

app/proguard-rules.pro

@@ -1,3 +1,12 @@
+# This will strip `Log.v`, `Log.d`, and `Log.i` statements and will leave `Log.w` and `Log.e` statements intact.
+#-assumenosideeffects class android.util.Log {
+#  public static boolean isLoggable(java.lang.String, int);
+#  public static int v(...);
+#  public static int d(...);
+#  public static int i(...);
+#}
+
+# JavascriptInterface
 -keepattributes *Annotation*
 -keepattributes *JavascriptInterface*
 -keepclassmembers class * {

app/src/main/java/com/ding1ding/jsbridge/app/MainActivity.kt

@@ -2,7 +2,6 @@ package com.ding1ding.jsbridge.app
 
 import android.annotation.SuppressLint
 import android.os.Bundle
-import android.util.Log
 import android.view.KeyEvent
 import android.view.View
 import android.webkit.WebView
@@ -11,6 +10,7 @@ import android.widget.LinearLayout
 import androidx.appcompat.app.AppCompatActivity
 import com.ding1ding.jsbridge.Callback
 import com.ding1ding.jsbridge.ConsolePipe
+import com.ding1ding.jsbridge.Logger
 import com.ding1ding.jsbridge.MessageHandler
 import com.ding1ding.jsbridge.WebViewJavascriptBridge
 import com.ding1ding.jsbridge.model.Person
@@ -27,6 +27,13 @@ class MainActivity :
   override fun onCreate(savedInstanceState: Bundle?) {
     super.onCreate(savedInstanceState)
     setContentView(R.layout.activity_main)
+
+    if (BuildConfig.DEBUG) {
+      WebViewJavascriptBridge.setLogLevel(Logger.LogLevel.DEBUG)
+    } else {
+      WebViewJavascriptBridge.setLogLevel(Logger.LogLevel.ERROR)
+    }
+
     setupWebView()
     setupClickListeners()
   }
@@ -56,7 +63,7 @@ class MainActivity :
 
   override fun onDestroy() {
     releaseWebView()
-    Log.d(TAG, "onDestroy")
+    Logger.d(TAG) { "onDestroy" }
     super.onDestroy()
   }
 
@@ -93,7 +100,7 @@ class MainActivity :
     bridge = WebViewJavascriptBridge.create(this, webView, lifecycle).apply {
       consolePipe = object : ConsolePipe {
         override fun post(message: String) {
-          Log.d("[console.log]", message)
+          Logger.d("[console.log]") { message }
         }
       }
 
@@ -110,17 +117,17 @@ class MainActivity :
 
   private fun createWebViewClient() = object : WebViewClient() {
     override fun onPageStarted(view: WebView?, url: String?, favicon: android.graphics.Bitmap?) {
-      Log.d(TAG, "onPageStarted")
+      Logger.d(TAG) { "onPageStarted" }
     }
 
     override fun onPageFinished(view: WebView?, url: String?) {
-      Log.d(TAG, "onPageFinished")
+      Logger.d(TAG) { "onPageFinished" }
     }
   }
 
   private fun createDeviceLoadHandler() = object : MessageHandler<Map<String, String>, Any> {
     override fun handle(parameter: Map<String, String>): Any {
-      Log.d(TAG, "DeviceLoadJavascriptSuccess, $parameter")
+      Logger.d(TAG) { "DeviceLoadJavascriptSuccess, $parameter" }
       return mapOf("result" to "Android")
     }
   }
@@ -151,7 +158,7 @@ class MainActivity :
       Person("Wukong", 23),
       object : Callback<Any> {
         override fun onResult(result: Any) {
-          Log.d(TAG, "$handlerName, $result")
+          Logger.d(TAG) { "$handlerName, $result" }
         }
       },
     )

library/consumer-rules.pro

@@ -1,10 +1,2 @@
-# This will strip `Log.v`, `Log.d`, and `Log.i` statements and will leave `Log.w` and `Log.e` statements intact.
--assumenosideeffects class android.util.Log {
-  public static boolean isLoggable(java.lang.String, int);
-  public static int v(...);
-  public static int d(...);
-  public static int i(...);
-}
-
 -keep class java.lang.reflect.** { *; }
 -keep class kotlin.reflect.** { *; }

library/src/main/java/com/ding1ding/jsbridge/JsonUtils.kt

@@ -1,6 +1,5 @@
 package com.ding1ding.jsbridge
 
-import android.util.Log
 import java.math.BigInteger
 import java.text.SimpleDateFormat
 import java.util.Date
@@ -31,7 +30,7 @@ object JsonUtils {
           field.name to field.get(any)
         }.toJsonObject().toString()
     } catch (e: Exception) {
-      Log.e("[JsBridge]", "Failed to serialize object of type ${any::class.java.simpleName}", e)
+      Logger.e(e) { "Failed to serialize object of type ${any::class.java.simpleName}" }
       JSONObject.quote(any.toString())
     }
   }
@@ -68,7 +67,7 @@ object JsonUtils {
       else -> parseNumber(json)
     }
   } catch (e: Exception) {
-    Log.e("[JsBridge]", "Error parsing JSON: $json", e)
+    Logger.e(e) { "Error parsing JSON: $json" }
     json // Return the original string if parsing fails
   }
 

library/src/main/java/com/ding1ding/jsbridge/Logger.kt

@@ -0,0 +1,77 @@
+package com.ding1ding.jsbridge
+
+import android.util.Log
+import kotlin.math.min
+
+object Logger {
+  private const val MAX_LOG_LENGTH = 4000
+  const val DEFAULT_TAG = "WebViewJsBridge"
+
+  @Volatile
+  var logLevel = LogLevel.INFO
+
+  enum class LogLevel { VERBOSE, DEBUG, INFO, WARN, ERROR, NONE }
+
+  @JvmStatic
+  inline fun v(tag: String = DEFAULT_TAG, message: () -> String) =
+    log(LogLevel.VERBOSE, tag, message)
+
+  @JvmStatic
+  inline fun d(tag: String = DEFAULT_TAG, message: () -> String) = log(LogLevel.DEBUG, tag, message)
+
+  @JvmStatic
+  inline fun i(tag: String = DEFAULT_TAG, message: () -> String) = log(LogLevel.INFO, tag, message)
+
+  @JvmStatic
+  inline fun w(tag: String = DEFAULT_TAG, message: () -> String) = log(LogLevel.WARN, tag, message)
+
+  @JvmStatic
+  inline fun e(tag: String = DEFAULT_TAG, message: () -> String) = log(LogLevel.ERROR, tag, message)
+
+  @JvmStatic
+  inline fun e(throwable: Throwable, tag: String = DEFAULT_TAG, message: () -> String = { "" }) {
+    if (logLevel <= LogLevel.ERROR) {
+      val fullMessage = buildString {
+        append(message())
+        if (isNotEmpty() && message().isNotEmpty()) append(": ")
+        append(Log.getStackTraceString(throwable))
+      }
+      logInternal(Log.ERROR, tag, fullMessage)
+    }
+  }
+
+  @JvmStatic
+  inline fun log(level: LogLevel, tag: String = DEFAULT_TAG, message: () -> String) {
+    if (logLevel <= level) logInternal(level.toAndroidLogLevel(), tag, message())
+  }
+
+  fun logInternal(priority: Int, tag: String, message: String) {
+    if (message.length < MAX_LOG_LENGTH) {
+      Log.println(priority, tag, message)
+      return
+    }
+
+    var i = 0
+    val length = message.length
+    while (i < length) {
+      var newline = message.indexOf('\n', i)
+      newline = if (newline != -1) newline else length
+      do {
+        val end = min(newline, i + MAX_LOG_LENGTH)
+        val part = message.substring(i, end)
+        Log.println(priority, tag, part)
+        i = end
+      } while (i < newline)
+      i++
+    }
+  }
+
+  fun LogLevel.toAndroidLogLevel() = when (this) {
+    LogLevel.VERBOSE -> Log.VERBOSE
+    LogLevel.DEBUG -> Log.DEBUG
+    LogLevel.INFO -> Log.INFO
+    LogLevel.WARN -> Log.WARN
+    LogLevel.ERROR -> Log.ERROR
+    LogLevel.NONE -> Log.ASSERT
+  }
+}

library/src/main/java/com/ding1ding/jsbridge/MessageHandler.kt

@@ -1,5 +1,5 @@
 package com.ding1ding.jsbridge
 
-interface MessageHandler<in InputType, out OutputType> {
-  fun handle(parameter: InputType): OutputType
+interface MessageHandler<in Input, out Output> {
+  fun handle(parameter: Input): Output
 }

library/src/main/java/com/ding1ding/jsbridge/MessageSerializer.kt

@@ -1,6 +1,5 @@
 package com.ding1ding.jsbridge
 
-import android.util.Log
 import java.lang.reflect.ParameterizedType
 import java.lang.reflect.Type
 import org.json.JSONObject
@@ -95,7 +94,7 @@ object MessageSerializer {
       )
     }
   } catch (e: Exception) {
-    Log.e("[JsBridge]", "Error deserializing message: ${e.message}")
+    Logger.e(e) { "Error deserializing message: ${e.message}" }
     ResponseMessage(null, null, null, null, null)
   }
 
@@ -131,7 +130,7 @@ object MessageSerializer {
         constructor.isAccessible = true
         constructor.newInstance(*data.values.toTypedArray())
       } catch (e: Exception) {
-        Log.e("[JsBridge]", "Error creating instance of ${clazz.simpleName}: ${e.message}")
+        Logger.e(e) { "Error creating instance of ${clazz.simpleName}: ${e.message}" }
         data
       }
     }