前言
上一篇文章 //www.greatytc.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
最后
小弟写博客不久,可能还有很多地方写的不好,希望大家及时指出来,共同进步!当然,要是能点个喜欢或者关注一下就更好了!!
