接入阿里百川Hotfix的过程(第二篇:编写及设置)

前言

上一篇文章 http://www.jianshu.com/p/654e812d1222 我简单写了一下阿里百川Hotfix的配置过程,就在我刚写完的第二天,Hotfix出了升级版本的Sophix,这次支持的更多了!首先赞一个,出了Hotfix2.0版本以后,我也是第一时间进行了接入,比1.x的要用起来舒服多了!接下来废话不多说,直接上代码吧!

SophixManager.getInstance()
                .setContext(this)
                .setAppVersion(AppUtils.getVersionName(this))
                .setAesKey(null)
                .setEnableDebug(Constants.DEBUG_MODE)
                .setPatchLoadStatusStub((mode, code, info, patchVersion) ->{
                    switch (code){
                        case PatchStatus.CODE_LOAD_SUCCESS:
                            XLog.d("SophixManager",info+"----补丁加载成功,当前的补丁版本为:"+patchVersion);
                            break;
                        case PatchStatus.CODE_LOAD_FAIL:
                            //内部引擎异常, 推荐此时清空本地补丁, 防止失败补丁重复加载
                            XLog.d("SophixManager",info+"---补丁加载失败,下面将清空本地补丁再重新拉取补丁!");
                            SophixManager.getInstance().cleanPatches();
                            break;
                        default:
                            XLog.d("SophixManager","--mode是"+mode+"--code是"+code
                                    +"--info是"+info+"--patchVersion是"+patchVersion);
                            break;
                    }
                }).initialize();
        SophixManager.getInstance().queryAndLoadNewPatch();

这一段代码我写在application的onCreate()里面
其实真正核心的东西也就这么多了,下面我简单就里面的几个方法做一下解释!

代码分析部分

SophixManager.getInstance()//获取单例的SophixManager对象
setContext(this)//这个就不用解释了吧
setAppVersion()//设置当前的appVersion,建议直接通过utils拿当前app版本的版本号
setAeskey()//这个是一个加密,防止你的补丁包被别人抓取然后泄露信息,因为我没有用到,所以传的null,有需求的可以去具体看阿里百川的教程
setEnableDebug(true)//是否打印Sophix的log日志,默认关闭,这个建议跟当前app的debug版本一致
setPatchLoadStatusStub()//设置patch加载状态监听器, 该方法参数需要实现PatchLoadStatusListener接口, 
//(因为我用了lamada,所以这个是序列化以后的写法,不了解的去看看lamada),下面我一个一个来介绍
//mode :这个参数显示的是你当前加载补丁到底是通过哪个途径来添加的: 0:正常请求模式 1:扫码模式 2:本地补丁模式
//code: 补丁加载状态码, 详情查看PatchStatusCode类说明
//info: 补丁加载详细说明, 详情查看PatchStatusCode类说明
//handlePatchVersion: 当前处理的补丁版本号, 0:无 -1:本地补丁 其它:后台补丁

介绍的话大家也可以看下面的链接
开发者集成文档http://baichuan.taobao.com/docs/doc.htm?spm=a3c0d.7629140.0.0.eJJ4qK&treeId=234&articleId=106531&docType=1

queryAndLoadNewPatch方法

该方法主要用于查询服务器是否有新的可用补丁. SDK内部限制连续两次queryAndLoadNewPatch()方法调用不能短于3s, 否则的话就会报code:19的错误码. 如果查询到可用的话, 首先下载补丁到本地, 然后

应用原本没有补丁, 那么如果当前应用的补丁是热补丁, 那么会立刻加载(不管是冷补丁还是热补丁). 如果当前应用的补丁是冷补丁, 那么需要重启生效.
应用已经存在一个补丁, 首先会把之前的补丁文件删除, 然后不立刻加载, 而是等待下次应用重启再加载该补丁
补丁在后台发布之后, 并不会主动下行推送到客户端, 需要手动调用queryAndLoadNewPatch方法查询后台补丁是否可用.
只会下载补丁版本号比当前应用存在的补丁版本号高的补丁, 比如当前应用已经下载了补丁版本号为5的补丁, 那么只有后台发布的补丁版本号>5才会重新下载.

同时1.4.0以上版本服务后台上线了“一键清除”补丁的功能, 所以如果后台点击了“一键清除”那么这个方法将会返回code:18的状态码. 此时本地补丁将会被强制清除, 同时不清除本地补丁版本号

cleanPatches()方法

清空本地补丁

版本管理说明

说明一：patch是针对客户端具体某个版本的，patch和具体版本绑定

eg. 应用当前版本号是1.1.0, 那么只能在后台查询到1.1.0版本对应发布的补丁, 而查询不到之前1.0.0旧版本发布的补丁.

说明二：针对某个具体版本发布的新补丁, 必须包含所有的bugfix, 而不能依赖补丁递增修复的方式, 因为应用仅可能加载一个补丁

eg. 针对1.0.0版本在后台发布了一个补丁版本号为1的补丁修复了bug1, 然后发现此时针对这个版本补丁1修复的不完全, 代码还有bug2, 在后台重新发布一个补丁版本号为2的补丁, 那么此时补丁2就必须同时包含bug1和bug2的修复才行, 而不是只包含bug2的修复(bug1就没被修复了)

本来很多打算自己写的,但是觉得官方的拷过来更专业,毕竟解释的很详细!下面具体讲一下后台的用法

后台创建应用

开发者控制台图片及网址

http://console.baichuan.taobao.com/applications.htm?spm=a3c0d.8115102.0.0

点击创建应用

会弹出上面的界面

创建成功之后

应用列表展示

点进去应用

大致就是这个样子

想要管理后台的话点击这里

产品后台

然后选择自己已开通的hotfix

点进去以后的后台应用列表

可以看到创建一个应用会有两个操作系统的,我们只针对android,不过ios目前开始打击热更新这一块了!

点进去管理,接下来的如图

新增版本

版本号和当前的app的版本号一致,点进去新建的版本就会看到上传补丁,补丁包的制作详见下面链接!http://baichuan.taobao.com/docs/doc.htm?spm=a3c0d.7629140.0.0.UX6d4l&treeId=234&articleId=106532&docType=1

里面的强制冷启动修复什么时候用,我第一篇博客里面贴出来的图里面有!

调试工具使用说明

链接里面介绍的很详细,有什么疑问欢迎留言!
http://baichuan.taobao.com/docs/doc.htm?spm=a3c0d.7629140.0.0.cgWAIG&treeId=234&articleId=105842&docType=1

最后

小弟写博客不久,可能还有很多地方写的不好,希望大家及时指出来,共同进步!当然,要是能点个喜欢或者关注一下就更好了!!