AndFix：阿里巴巴開源Android App線上問題修復工具

AndFix這個庫為Android App提供了熱修復的功能。它能夠幫助Android開發人員在線修復App Bug。
Andfix是" And roid hot- fix "首字母縮寫。

AndFix支持Android 2.3 至 6.0, arm 和 x86 架構, dalvik runtime 和 art runtime.

AndFix's patch is .apatch file.

Principle

The implementation principle of AndFix is method's body replace :

bug fix process:

Integration

How to get?

1. directly add AndFix aar to your project as compile libraries.

2. maven dependency:

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

   
   

   or gradle dependency:

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

How to use?

1. initialize PatchManager:

   patchManager = new PatchManager(context);
   patchManager.init(appversion);//current version 

2. load patch. load patch as early as possible, generally, at the initialization phase of your app (such as application.oncreate()):

   patchManager.loadPatch();

3. add patch. when new patch file has be downloaded,the patch will become effective immediately by add.

   patchManager.addPatch(path);//path of the patch file that be downloaded 

ProGuard

To ensure that these classes can be found after running an obfuscation and static analysis tool like ProGuard add the configuration below to your ProGuard configuration file.

• native method

  com.euler.cloudfix.CloudFix

• annotation

  com.euler.cloudfix.annotation.MethodReplace

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

  
  

Developer Tool

The patch make tool is apkpatch.

How to get?

Apkpatch can be foundhere

How to use?

• generate .apatch file:

usage: apkpatch -f <new> -t <old> -o <output> -k <keystore> -p <***> -a <alias> -e <***> -a,--alias <alias> alias.
 -e,--epassword <***> 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.

• merge .apatch files:

usage: apkpatch -m <apatch_path...> -k <keystore> -p <***> -a <alias> -e <***> -a,--alias <alias> alias.
 -e,--epassword <***> 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.

Running sample

1. import samples/AndFixDemo to your IDE, set AndFixDemo depend on AndFix(library project or aar).
2. build project, save the package as 1.apk, and then install on device/emulator.
3. modify com.euler.test.A, references com.euler.test.Fix.
4. build project, save the package as 2.apk.
5. use apkpatch to make a patch.
6. rename the patch file to out.apatch, and then copy it onto sdcard.
7. run 1.apk,view logcat.

API Documentation

The libraries javadoc can be found here

項目主頁：http://www.baiduhome.net/lib/view/home/1442330606790