Dexposed:阿里巴巴开源的无侵入运行期 AOP 框架(Android)

fbwd 9年前

Dexposed:阿里巴巴开源的无侵入运行期 AOP 框架(Android)。

Dexposed is a powerful yet non-invasive runtime AOP (Aspect-oriented Programming) framework for Android app development, based on the work of open-source Xposed framework project.

The AOP of Dexposed is implemented purely non-invasive, without any annotation processor, weaver or bytecode rewriter. The integration is as simple as loading a small JNI library in just one line of code at the initialization phase of your app.

Not only the code of your app, but also the code of Android framework that running in your app process can be hooked. This feature is extremely useful in Android development as we developers heavily rely on the fragmented old versions of Android platform (SDK).

Together with dynamic class loading, a small piece of compiled Java AOP code can be loaded into the running app, effectively altering the behavior of the target app without restart.

Typical use-cases

  • Classic AOP programming
  • Instrumentation (for testing, performance monitoring and etc.)
  • Online hot patch to fix critical, emergent or security bugs
  • SDK hooking for a better development experience

Integration

Directly add jar and two so files from dexposed and dexposedbridge to your project as compile libraries.

Gradle dependency like following:

native_dependencies {      artifact 'com.taobao.dexposed:dexposed_l:0.2+:armeabi'      artifact 'com.taobao.dexposed:dexposed:0.2+:armeabi'  }  dependencies {      compile files('libs/dexposedbridge.jar')  }

Insert the following line into the initialization phase of your app, as early as possible:

public class MyApplication extends Application {        @Override public void onCreate() {                  // Check whether current device is supported (also initialize Dexposed framework if not yet)          if (DexposedBridge.canDexposed(this)) {              // Use Dexposed to kick off AOP stuffs.              ...          }      }      ...  }

It's done.

Basic usage

There are three injection points for a given method: before, after, replace.

Example 1: Attach a piece of code before and after all occurrences ofActivity.onCreate(Bundle).

// Target class, method with parameter types, followed by the hook callback (XC_MethodHook).      DexposedBridge.findAndHookMethod(Activity.class, "onCreate", Bundle.class, new XC_MethodHook() {            // To be invoked before Activity.onCreate().          @Override protected void beforeHookedMethod(MethodHookParam param) throws Throwable {              // "thisObject" keeps the reference to the instance of target class.              Activity instance = (Activity) param.thisObject;                // The array args include all the parameters.              Bundle bundle = (Bundle) param.args[0];              Intent intent = new Intent();              // XposedHelpers provide useful utility methods.              XposedHelpers.setObjectField(param.thisObject, "mIntent", intent);                // Calling setResult() will bypass the original method body use the result as method return value directly.              if (bundle.containsKey("return"))                  param.setResult(null);          }            // To be invoked after Activity.onCreate()          @Override protected void afterHookedMethod(MethodHookParam param) throws Throwable {              XposedHelpers.callMethod(param.thisObject, "sampleMethod", 2);          }      });

Example 2: Replace the original body of the target method.

DexposedBridge.findAndHookMethod(Activity.class, "onCreate", Bundle.class, new XC_MethodReplacement() {            @Override protected Object replaceHookedMethod(MethodHookParam param) throws Throwable {              // Re-writing the method logic outside the original method context is a bit tricky but still viable.              ...          }        });

Checkout theexampleproject to find out more.

项目主页:http://www.open-open.com/lib/view/home/1435762679388