Android AOP 框架 Lancet 应用与解析

Android AOP 框架 Lancet 应用与解析

Lancet 是一个轻量级 Android AOP 框架。它可以用来替换某个方法的代码实现，或者在方法执行前后插入代码。

Lancet 应用举例

待修改的 MainActivity 如下：

public class MainActivity extends AppCompatActivity {

    private static final String TAG = "MainActivity";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        // onCreatelancet
        Log.i(TAG, "onCreate");
    }

}

假设需要在 MainActivity 的每一个 Log 日志之前都加上 “lancet” 后缀，可以使用 Lancet 的 @Proxy 注解。

public class HookClass {
    @Proxy("i")
    @TargetClass("android.util.Log")
    public static int anyName(String tag, String msg){
        msg = msg + "lancet";
        return (int) Origin.call();
    }
}

输出如下：

MainActivity: onCreatelancet

假设需要在 MainActivity 的 onStop 方法执行之前打印日志到标准输出，可以使用 Lancet 的 @Insert 注解。

public class HookClass {

    @TargetClass(value = "androidx.appcompat.app.AppCompatActivity", scope = Scope.LEAF)
    @Insert(value = "onStop", mayCreateSuper = true)
    protected void onStop() {
        System.out.println("hello onStop");
        Origin.callVoid();
    }

}

当 MainActivity 触发 onStop 时，输出如下：

System.out: hello onStop

Lancet 注入

使用 jadx-gui 工具反编译 apk，可以看出 MainActivity 注入了一个 _lancet 子类。

public class MainActivity extends AppCompatActivity {
    private static final String TAG = "MainActivity";

    class _lancet {
        private _lancet() {
        }

        @Proxy("i")
        @TargetClass("android.util.Log")
        static int cn_okclouder_lancet_use_HookClass_anyName(String str, String str2) {
            return Log.i(str, str2 + "lancet");
        }

        @TargetClass(scope = Scope.LEAF, value = "androidx.appcompat.app.AppCompatActivity")
        @Insert(mayCreateSuper = true, value = "onStop")
        static void cn_okclouder_lancet_use_HookClass_onStop(MainActivity mainActivity) {
            System.out.println("hello onStop");
            mainActivity.onStop$___twin___();
        }
    }

    /* access modifiers changed from: private */
    /* access modifiers changed from: public */
    private void onStop$___twin___() {
        super.onStop();
    }

    /* access modifiers changed from: protected */
    @Override // androidx.appcompat.app.AppCompatActivity, androidx.fragment.app.FragmentActivity
    public void onStop() {
        _lancet.cn_okclouder_lancet_use_HookClass_onStop(this);
    }

    /* access modifiers changed from: protected */
    @Override // androidx.core.app.ComponentActivity, androidx.appcompat.app.AppCompatActivity, androidx.fragment.app.FragmentActivity
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        _lancet.cn_okclouder_lancet_use_HookClass_anyName(TAG, "onCreate");
    }
}

_lancet 子类按照 HookClass 中定义的 anyName 和 onStop 方法生成了 2 个静态方法。

anyName 方法直接调用了 Log.i，只是改变了方法的第二个参数，即 message 参数，为 message 参数加上了 “lancet” 后缀。

onStop 方法首先输出 HookClass 中定义的 system.out，然后调用 MainActivity onStop 方法的 twin 方法。twin 方法是 MainActivity 默认的 onStop 方法。因为 @Insert 注解会改变原有的 onStop，直接在 _lancet 子类的 onStop 方法无法调用 MainActivity 的 super.onStop()，调用 MainActivity 的 onStop 会导致循环调用，因此使用了 twin 方法间接调用默认 onStop。

在 MainActivity 原有的调用 Log.i 和 onStop 方法的地方使用 _lancet 子类的静态方法替换，从而实现了 HookClass 定义的代码替换。