一款非常简单易用的Android热修复框架 WandFix 使用详解 附实现原理

当你的项目已经上线，一个BUG被发现却已经为时已晚，这时候悔恨自责都已经于事无补，甚至还会被伙伴们打上不靠谱的标签，这时候你想不想像哈利波特一样，魔法杖一挥BUG瞬间消除？没错拿着WindFix你就可以实现这一点。

WandFix是一个基于java ClassLoader实现的热修复框架。

使用WandFix可以不再用 new 来创建对象，只需要对变量名添加注解即可实现对象的注入。而热修复功能的实现既是用对象注入的这种途径，通过更换热修复包替换实现类，来达到每次注入的对象都为最后改动过的，实现热修复的目的。当然，如果您不想使用热修复功能，只是想方便的注入对象，直接添加注解也是可以的，因为如果它在热修复包中没有找到对应的实现类的话，会尝试从项目本地来加载对应的类，保证程序的稳定。

效果展示：

优点：

• 类似于黄油刀可以直接对成员变量添加@InjectObject(“com.example.motordex.AppParsenterImpl2”)注解,来绑定热修复包中的实现类。
• 无需关闭应用即可使修复包生效。
• 与mvp模式搭配使用效果最佳。
• 可以自己定义需要热修复的类。
• 可以自己配置dex加密算法，保护dex文件的安全。
• 可以通过注解单独设置某个对象是否禁用双亲委托。

使用

使用方法：

git clone https://github.com/miqt/WandFix.git

添加依赖：

compile project(':wand')
annotationProcessor project(':wand-compiler')

代码调用：

public class MainActivity extends AppCompatActivity {

    @InjectObject(
        "com.example.motordex.AppParsenterImpl2"//热修复包中的实现类
            )
    AppParsenter ap;

    @InjectObject(
            value = "com.example.motordex.AppParsenterImpl2",//热修复包中的实现类
            level = ParentalEntrustmentLevel.PROJECT//启用双亲委托，优先加载本地类
            )
    AppParsenter ap;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        ...
        //初始化，可以放在application中调用一次即可
        Wand.init(this);
        //单个参数
        ClassInstall.inject(this);

        //多个参数的构造方法
        //Map<String, Object[]> map = new HashMap<>();
        //map.put("com.example.motordex.AppParsenterImpl2", new Object[]{1, "参数2", "参数3"});
        //ClassInstall.inject(this, map);

        //调用
        String str = ap.getStr();
        Toast.makeText(this, str, Toast.LENGTH_SHORT).show();
        ...
    }
}

创建并启用热修复包

创建热修复包非常简单。

1. 在编辑器中对类参数添加注解:

class A{
    @InjectObject(
            value = "com.example.motordex.AppParsenterImpl",
            level = ParentalEntrustmentLevel.NEVER)
    AppParsenter ap;
}

2. 在android studio 中点击 Build >> Make Project ， 就会在项目的根目录生成 make_fix_pack.bat 批处理脚本。文本编辑器打开之后类似于这样：

cd ./app/build/intermediates/classes/debug/
jar cvf hotfix_pack.jar ./com/example/motordex/AppParsenterImpl.class
dx --dex --output=../../../../../hotfix_pack.dex hotfix_pack.jar

3. 运行 make_fix_pack.bat 批处理脚本，可以通过找到这个脚本文件直接双击或者在终端中运行，运行之后就可以在项目根目录找到 hotfix_pack.dex 文件，这个就是热修复包了。

4. 通过服务器吧这个 hotfix_pack.dex 文件下发下去，当程序运行到Wand.with(this).init().attachDex(new File("该文件存储路径"));的时候，这个热修复包就被应用到程序中去了。

具体更多用法及其实现原理请移步GitHub·Wiki

附上GitHub地址
欢迎提出问题和宝贵意见。如果您觉得这个项目还不错，就点个star吧(￣▽￣)~*