项目地址：https://github.com/miqt/android-plugin/blob/master/plugin/hook-method-plugin/readme.md

这是一个 android 方法字节码插桩hook的插件，在方法进入和方法退出时，将当前运行的所有参数回调到固定的接口中，利用这一点，可以进行方法切片式开发，通过配置Hook点，达到Hook监控的目的。

利用这个插件，可以实现：

1. Android 全埋点，页面浏览，点击，等无痕埋点，按需配置Hook点即可，配置方法见下文
2. Android 方法耗时，性能统计
3. 各种拦截器，例如，拦截某方法，在某方法执行前，先判断权限或进行准备工作
4. 在引用的第三方jar包中追加代码，增加创建线程，文件IO相关的监控等

效果展示

例如日常开发中，我们免不了可能要进行一些点击事件埋点的任务，如果我们利用这个插件，可以直接配置一次统计所有的点击事件埋点，下面来看一下具体做法：

1. 先定义Hook点，这个hook点的目标是监控所有的点击事件。在 app module 中的 build.gradle 添加以下代码，详细字段含义会在下文说明。

apply plugin: 'com.miqt.plugin.hookmethod'
hook_method {
    buildLog = true
    injectJar = false //是否hook引用的第三方jar包
    enable = true
    hookTargets {
        hook_onclick { // <-- 定义Hook点
            interfaces = "android/view/View\$OnClickListener"//<-- hook条件1，继承了这个接口
            methodName = "onClick"                          //<-- hook条件2，方法名
            descriptor = "(Landroid/view/View;)V"           //<-- hook条件3，方法参数和返回值类型
            hookTiming = "Enter"                            //<-- hook条件4，指定是在方法进入时进行Hook
        }
    }
}

hook_method 是对插件的整体配置，hookTargets 是Hook点位的配置，编译时，会按照定义的筛选条件来进行筛选，四个条件同时满足，才会进行插桩。

注意，这里由于是字节码操作，因此这里的descriptor定义都是字段描述符，和字节码描述符，不知道的可以百度了解下，非常简单。如果你不想了解也没事，我后面有介绍有一种方法可以直接查看某个方法的字节码信息。利用@HookInfo注解

进行过以上配置后，我们随便写一个按钮，然后添加个点击事件。

public class MainActivity extends Activity {
    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        findViewById(R.id.button).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Toast.makeText(MainActivity.this, "onClick", Toast.LENGTH_SHORT).show();
            }
        });
    }
}

点击同步按钮，编译一下项目，这时候，插件就会自动生成该点击事件的hook转发handler处理类：

类似这样的：HookHandler

这时候我们打开Apk反编译查看，就可以看到插桩代码了：

public class MainActivity extends Activity {
    /* access modifiers changed from: protected */
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        findViewById(R.id.button).setOnClickListener(new View.OnClickListener() {
            /* class com.asm.code.MainActivity.AnonymousClass1 */

            public void onClick(View view) {
                HookHandler.hook_onclickEnter(this, "com/asm/code/MainActivity$1", "onClick", "[android.view.View]", "void", new Object[]{view});//<--插桩的代码
                Toast.makeText(MainActivity.this, "onClick", 0).show();
            }
        });
    }
}

到了这里，我们只需要在hook_onclickEnter这个方法中编写全局点击事件监控处理逻辑就可以了，所有的这一切都是插件自动完成的哦，我们只需要配置Hook规则就可以了，是不是非常简单。

示例配置传送门：https://github.com/miqt/android-plugin/blob/master/app/build.gradle

以此类推，该插件还可以通过自定义Hook规则，Hook项目中的任意方法的代码，达到切面编程的目的。

使用配置方法

1. 添加maven仓库

   maven { url 'https://raw.githubusercontent.com/miqt/maven/master' }
   maven { url 'https://gitee.com/miqt/maven/raw/master' }
   

   还拉取不到库？

   maven { url 'https://raw.fastgit.org/miqt/maven/master' }
   

   或者，去我的仓库git地址下载下来，本地依赖。

   最开始我使用 jcenter() ，结果后来这个库官方弃用了，不过现在 0.3.5版本 仍然可以从这个库上拉取下来，之后版本我都使用gitee和github作为仓库存储地址了。

2. 添加插件依赖

   项目根目录：build.gradle 添加以下代码

   dependencies {
       classpath 'com.miqt:hook-method-plugin:0.4.0'
   }
   

   对应 module 中启用插件，可以是application也可以是library

   apply plugin: 'com.miqt.plugin.hookmethod'
   hook_method {
       buildLog = true
       injectJar = false //是否hook引用的第三方jar包
       enable = true
       hookTargets {
           hook_onclick { // <-- 自定义Hook点
               interfaces = "android/view/View\$OnClickListener"//<-- hook条件1，继承了这个接口
               methodName = "onClick"                          //<-- hook条件2，方法名
               descriptor = "(Landroid/view/View;)V"           //<-- hook条件3，方法参数和返回值类型
               hookTiming = "Enter"                            //<-- hook条件4，指定是在方法进入时进行Hook
           }
       }
   }
   

3. 对应 module 中添加类库依赖

   dependencies {
       implementation 'com.miqt:hook-method-lib:0.4.0'
   }
   

   项目 clean 然后运行，logcat 过滤 MethodHookHandler 就可以看到打印结果啦！

插件配置参数说明

hook_method {} 中的参数

这个里面是定义插件相关的配置。

hookTargets {} 中的参数

结构：

hook_method {
    hookTargets {
        name1 {
            条件1 = value1
            条件2 = value2
            条件3 = value3
        }
        name2 {
            条件1 = value1
            条件2 = value2
            条件3 = value3
        }
    }
}

这里是定义hood点位筛选条件的，逻辑是，必须满足参数 1，2，3设置的条件，才会插桩

注意：如果设置：hook_All{ } 这种无条件参数的，意思就是所有的方法都插桩。

内置注解

@HookInfo： 输出对应字节码限制条件信息
@HookMethod： 标记hook方法，不需要写hookTargets，可以理解为内置的
@HookMethodInherited： 标记hook方法，有类继承性，不需要写hookTargets，可以理解为内置的
@IgnoreMethodHook： 标记忽略方法，优先级最高

读都读到这里了，帮我点个star吧，你的肯定是我持续维护的动力！

如果有使用问题欢迎提交Issues ，或者加我微信一起交流，微信号在我的主页。

致谢

这个插件是借鉴了很多大佬的代码，并结合自己的想法进行了一些调整，在此感谢他们付出的努力。

https://github.com/novoda/bintray-release
https://github.com/JeasonWong/CostTime
https://github.com/MegatronKing/StringFog