AndFix 是一种在线修复错误的解决方案,而不是重新分发 Android 应用程序。它作为Android 库分发。
Andfix是一个缩写“而固醇热-修复”。
AndFix支持从2.3到7.0的Android版本,ARM和X86架构,Dalvik和ART运行时,32位和64位。
AndFix 的补丁压缩文件格式为.apatch。它从您自己的服务器发送到客户端以修复您的应用程序的错误。
原则
AndFix的实现原理是方法体的替换
方法替换
AndFix判断方法应该替换为java自定义注解,通过hook来替换。AndFixart_replaceMethod
在 ART 或dalvik_replaceMethod
Dalvik 中有一个本地方法。
有关更多详细信息,请点击此处。
一体化
怎么获得?
直接将 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' }
如何使用?
- 初始化 PatchManager,
patchManager = new PatchManager(context); patchManager.init(appversion);//current version
- 加载补丁,
patchManager.loadPatch();
您应该尽早加载补丁,通常在应用程序的初始化阶段(例如Application.onCreate()
)。
- 添加补丁,
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.
运行示例
- 将 samplesI/AndFixDemo 导入您的 IDE,使用 AndFix(库项目或 aar)附加 AndFixDemo 依赖项。
- 构建项目,将包保存为1.apk,然后安装在设备/模拟器上。
- 修改com.euler.test.A,参考com.euler.test.Fix。
- 构建项目,将包保存为2.apk。
- 使用 apkpatch 工具制作补丁。
- 将补丁文件重命名为out.apatch,然后复制到sdcard。
- 运行 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 。