How to migrate an app

Author: neboskreb

examples/migration-app/build.gradle

@@ -47,4 +47,11 @@ android {
 dependencies {
     implementation(project(":examples:migration-lib"))
     implementation 'androidx.core:core-ktx:1.17.0'
+
+    implementation 'io.github.neboskreb:android-log4j2-migration:2.0'
+    implementation 'io.github.neboskreb:android-log4j2:2.24'
+    // Though android-log4j2 brings Log4J2 in as a transitive dependency,
+    // it is always a good idea to pin the exact version:
+    implementation 'org.apache.logging.log4j:log4j-core:2.24.3'
+    implementation 'org.apache.logging.log4j:log4j-slf4j2-impl:2.24.3'
 }

examples/migration-app/src/main/assets/log4j2.properties

@@ -0,0 +1,17 @@
+# Root Logger
+rootLogger = WARN, LOGCAT
+
+# Direct log messages to LOGCAT
+appender.logcat.type = Logcat
+appender.logcat.name = LOGCAT
+appender.logcat.layout.type = PatternLayout
+appender.logcat.layout.pattern = %m%n
+#appender.logcat.stack-trace-rendering = log4j
+appender.logcat.stack-trace-rendering = logcat
+
+
+logger.lib.name = MY_LIBRARY
+logger.lib.level = warn
+
+logger.app.name = MAIN_ACTIVITY
+logger.app.level = all

examples/migration-app/src/main/kotlin/com/github/neboskreb/log4j2/examples/migration/App.kt

@@ -1,10 +1,19 @@
 package com.github.neboskreb.log4j2.examples.migration
 
 import android.app.Application
+import com.github.neboskreb.log4j2.migration.Log
+import net.loune.log4j2android.AndroidLog4jHelper
 
 class App : Application() {
+    // NOTE: This is optional.
+    // Force Log to invoke the Log4j calls directly, bypassing the SLF4J facade.
+    init {
+        Log.useLog4j2()
+    }
 
     override fun onCreate() {
         super.onCreate()
+
+        AndroidLog4jHelper.initialize(applicationContext)
     }
 }

examples/migration-app/src/main/kotlin/com/github/neboskreb/log4j2/examples/migration/MainActivity.kt

@@ -2,7 +2,7 @@ package com.github.neboskreb.log4j2.examples.migration
 
 import android.app.Activity
 import android.os.Bundle
-import android.util.Log
+import com.github.neboskreb.log4j2.migration.Log
 
 import com.github.neboskreb.log4j2.examples.migration.lib.MyLibrary