Assassin

Assassin是由美柚出品的一个小巧、方便但功能强大的Android切片库。

什么是Assassin

Assassin意为刺客。

它能帮助你将原本的一个类或者一个方法甚至一个属性进行修改、替换、拦截，实现Java级别的开放插桩切片。

Assassin通过编译期的插桩替换操作来达到dex修改的能力。

通过Assassin框架，你可以实现热补丁、自动化、无痕埋点等一系列在Java运行期无法完成的工作。

Assassin不需要注解，不需要繁琐的配置，不需要学习成本。

举个栗子

比如，有人写了个类叫做Class A，里面有个方法叫Method A1，在App初始化过程中必然会调用这个Method A1，结果你发现Method A1这个方法实现的逻辑满足不了需求，或者他写的有bug，又或者你想加几行代码，又或者你想在App初始化过程中跳过Method A1不执行它，传统的做法是你跑到那个人旁边来跟他说：MD，你写的方法有bug！赶紧给我改了。

但是如果这个时候这个人不在呢？又或者这个方法是第三方提供的，而且它是不能被继承重写覆盖的，那么怎么办呢？

这时候你只需要写个Method B，通过Assassin你就可以直接将你写的Method B替换这个Method A1，让他在App初始化过程中不执行A1，而执行你的Method B，甚至你可以控制是否执行Method A，甚至可以执行完Method A，再执行你的Method B，执行完B再执行A。

通过Assassin，不光是Method A1，整个Class A我都能替换。只要你开心。

或者是你想统计所有方法的耗时，你只需要一行代码，通过Assassin就可以轻松完成插桩。

或者是你想监听某些方法的执行，你想他们被执行的时候告诉你，通过Assassin你也可以做到。

或者你想给所有方法执行的时候都弹一个toast。

Assassin可以完成你当前做不到的事情。

衍生物

无痕埋点、热补丁、自动化、插桩等等都可以通过Assassin实现

使用方法

添加插件

在主工程的build.gradle中加入

classpath 'com.meiyou.aop:assassin-compiler:0.0.18-SNAPSHOT'。

在你的工程中加入插件和依赖

apply plugin: 'assassin'


compile 'com.meiyou.aop:assassin:0.0.2-SNAPSHOT'

创建替换方法

随便找个地方写个类，实现IAssassinDelegate这个接口，并在里面写上你的方法，再在class中注解@AntiAssassin。

@AntiAssassin
public class TestDelegate extends IAssassinDelegate{
//...
//你的方法体，Assassin会把当前对象，以及执行方法的名字，入参变量，返回值类型全部给你

    public void onMethodEnd(Object obj, String name, Object[] objects, String rtype){

    }

    public Object onMethodEnter(Object obj, String name, Object[] objects, String rtype){
        return null;
    }

}

@AntiAssassin注解的意思是该类不允许被Assassin。

配置到Assassin替换规则

在工程内创建规则配置文件，命名为assassin.pro

在里面声明插入或者是替换的方法名并定义你的替换方法位置坐标

-insert method{
#   com.meetyou.aop.assassin.MainActivity*onCreate;
  **.all;
#  *.<init>;
#  *.onClick;
}

-replace method{
#  *.show;
}

-receiver {
  com.meetyou.aop.assassin.TestDelegate;
}

完成编译

这时候重新编译或者运行就可以发现你的代码被插入了

逻辑图

替换方法Replace

虚线为原本执行的方法路线，实线为Assassin之后的方法路线。

插入方法Insert