build.gradle.kts

@@ -1,3 +1,3 @@
 tasks.register("Delete", Delete::class) {
-    delete(rootProject.layout.buildDirectory)
+    delete(rootProject.buildDir)
 }

gradle/wrapper/gradle-wrapper.properties

@@ -1,7 +1,7 @@
+#Sun May 21 15:48:52 CST 2023
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.1.1-bin.zip
 networkTimeout=10000
-validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists

gradlew

@@ -83,8 +83,10 @@ done
 # This is normally unused
 # shellcheck disable=SC2034
 APP_BASE_NAME=${0##*/}
-# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)
+APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit
-APP_HOME=$( cd "${APP_HOME:-./}" > /dev/null && pwd -P ) || exit
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
 
 # Use the maximum available, or set MAX_FD != -1 to use that value.
 MAX_FD=maximum
@@ -131,13 +133,10 @@ location of your Java installation."
     fi
 else
     JAVACMD=java
-    if ! command -v java >/dev/null 2>&1
+    which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
-    then
-        die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
 
 Please set the JAVA_HOME variable in your environment to match the
 location of your Java installation."
-    fi
 fi
 
 # Increase the maximum file descriptors if we can.
@@ -145,7 +144,7 @@ if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
     case $MAX_FD in #(
       max*)
         # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
-        # shellcheck disable=SC2039,SC3045
+        # shellcheck disable=SC3045 
         MAX_FD=$( ulimit -H -n ) ||
             warn "Could not query maximum file descriptor limit"
     esac
@@ -153,7 +152,7 @@ if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
       '' | soft) :;; #(
       *)
         # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
-        # shellcheck disable=SC2039,SC3045
+        # shellcheck disable=SC3045 
         ulimit -n "$MAX_FD" ||
             warn "Could not set maximum file descriptor limit to $MAX_FD"
     esac
@@ -198,15 +197,11 @@ if "$cygwin" || "$msys" ; then
     done
 fi
 
-
+# Collect all arguments for the java command;
-# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+#   * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of
-DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+#     shell script including quotes and variable substitutions, so put them in
-
+#     double quotes to make sure that they get re-expanded; and
-# Collect all arguments for the java command:
+#   * put everything else in single quotes, so that it's not re-expanded.
-#   * DEFAULT_JVM_OPTS, JAVA_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
-#     and any embedded shellness will be escaped.
-#   * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be
-#     treated as '${Hostname}' itself on the command line.
 
 set -- \
         "-Dorg.gradle.appname=$APP_BASE_NAME" \

interface/build.gradle.kts

@@ -6,11 +6,11 @@ plugins {
 
 android {
     namespace = "io.github.libxposed.service"
-    compileSdk = 34
+    compileSdk = 33
-    buildToolsVersion = "34.0.0"
+    buildToolsVersion = "33.0.1"
 
     defaultConfig {
-        minSdk = 24
+        minSdk = 21
     }
 
     buildFeatures {
@@ -20,8 +20,8 @@ android {
     }
 
     compileOptions {
-        targetCompatibility = JavaVersion.VERSION_21
+        targetCompatibility = JavaVersion.VERSION_1_8
-        sourceCompatibility = JavaVersion.VERSION_21
+        sourceCompatibility = JavaVersion.VERSION_1_8
     }
 
     publishing {

interface/src/main/aidl/io/github/libxposed/service/IXposedService.aidl

@@ -2,12 +2,7 @@ package io.github.libxposed.service;
 import io.github.libxposed.service.IXposedScopeCallback;
 
 interface IXposedService {
-    const int LIB_API = 101;
+    const int API = 100;
-    const int API = LIB_API; // compatibility alias
-
-    const long PROP_CAP_SYSTEM = 1L;
-    const long PROP_CAP_REMOTE = 1L << 1;
-    const long PROP_RT_API_PROTECTION = 1L << 2;
 
     const int FRAMEWORK_PRIVILEGE_ROOT = 0;
     const int FRAMEWORK_PRIVILEGE_CONTAINER = 1;
@@ -23,7 +18,7 @@ interface IXposedService {
     String getFrameworkVersion() = 3;
     long getFrameworkVersionCode() = 4;
     int getFrameworkPrivilege() = 5;
-    long getFrameworkProperties() = 6;
+    Bundle featuredMethod(String name, in Bundle args) = 6;
 
     // scope utilities
     List<String> getScope() = 10;
@@ -36,7 +31,7 @@ interface IXposedService {
     void deleteRemotePreferences(String group) = 22;
 
     // remote file utilities
-    String[] listRemoteFiles() = 30;
+    ParcelFileDescriptor openRemoteFile(String path, int mode) = 30;
-    ParcelFileDescriptor openRemoteFile(String name) = 31;
+    boolean deleteRemoteFile(String path) = 31;
-    boolean deleteRemoteFile(String name) = 32;
+    String[] listRemoteFiles() = 32;
 }

service/build.gradle.kts

@@ -6,11 +6,11 @@ plugins {
 
 android {
     namespace = "io.github.libxposed.service"
-    compileSdk = 34
+    compileSdk = 33
-    buildToolsVersion = "34.0.0"
+    buildToolsVersion = "33.0.1"
 
     defaultConfig {
-        minSdk = 24
+        minSdk = 21
     }
 
     buildFeatures {
@@ -18,9 +18,16 @@ android {
         resValues = false
     }
 
+    buildTypes {
+        release {
+            isMinifyEnabled = true
+        }
+    }
+
     compileOptions {
-        sourceCompatibility = JavaVersion.VERSION_21
+        isCoreLibraryDesugaringEnabled = true
-        targetCompatibility = JavaVersion.VERSION_21
+        sourceCompatibility = JavaVersion.VERSION_11
+        targetCompatibility = JavaVersion.VERSION_11
     }
 
     publishing {
@@ -33,7 +40,8 @@ android {
 
 dependencies {
     implementation(project(":interface"))
-    compileOnly("androidx.annotation:annotation:1.7.1")
+    compileOnly("androidx.annotation:annotation:1.6.0")
+    coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:2.0.3")
 }
 
 publishing {

service/src/main/AndroidManifest.xml

@@ -1,11 +0,0 @@
-<manifest xmlns:android="http://schemas.android.com/apk/res/android"
-    xmlns:tools="http://schemas.android.com/tools">
-
-    <application>
-        <provider
-            android:name=".XposedProvider"
-            android:authorities="${applicationId}.XposedService"
-            android:exported="true"
-            tools:ignore="ExportedContentProvider" />
-    </application>
-</manifest>

service/src/main/java/io/github/libxposed/service/XposedService.java

@@ -1,27 +1,28 @@
 package io.github.libxposed.service;
 
+import static android.os.ParcelFileDescriptor.MODE_READ_ONLY;
+
 import android.content.SharedPreferences;
-import android.os.ParcelFileDescriptor;
+import android.os.Bundle;
 import android.os.RemoteException;
 
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 
+import java.io.FileInputStream;
+import java.io.FileNotFoundException;
+import java.io.FileOutputStream;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
 import java.util.WeakHashMap;
 import java.util.concurrent.locks.ReentrantReadWriteLock;
 
-@SuppressWarnings("unused")
+@SuppressWarnings({"resource", "unused"})
 public final class XposedService {
 
     public final static class ServiceException extends RuntimeException {
-        ServiceException(String message) {
+        private ServiceException(RemoteException e) {
-            super(message);
-        }
-
-        ServiceException(RemoteException e) {
             super("Xposed service error", e);
         }
     }
@@ -147,7 +148,7 @@ public final class XposedService {
      * Get the Xposed API version of current implementation.
      *
      * @return API version
-     * @throws ServiceException If the service is dead or an error occurred
+     * @throws ServiceException If the service is dead or error occurred
      */
     public int getAPIVersion() {
         try {
@@ -161,7 +162,7 @@ public final class XposedService {
      * Get the Xposed framework name of current implementation.
      *
      * @return Framework name
-     * @throws ServiceException If the service is dead or an error occurred
+     * @throws ServiceException If the service is dead or error occurred
      */
     @NonNull
     public String getFrameworkName() {
@@ -176,7 +177,7 @@ public final class XposedService {
      * Get the Xposed framework version of current implementation.
      *
      * @return Framework version
-     * @throws ServiceException If the service is dead or an error occurred
+     * @throws ServiceException If the service is dead or error occurred
      */
     @NonNull
     public String getFrameworkVersion() {
@@ -191,7 +192,7 @@ public final class XposedService {
      * Get the Xposed framework version code of current implementation.
      *
      * @return Framework version code
-     * @throws ServiceException If the service is dead or an error occurred
+     * @throws ServiceException If the service is dead or error occurred
      */
     public long getFrameworkVersionCode() {
         try {
@@ -201,25 +202,11 @@ public final class XposedService {
         }
     }
 
-    /**
-     * Get the Xposed framework properties of current implementation.
-     *
-     * @return Framework properties bitmask
-     * @throws ServiceException If the service is dead or an error occurred
-     */
-    public long getFrameworkProperties() {
-        try {
-            return mService.getFrameworkProperties();
-        } catch (RemoteException e) {
-            throw new ServiceException(e);
-        }
-    }
-
     /**
      * Get the Xposed framework privilege of current implementation.
      *
      * @return Framework privilege
-     * @throws ServiceException If the service is dead or an error occurred
+     * @throws ServiceException If the service is dead or error occurred
      */
     @NonNull
     public Privilege getFrameworkPrivilege() {
@@ -231,11 +218,32 @@ public final class XposedService {
         }
     }
 
+    /**
+     * Additional methods provided by specific Xposed framework.
+     *
+     * @param name Featured method name
+     * @param args Featured method arguments
+     * @return Featured method result
+     * @throws UnsupportedOperationException If the framework does not provide a method with given name
+     * @throws ServiceException              If the service is dead or error occurred
+     * @deprecated Normally, modules should never rely on implementation details about the Xposed framework,
+     * but if really necessary, this method can be used to acquire such information
+     */
+    @Deprecated
+    @Nullable
+    public Bundle featuredMethod(@NonNull String name, @Nullable Bundle args) {
+        try {
+            return mService.featuredMethod(name, args);
+        } catch (RemoteException e) {
+            throw new ServiceException(e);
+        }
+    }
+
     /**
      * Get the application scope of current module.
      *
      * @return Module scope
-     * @throws ServiceException If the service is dead or an error occurred
+     * @throws ServiceException If the service is dead or error occurred
      */
     @NonNull
     public List<String> getScope() {
@@ -251,7 +259,7 @@ public final class XposedService {
      *
      * @param packageName Package name of the app to be added
      * @param callback    Callback to be invoked when the request is completed or error occurred
-     * @throws ServiceException If the service is dead or an error occurred
+     * @throws ServiceException If the service is dead or error occurred
      */
     public void requestScope(@NonNull String packageName, @NonNull OnScopeEventListener callback) {
         try {
@@ -266,7 +274,7 @@ public final class XposedService {
      *
      * @param packageName Package name of the app to be added
      * @return null if successful, or non-null with error message
-     * @throws ServiceException If the service is dead or an error occurred
+     * @throws ServiceException If the service is dead or error occurred
      */
     @Nullable
     public String removeScope(@NonNull String packageName) {
@@ -278,26 +286,18 @@ public final class XposedService {
     }
 
     /**
-     * Get remote preferences from Xposed framework. If the group does not exist, it will be created.
+     * Get remote preferences from Xposed framework.
      *
      * @param group Group name
-     * @return The preferences
+     * @return The preferences, null if the framework is embedded
-     * @throws ServiceException              If the service is dead or an error occurred
+     * @throws ServiceException If the service is dead or error occurred
-     * @throws UnsupportedOperationException If the framework is embedded
      */
-    @NonNull
+    @Nullable
     public SharedPreferences getRemotePreferences(@NonNull String group) {
         return mRemotePrefs.computeIfAbsent(group, k -> {
             try {
-                var instance = RemotePreferences.newInstance(this, k);
+                return RemotePreferences.newInstance(this, k);
-                if (instance == null) {
-                    throw new ServiceException("Framework returns null");
-                }
-                return instance;
             } catch (RemoteException e) {
-                if (e.getCause() instanceof UnsupportedOperationException cause) {
-                    throw cause;
-                }
                 throw new ServiceException(e);
             }
         });
@@ -307,8 +307,7 @@ public final class XposedService {
      * Delete a group of remote preferences.
      *
      * @param group Group name
-     * @throws ServiceException              If the service is dead or an error occurred
+     * @throws ServiceException If the service is dead or error occurred
-     * @throws UnsupportedOperationException If the framework is embedded
      */
     public void deleteRemotePreferences(@NonNull String group) {
         deletionLock.writeLock().lock();
@@ -319,9 +318,6 @@ public final class XposedService {
                 return null;
             });
         } catch (RemoteException e) {
-            if (e.getCause() instanceof UnsupportedOperationException cause) {
-                throw cause;
-            }
             throw new ServiceException(e);
         } finally {
             deletionLock.writeLock().unlock();
@@ -329,45 +325,39 @@ public final class XposedService {
     }
 
     /**
-     * List all files in the module's shared data directory.
+     * Open an InputStream to read a file from the module's shared data directory.
      *
-     * @return The file list
+     * @param name File name, must not contain path separators and . or ..
-     * @throws ServiceException              If the service is dead or an error occurred
+     * @return The InputStream
-     * @throws UnsupportedOperationException If the framework is embedded
+     * @throws FileNotFoundException If the file does not exist, the path is forbidden or remote file is not supported by the framework
      */
     @NonNull
-    public String[] listRemoteFiles() {
+    public FileInputStream openRemoteFileInput(@NonNull String name) throws FileNotFoundException {
         try {
-            var files = mService.listRemoteFiles();
+            var file = mService.openRemoteFile(name, MODE_READ_ONLY);
-            if (files == null) throw new ServiceException("Framework returns null");
+            if (file == null) throw new FileNotFoundException();
-            return files;
+            return new FileInputStream(file.getFileDescriptor());
         } catch (RemoteException e) {
-            if (e.getCause() instanceof UnsupportedOperationException cause) {
+            throw new FileNotFoundException(e.getMessage());
-                throw cause;
-            }
-            throw new ServiceException(e);
         }
     }
 
     /**
-     * Open a file in the module's shared data directory. The file will be created if not exists.
+     * Open an OutputStream to write a file to the module's shared data directory.
      *
      * @param name File name, must not contain path separators and . or ..
-     * @return The file descriptor
+     * @param mode Operating mode
-     * @throws ServiceException              If the service is dead or an error occurred
+     * @return The OutputStream
-     * @throws UnsupportedOperationException If the framework is embedded
+     * @throws FileNotFoundException If the path is forbidden or remote file is not supported by the framework
      */
     @NonNull
-    public ParcelFileDescriptor openRemoteFile(@NonNull String name) {
+    public FileOutputStream openRemoteFileOutput(@NonNull String name, int mode) throws FileNotFoundException {
         try {
-            var file = mService.openRemoteFile(name);
+            var file = mService.openRemoteFile(name, mode);
-            if (file == null) throw new ServiceException("Framework returns null");
+            if (file == null) throw new FileNotFoundException();
-            return file;
+            return new FileOutputStream(file.getFileDescriptor());
         } catch (RemoteException e) {
-            if (e.getCause() instanceof UnsupportedOperationException cause) {
+            throw new FileNotFoundException(e.getMessage());
-                throw cause;
-            }
-            throw new ServiceException(e);
         }
     }
 
@@ -376,17 +366,30 @@ public final class XposedService {
      *
      * @param name File name, must not contain path separators and . or ..
      * @return true if successful, false if the file does not exist
-     * @throws ServiceException              If the service is dead or an error occurred
+     * @throws FileNotFoundException If the path is forbidden or remote file is not supported by the framework
-     * @throws UnsupportedOperationException If the framework is embedded
      */
-    public boolean deleteRemoteFile(@NonNull String name) {
+    public boolean deleteRemoteFile(@NonNull String name) throws FileNotFoundException {
         try {
             return mService.deleteRemoteFile(name);
         } catch (RemoteException e) {
-            if (e.getCause() instanceof UnsupportedOperationException cause) {
+            throw new FileNotFoundException(e.getMessage());
-                throw cause;
         }
-            throw new ServiceException(e);
+    }
+
+    /**
+     * List all files in the module's shared data directory.
+     *
+     * @return The file list
+     * @throws FileNotFoundException If remote file is not supported by the framework
+     */
+    @NonNull
+    public String[] listRemoteFiles() throws FileNotFoundException {
+        try {
+            var files = mService.listRemoteFiles();
+            if (files == null) throw new FileNotFoundException();
+            return files;
+        } catch (RemoteException e) {
+            throw new FileNotFoundException(e.getMessage());
         }
     }
 }

settings.gradle.kts

@@ -5,7 +5,7 @@ pluginManagement {
         mavenCentral()
     }
     plugins {
-        id("com.android.library") version "8.3.2"
+        id("com.android.library") version "8.0.1"
     }
 }