Android热修复实践应用--AndFix

一直关注App的热修复的技术发展，以前作的应用也没用使用到什么热修复开源框架。在App的热修复框架没有流行以前，作的应用上线后发现一个小小的Bug，就要立刻发一个新的版本。我亲身经历过一周发两个版本，真的折腾用户的节奏~~因此，要开始考虑引入热修复。下面记录使用开源框架阿里巴巴的AndFix过程。

实现的原理

这里说的不是热修复怎么实现修bug的原理，这里说的是怎么使用AndFix。若是你想了解更多的andFix实现原理，你能够参考下面的文章：

• https://github.com/alibaba/AndFix （AndFix的官网）
• http://blog.csdn.net/lmj623565791/article/details/49883661 （Android大神鸿洋的Bolg文章）

 

1. 应用启动的时候，在 onCreate() 方法中获取友盟的在线参数来判断当前的应用版本是否有补丁须要下载，有则经过ThinDonloadManager来下载到SD下而且经过使用AndFix来加载到应用中。
2. 使用极光推送消息到该应用的版本须要下载补丁，若是应用收到了消息后，应用判断当前的版本是否须要下载补丁。若是应用没有收到消息的通知，则下次启动App的时候，获取友盟在线参数来判断是否须要下载补丁。

步骤

1. 在gradle文件中增长相应的依赖。这里我使用thindownlaodmanager来下载补丁，使用极光推送来推送自定义消息下载补丁通知，使用友盟在线参数来获取补丁包的信息。也许你会问为了修复一个补丁而增长这么多的依赖，值得吗？我认为还能够吧，由于个人项目通常会使用到这些。

   AndFix的引入是： compile 'com.alipay.euler:andfix:0.3.1@aar'

    

2. 导入AndFix的so库文件以及极光推送的so库文件;
   极光推送集成参考文档:http://docs.jpush.io/client/android_sdk/
   注意：导入AndFix的so文件时，能够先阅读这下个：https://github.com/zhonghanwen/AndFix-Ndk-Build-ADT

   • 接着，集成友盟在线参数
     参考官方文档:http://dev.umeng.com/online-parameters/android-doc/intergration

    

3. 配置友盟在线参数的参数以及推光推送自定义的内容

   • 友盟在线参数

   • 极光推送自定义消息(自定义消息有长度限制，因此补丁的下载url写成拼接形式：站点+下载资源名称)

   • 定义相对应的Bean
     

    

4. 在启动的自定义Application类进行初始化工做(AndFix、极光的初始化)

5. 在程序的入口类进行友盟补丁的检测：

   private void getUmengParamAndFix() {
       //获取友盟在线参数对应key的values
       String pathInfo = OnlineConfigAgent.getInstance().getConfigParams(this, UMENG_ONLINE_PARAM);
       if (!TextUtils.isEmpty(pathInfo)){
           PatchBean onLineBean = GsonUtils.getInstance().parseIfNull(PatchBean.class , pathInfo);
           try {
               //进行判断当前版本是否有补丁须要下载更新
               RepairBugUtil.getInstance().comparePath(this, onLineBean);
           } catch (Exception e) {
               e.printStackTrace();
           }
       }
   }
   

   　　

    

6. 再加上推送推送的自定义内容的处理：（当推送消息过来的时候应用处于运行状态的时候，程序会处理消息进行下载补丁包）

       private WeakHandler mHandler = new WeakHandler(new Handler.Callback() {
       @Override
       public boolean handleMessage(Message msg) {
           if (msg.what == MSG_WHAT_DOWNLOAD){
               String message = (String) msg.obj;
               if (TextUtils.isEmpty(message)) return false;
               try {
                   PatchBean bean = GsonUtils.getInstance().parse(PatchBean.class, message);
                   RepairBugUtil.getInstance().comparePath(MainActivity.this, bean);
               } catch (Exception e) {
                   e.printStackTrace();
               }
           }
           return false;
       }
   });
   
   
   
   //for receive customer msg from jpush server
   private MessageReceiver mMessageReceiver;
   public static final String MESSAGE_RECEIVED_ACTION = "com.zhw.andfix.MESSAGE_RECEIVED_ACTION";
   public static final String KEY_MESSAGE = "message";
   
   public void registerMessageReceiver() {
       mMessageReceiver = new MessageReceiver();
       IntentFilter filter = new IntentFilter();
       filter.setPriority(IntentFilter.SYSTEM_HIGH_PRIORITY);
       filter.addAction(MESSAGE_RECEIVED_ACTION);
       registerReceiver(mMessageReceiver, filter);
   }
   
   public class MessageReceiver extends BroadcastReceiver {
   
       @Override
       public void onReceive(Context context, Intent intent) {
           if (MESSAGE_RECEIVED_ACTION.equals(intent.getAction())) {
               String message = intent.getStringExtra(KEY_MESSAGE);
               Message msg = new Message();
               msg.what = MSG_WHAT_DOWNLOAD;
               msg.obj = message;
               mHandler.sendMessage(msg);
           }
       }
   }
   

   　　

    

7. 补丁包的生成

   • 下载AndFix的补丁生成工具：here
   • 生成补丁的文件须要的文件有：原apk文件，修复Bug后生成的新apk，签名文件。
   • 在解压apkpatch工具的目录下，打开命令行输入如下命令生成补丁包。apkpatch -m <apatch_path...> -o <output> -k <keystore> -p <***> -a <alias> -e <***>
   • 将生成的补丁放到指定服务器上。（这里我放到了七牛上）

    

8. 本身测试一下成不成啦~

代码

经过ThinDownloadManager下载补丁包，下载成功后使用AndFix加载补丁包的方法：

public void downloadAndLoad(Context context, final PatchBean bean, String downloadUrl) {
    if (mLocalPreferencesHelper == null) {
        mLocalPreferencesHelper = new LocalPreferencesHelper(context, SPConst.SP_NAME);
    }
    Uri downloadUri = Uri.parse(downloadUrl);
    Uri destinationUri = Uri.parse(Environment.getExternalStorageDirectory()
            .getAbsolutePath() + bean.url);
    DownloadRequest downloadRequest = new DownloadRequest(downloadUri)
            .setDestinationURI(destinationUri)
            .setPriority(DownloadRequest.Priority.HIGH)
            .setDownloadListener(new DownloadStatusListener() {
                @Override
                public void onDownloadComplete(int id) {
                    // add patch at runtime
                    try {
                        // .apatch file path
                        String patchFileString = Environment.getExternalStorageDirectory()
                                .getAbsolutePath() + bean.url;
                        BaseApplication.mPatchManager.addPatch(patchFileString);
                        Log.d(TAG, "apatch:" + patchFileString + " added.");

                        //复制且加载补丁成功后，删除下载的补丁
                        File f = new File(patchFileString);
                        if (f.exists()) {
                            boolean result = new File(patchFileString).delete();
                            if (!result)
                                Log.e(TAG, patchFileString + " delete fail");
                        }
//                            mLocalPreferencesHelper.saveOrUpdate(SPConst.IsHavePathDownLoad, false);
                    } catch (IOException e) {
                        Log.e(TAG, "", e);
                    } catch (Throwable throwable) {

                    }
                }

                @Override
                public void onDownloadFailed(int id, int errorCode, String errorMessage) {
                    //下载失败的时候，标注标记位，等下次从新打开应用的时候从新下载
//                        mLocalPreferencesHelper.saveOrUpdate(SPConst.IsHavePathDownLoad, true);
                    Log.e(TAG, "onDownloadFailed");

                }

                @Override
                public void onProgress(int id, long totalBytes, int progress) {
                    Log.e(TAG, "progress:" + progress);
                }
            });
    mDownloadManager = new ThinDownloadManager(THREAD_COUNT);
    mDownloadManager.add(downloadRequest);
}

　　

判断是否有补丁包须要下载的方法：

  public void comparePath(Context context, PatchBean RemoteBean) throws Exception {
    String pathInfo = mLocalPreferencesHelper.getString(SPConst.PATH_INFO);
    final PatchBean localBean = GsonUtils.getInstance().parseIfNull(PatchBean.class, pathInfo);
    //远程的应用版本跟当前应用的版本比较
    if (BaseApplication.VERSION_NAME.equals(RemoteBean.app_v)) {
        //远程的应用版本跟本地保存的应用版本同样，但补丁不同，则须要下载从新
        /**
         *第一种状况：当本地记录的Bean为空的时候（刚安装的时候可能为空）而且远程的Bean的path_v不为空的时候须要下载补丁。
         * 第二种状况：当本地记录的path_v和远程Bean的path_v不同的时候须要下载补丁。
         */
        if (localBean == null && !TextUtils.isEmpty(RemoteBean.path_v)
                || localBean.app_v.equals(RemoteBean.app_v) &&
                !localBean.path_v.equals(RemoteBean.path_v)) {
            downloadAndLoad(context, RemoteBean,
                    SPConst.URL_PREFIX + RemoteBean.url);
            String json = GsonUtils.getInstance().parse(RemoteBean);
            mLocalPreferencesHelper.saveOrUpdate(SPConst.PATH_INFO, json);
        } /*else {
            mLocalPreferencesHelper.saveOrUpdate(SPConst.IsHavePathDownLoad, false);
        }*/
    }
}

　　

附

项目GitHub地址：https://github.com/zhonghanwen/AndFix-Bad-Practices