Add rich logging api

Author: Dr-TSNG

api/build.gradle.kts

@@ -6,16 +6,16 @@ plugins {
 
 android {
     namespace = "io.github.libxposed.api"
-    compileSdk = 35
+    compileSdk = 36
     buildToolsVersion = "35.0.0"
+    androidResources.enable = false
 
     defaultConfig {
         minSdk = 24
         consumerProguardFiles("proguard-rules.pro")
     }
 
     buildFeatures {
-        androidResources = false
         buildConfig = false
     }
 

api/src/main/java/io/github/libxposed/api/XposedInterface.java

@@ -464,16 +464,31 @@ interface MethodUnhooker<T> {
     /**
      * Writes a message to the Xposed log.
      *
+     * @param priority The log priority, see {@link android.util.Log}
+     * @param tag      The log tag
+     * @param msg      The log message
+     * @param tr       An exception to log
+     */
+    void log(int priority, @Nullable String tag, @NonNull String msg, @Nullable Throwable tr);
+
+    /**
+     * Writes a message to the Xposed log.
+     * @deprecated Use {@link #log(int, String, String, Throwable)} instead.
+     * This method is kept for compatibility with old hooker classes and will be removed in first release version.
+     *
      * @param message The log message
      */
+    @Deprecated
     void log(@NonNull String message);
 
     /**
      * Writes a message with a stack trace to the Xposed log.
+     * @deprecated Use {@link #log(int, String, String, Throwable)} instead.
      *
      * @param message   The log message
      * @param throwable The Throwable object for the stack trace
      */
+    @Deprecated
     void log(@NonNull String message, @NonNull Throwable throwable);
 
     /**

api/src/main/java/io/github/libxposed/api/XposedInterfaceWrapper.java

@@ -129,6 +129,11 @@ public final <T, U> U newInstanceSpecial(@NonNull Constructor<T> constructor, @N
         return mBase.newInstanceSpecial(constructor, subClass, args);
     }
 
+    @Override
+    public final void log(int priority, @Nullable String tag, @NonNull String msg, @Nullable Throwable tr) {
+        mBase.log(priority, tag, msg, tr);
+    }
+
     @Override
     public final void log(@NonNull String message) {
         mBase.log(message);

gradle/libs.versions.toml

@@ -1,8 +1,8 @@
 [versions]
-annotation = "1.8.0"
-kotlin = "2.0.0"
-lint = "31.5.1"
-agp = "8.5.1"
+annotation = "1.9.1"
+kotlin = "2.3.10"
+lint = "32.0.1"
+agp = "9.0.1"
 
 [plugins]
 kotlin = { id = "org.jetbrains.kotlin.jvm", version.ref = "kotlin" }
@@ -13,4 +13,3 @@ annotation = { module = "androidx.annotation:annotation", version.ref = "annotat
 lint-api = { module = "com.android.tools.lint:lint-api", version.ref = "lint" }
 lint-checks = { module = "com.android.tools.lint:lint-checks", version.ref = "lint" }
 kotlin-stdlib = { module = "org.jetbrains.kotlin:kotlin-stdlib", version.ref = "kotlin" }
-

gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.10-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.3.1-bin.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME