AndFix簡介

AndFix是一個Android App的在線熱補丁框架。使用此框架，我們能夠在不重復發版的情況下，在線修改App中的Bug。AndFix就是 “Android Hot-Fix”的縮寫。

AndFix Github地址

就目前來說，AndFix支持Android 2.3到6.0版本，并且支持arm 與 X86系統架構的設備。完美支持Dalvik與ART的Runtime。

AndFix 的補丁文件是以 .apatch 結尾的文件。

AndFix原理

AndFix的原理很簡單。就是針對項目中原有方法的替換取代工作

而我們打一個在線的補丁包，也就有了如下的步驟邏輯：

AndFix 實例

Gradle依賴

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

配置Gradle

由于是進行hot fix，所以生成patch的兩個release apk是需要簽名的，再次我們需要創建一個臨時的簽名。這里不講如何生成安卓簽名，生成好簽名后，配置簽名的到gradle文件中，下面是我建立的一個臨時簽名

    signingConfigs {
        debug {
            storeFile file('./../test_ks.jks')
            storePassword '123456'
            keyAlias '123456'
            keyPassword '123456'
        }
    }

代碼部分(version1 apk)

在清單文件中添加sdcard的權限，因為apk需要訪問patch文件。

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

配置一個自定義的Application。

public class AppContext extends Application {


    static AppContext instance;

    public static AppContext getInstance() {
        return instance;
    }

    PatchManager patchManager;

    @Override
    public void onCreate() {
        super.onCreate();
        instance = this;
        patchManager = new PatchManager(this);
        patchManager.init(BuildConfig.VERSION_NAME);
        patchManager.loadPatch();
    }

    public PatchManager getPatchManager() {
        return patchManager;
    }
}

寫一個界面代碼
邏輯是這樣的，當點擊ActionButton的時候，會彈出一個Snackbar，點擊Snackbar上的按鈕，會彈出一個Toast。同時界面再啟動的時候會在加載一個.apatch文件，如果文件存在，則會添加這個補丁文件。

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar);
        setSupportActionBar(toolbar);

        String path = "/mnt/sdcard/out.apatch";
        if (new File(path).exists()) {
            Log.e("Test", "have some patch");
            try {
                AppContext.getInstance().getPatchManager().addPatch(path);
            } catch (Exception e) {
                Log.e("Test", "Test", e);
            }
        } else {
            Log.e("Test", "have no patch");
        }

        FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab);
        fab.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                Snackbar.make(view, "Replace with your own action", Snackbar.LENGTH_LONG)
                        .setAction("Action", new View.OnClickListener() {
                            @Override
                            public void onClick(View v) {
                                showToast("11111");
                            }
                        }).show();
            }
        });
    }

    void showToast(String msg) {
        Toast.makeText(MainActivity.this, msg, Toast.LENGTH_SHORT).show();
    }
}

然后運行程序，會直接在手機上運行，然后我們找到項目的路徑中找到app-debug.apk文件，復制出來命名為1.apk。

app/build/outputs/apk/app-debug.apk

代碼部分(version2 apk)

修改剛剛界面中代碼，修改如下，當點擊ActionButton，直接彈出Toast。

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar);
        setSupportActionBar(toolbar);

        String path = "/mnt/sdcard/out.apatch";
        if (new File(path).exists()) {
            Log.e("Test", "have some patch");
            try {
                AppContext.getInstance().getPatchManager().addPatch(path);
            } catch (Exception e) {
                Log.e("Test", "Test", e);
            }
        } else {
            Log.e("Test", "have no patch");
        }

        FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab);
        fab.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                showToast("2222");
            }
        });
    }

    void showToast(String msg) {
        Toast.makeText(MainActivity.this, msg, Toast.LENGTH_SHORT).show();
    }
}

同樣運行程序后，復制運行過后的apk文件，命名為2.apk

生成.apatch文件

下載Apatch文件生成工具，然后解壓縮，同時剛剛復制出來的2個apk文件，復制到同一個目錄下面，還有相對應的簽名文件。

運行下面的命令，即可生成一個apatch文件。

./apkpatch.sh -f 2.apk -t 1.apk -o ./ -k test_ks.jks -p 123456 -a 123456 -e 123456

工具的命令文檔如下:

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文件如下：

 2-df8a710835742d3b84c9d9e47ca7f8d2.apatch

重命名為out.apatch

驗證

把手機上的運行的卸載，重新安裝上1.apk，運行程序，然后通過命令導入out.apatch，再次運行1.apk，發現1.apk+apatch文件運行的效果和2.apk一樣。

adb push out.apatch /mnt/sdcard/

總結

我這邊只是簡單運行了下AndFix，寫了一個demo，考慮到實際項目中需求，可以在程序運行的時候，直接向服務器請求補丁文件，如果有文件需要更新，則下載文件，等到文件下載完成后，即可保證bug的修復。