一、前言

      最近研究阿里的開源熱修復框架AndFix，本文參考AndFix官方教程，給出我所使用詳細小白demo教程，包括在構建測試demo過程中所遇到對問題也列出來。阿里github連結：https://github.com/alibaba/AndFix

      限制：

      1、支援的Android版本為2.3-7.0（即：Android API 9 ~ Android API 24），本文在7.1版本的真機中測試失敗。

       2、無法新增刪除類和欄位，只能修改。

       3、如建構函式等靜態函式可能會有問題。

二、生成帶bug的APK

     1、用AndroidStudio新建專案。

       踩坑說明：

       在使用AS建立專案時候，不管你選擇的是那個Target版本，在gradle中預設的SDK都是最高版本。而我一開始用最高版本時，專案/build/outputs資料夾下沒有apk資料夾，使用如下步驟生成apk檔案：

           此時output目錄下生成apk資料夾，但最後生成補丁包時報錯如下：

      因此最後我選擇手動修改gradle配置檔案,降低SDK版本，同時由於本文為demo測試，刪除了一些不需要的依賴項。

      本文使用Gradle將sdk編譯版本設定為23，並且將最低目標版本為21（這個大家可以根據官網支援的版本修改），同時刪除了所有dependencies依賴項，只新增AndFix依賴，具體對應位置修改如下：

compileSdkVersion 23

minSdkVersion 21

dependencies {
    compile 'com.alipay.euler:andfix:[email protected]'
}

       此時，當我們修改完成後，gradle sync發現會報許多資源錯誤。這是因為建立的專案資原始檔中使用了高版本SDK和一些依賴包中的東西，因此需要將不必要的資原始檔或裡面引用的標籤刪除，大致包括AndroidManifest.xml中的標籤，res資料夾下的資原始檔。如果是生成的BasicActivity，那麼在這個Activity中，也可以將其他東西刪除。

本文最終的使用的MainActivity.java關鍵程式碼如下：

import android.app.Activity;
import android.os.Bundle;
import android.util.Log;
import android.widget.TextView;

public class MainActivity extends Activity {

    // Used to load the 'native-lib' library on application startup.
    static {
        System.loadLibrary("native-lib");
    }

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        // Example of a call to a native method
        Log.d("euler", "test");
        TextView tv = (TextView) findViewById(R.id.text);
        tv.setText(change());
    }


    /**
     * A native method that is implemented by the 'native-lib' native library,
     * which is packaged with this application.
     */
    public native String stringFromJNI();
    public String change(){
        return "old";
    }

佈局檔案activity_main.xml程式碼如下：

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >
    <Button
        android:id="@+id/change_text"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Change Text" />
    <TextView
        android:id="@+id/text"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"
        android:text="Hello world"/>
</RelativeLayout>

補丁框架所需要的類MainApplication.java，直接放在與啟動類MainActivity同一目錄下，具體程式碼如下：

import java.io.IOException;

import android.app.Application;
import android.os.Environment;
import android.util.Log;

import com.alipay.euler.andfix.patch.PatchManager;

/**
 * sample application
 * 
 * @author [email protected]
 * 
 */
public class MainApplication extends Application {
	private static final String TAG = "euler";

	private static final String APATCH_PATH = "/out.apatch";
	/**
	 * patch manager
	 */
	private PatchManager mPatchManager;

	@Override
	public void onCreate() {
		super.onCreate();
		// initialize
		mPatchManager = new PatchManager(this);
		mPatchManager.init("1.0");
		Log.d(TAG, "inited.");

		// load patch
		mPatchManager.loadPatch();
		Log.d(TAG, "apatch loaded.");

		// add patch at runtime
		try {
			// .apatch file path
			String patchFileString = Environment.getExternalStorageDirectory()
					.getAbsolutePath() + APATCH_PATH;
			mPatchManager.addPatch(patchFileString);
			Log.d(TAG, "apatch:" + patchFileString + " added.");
		} catch (IOException e) {
			Log.e(TAG, "", e);
		}

	}
}

由於本文程式碼需要對sdcard進行讀寫，且實現MainApplication類，因此需要修改AndroidManifest.xml檔案，本文具體程式碼如下：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.andfixdemo1">
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <application
        android:name="com.example.andfixdemo1.MainApplication"
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true">
        <activity
            android:name=".MainActivity"
            android:label="@string/app_name">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

此時專案生成基本完成，gradle能夠build成功。如果還有什麼錯誤，只需要根據提示安裝即可。

2、生成keystore檔案

AndFix在使用補丁工具生成補丁包時，需要keystore檔案和金鑰等，如果你已經有自己的keystore檔案，則可跳過這步。具體步驟如下：

finish後軟體會自動在指定目錄下生成jks檔案，並提示生成成功。

3、生成簽名apk

建立好keystore後，需要配置用該檔案作為apk的簽名檔案，具體步驟如下：

配置完成後，選擇本次編譯版本，因為簽名配置使用簽名檔案的版本為release版，因此編譯選項選擇release版。具體步驟如下：

      然後執行安裝app即可，在專案路徑/app/build/outputs/apk/release/app-release.apk即為帶Bug的apk。

     本文儲存該apk並更名為old.apk，解壓原始碼AndFix-master/tools/apkpatch-1.0.3.zip，將old.apk放在解壓後的apkpatch-1.0.3資料夾下。

      需要注意的是，本文demo使用了儲存裝置讀取許可權，因此安裝後需要手動在應用管理中開啟儲存許可權。

三、生成修復APK

       本文更新的apk檔案，只是將MainActivity中change函式的返回字串更改為new，重新編譯得到更新後的apk檔案，並重命名為new.apk，同樣複製到apkpatch-1.0.3資料夾下，此時手機裡執行的仍然是帶bug的old.apk。

四、生成補丁檔案

        進入apkpatch-1.0.3資料夾資料夾，使用如下命令生成補丁.apatch檔案。

./apkpatch.sh -o /Users/xxx/Desktop/ -k /Users/xxx/xxx.jks -p ******** -a xxx -e ******** -t ./old.apk -f ./new.apk

        命令引數說明：

         此時，Desktop目錄下將生成了兩個檔案，關注.patch檔案，重新命名為MainApplication中用到的常量名稱out.patch。

五、修復測試

         將補丁檔案放入指定位置，本文所用測試機對應位置為/sdcard，因此使用命令如下：

adb push /Users/xxx/Desktop/out.apatch /sdcard/out.apatch

          對於其他機型，本文程式碼對應可能使用的命令如下：

adb push /Users/xxx/Desktop/out.apatch /storage/emulated/0/out.apatch

           重新啟動應用，發現bug已經被修復。