Android APP热修复程序库——AndFix

AndFix 是一种在线修复错误的解决方案,而不是重新分发 Android 应用程序。它作为Android 库分发。

Andfix是一个缩写“固醇热-修复”。

AndFix支持从2.3到7.0的Android版本,ARM和X86架构,Dalvik和ART运行时,32位和64位。

AndFix 的补丁压缩文件格式为.apatch。它从您自己的服务器发送到客户端以修复您的应用程序的错误。

原则

AndFix的实现原理是方法体的替换

Android APP热修复程序库——AndFix

方法替换

AndFix判断方法应该替换为java自定义注解,通过hook来替换。AndFixart_replaceMethod在 ART 或dalvik_replaceMethodDalvik 中有一个本地方法。

有关更多详细信息,请点击此处

Android APP热修复程序库——AndFix

一体化

怎么获得?

直接将 AndFix aar 作为编译库添加到您的项目中。

对于您的 maven 依赖,

<dependency>
    <groupId>com.alipay.euler</groupId>
    <artifactId>andfix</artifactId>
    <version>0.5.0</version>
    <type>aar</type>
</dependency>

对于您的 gradle 依赖项,

dependencies {
    compile 'com.alipay.euler:andfix:0.5.0@aar'
}

如何使用?

  1. 初始化 PatchManager,
patchManager = new PatchManager(context);
patchManager.init(appversion);//current version
  1. 加载补丁,
patchManager.loadPatch();

您应该尽早加载补丁,通常在应用程序的初始化阶段(例如Application.onCreate())。

  1. 添加补丁,
patchManager.addPatch(path);//path of the patch file that was downloaded

下载新的补丁文件后,它将立即生效addPatch

开发者工具

AndFix 提供了一个名为apkpatch的补丁制作工具。

怎么获得?

apkpatch工具可以在这里找到。

如何使用?

  • 准备两个android包,一个是在线包,一个是你通过编码修复bug后的包。
  • .apatch通过提供两个包生成文件,
usage: apkpatch -f <new> -t <old> -o <output> -k <keystore> -p <***> -a <alias> -e <***>
 -a,--alias <alias>     keystore entry alias.
 -e,--epassword <***>   keystore entry password.
 -f,--from <loc>        new Apk file path.
 -k,--keystore <loc>    keystore path.
 -n,--name <name>       patch name.
 -o,--out <dir>         output dir.
 -p,--kpassword <***>   keystore password.
 -t,--to <loc>          old Apk file path.

现在您获得了应用程序的救星,补丁文件。然后你需要以某种方式将它发送给你的客户,推或拉。

有时,您的团队成员可能会修复彼此的错误,并且不仅生成一个.apatch. 对于这种情况,您可以.apatch使用此工具合并文件,

usage: apkpatch -m <apatch_path...> -o <output> -k <keystore> -p <***> -a <alias> -e <***>
 -a,--alias <alias>     keystore entry alias.
 -e,--epassword <***>   keystore entry password.
 -k,--keystore <loc>    keystore path.
 -m,--merge <loc...>    path of .apatch files.
 -n,--name <name>       patch name.
 -o,--out <dir>         output dir.
 -p,--kpassword <***>   keystore password.

运行示例

  1. 将 samplesI/AndFixDemo 导入您的 IDE,使用 AndFix(库项目或 aar)附加 AndFixDemo 依赖项。
  2. 构建项目,将包保存为1.apk,然后安装在设备/模拟器上。
  3. 修改com.euler.test.A,参考com.euler.test.Fix。
  4. 构建项目,将包保存为2.apk。
  5. 使用 apkpatch 工具制作补丁。
  6. 将补丁文件重命名为out.apatch,然后复制到sdcard。
  7. 运行 1.apk 并查看日志。

注意

混淆器

如果您启用 ProGuard,您必须保存 mapping.txt,以便您的新版本的构建可以与"-applymapping" 一起使用

并且有必要保持课程如下,

  • 本机方法
    com.alipay.euler.andfix.AndFix
  • 注解
    com.alipay.euler.andfix.annotation.MethodReplace

为了确保在运行混淆和静态分析工具(如 ProGuard)后可以找到这些类,请将以下配置添加到您的 ProGuard 配置文件中。

-keep class * extends java.lang.annotation.Annotation
-keepclasseswithmembernames class * {
    native <methods>;
}

自修改代码

如果你使用它,比如Bangcle。要生成补丁文件,最好使用原始 apk。

安全

以下内容很重要,但超出了 AndFix 的范围。

  • 验证补丁文件的签名
  • 验证优化文件的指纹

API 文档

可以在此处找到库 javadoc 。

上一篇:ACP实战特训营RDS(DAY1)


下一篇:Python 实现字符串反转的四种方法