阿里热更新hotfix使用
一、SDK引入
项目build中添加
buildscript {repositories {google()jcenter()//添加这句maven {url "http://maven.aliyun.com/nexus/content/repositories/releases"}}dependencies {...}}allprojects {repositories {google()jcenter()maven { url "https://jitpack.io" }//添加这句maven {url "http://maven.aliyun.com/nexus/content/repositories/releases"}}
app目录下的build中添加:
//热更新-阿里
implementation 'com.aliyun.ams:alicloud-android-hotfix:3.2.14'
二、添加必要权限
三、添加meta-data
在AndroidManifest.xml文件的Application节点下面,添加以下内容:
这三个值需要到前面下载的aliyun-emas-services.json文件里查找,对应关系如下:
| value名 | 对应字段 |
|---|---|
| App ID | hotfix.idSecret |
| App Secret | emas.appSecret |
| RSA密钥 | hotfix.rsaSecret |
四、混淆配置(可选)
#基线包使用,生成mapping.txt
-printmapping mapping.txt
#生成的mapping.txt在app/build/outputs/mapping/release路径下,移动到/app路径下
#修复后的项目使用,保证混淆结果一致
#-applymapping mapping.txt
#hotfix
-keep class com.taobao.sophix.**{*;}
-keep class com.ta.utdid2.device.**{*;}
#防止inline
-dontoptimize
五、代码配置
public class SophixStubApplication extends SophixApplication {private final String TAG = "SophixStubApplication";@Keep@SophixEntry(MyApplication.class)static class RealApplicationStub {}@Overrideprotected void attachBaseContext(Context base) {super.attachBaseContext(base);MultiDex.install(this);initSophix();}/*** 初始化Sophix* 需要在attachBaseContext方法里面调用* 并且要在super.attachBaseContext(base);和Multidex.install方法之后调用* 且在其他方法之前*/private void initSophix() {String appVersion = "1.0.5.4";try {appVersion = this.getPackageManager().getPackageInfo(this.getPackageName(), 0).versionName;} catch (Exception e) {}final SophixManager instance = SophixManager.getInstance();instance.setContext(this).setAppVersion(appVersion).setSecretMetaData(null, null, null).setEnableDebug(true).setEnableFullLog().setPatchLoadStatusStub(new PatchLoadStatusListener() {@Overridepublic void onLoad(final int mode, final int code, final String info, final int handlePatchVersion) {// 补丁加载回调通知if (code == PatchStatus.CODE_LOAD_SUCCESS) {// 表明补丁加载成功Log.i(TAG,"表明补丁加载成功");} else if (code == PatchStatus.CODE_LOAD_RELAUNCH) {// 表明新补丁生效需要重启. 开发者可提示用户或者强制重启;// 建议: 用户可以监听进入后台事件, 然后应用自杀Log.i(TAG,"表明新补丁生效需要重启. 开发者可提示用户或者强制重启");} else if (code == PatchStatus.CODE_LOAD_FAIL) {// 内部引擎异常, 推荐此时清空本地补丁, 防止失败补丁重复加载SophixManager.getInstance().cleanPatches();Log.i(TAG,"内部引擎异常, 推荐此时清空本地补丁, 防止失败补丁重复加载");} else {// 其它错误信息, 查看PatchStatus类说明Log.i(TAG,"其它错误信息, 查看PatchStatus类说明");}String msg = new StringBuilder("").append("Mode:").append(mode).append(" Code:").append(code).append(" Info:").append(info).append(" HandlePatchVersion:").append(handlePatchVersion).toString();Log.e("----",msg.toString());}}).initialize();}@Overridepublic void onCreate() {super.onCreate();//queryAndLoadNewPatch不可放在attachBaseContext 中,否则无网络权限,建议放在后面任意时刻,如onCreate中SophixManager.getInstance().queryAndLoadNewPatch();}
}
六、把AndroidManifest里面的application改为这个新增的SophixStubApplication类
... ...
SophixManager方法:
setAppVersion(appVersion) 设置版本号,版本号与控制台的版本号统一,才可以更新这里我踩的坑,控制台上添加版本,是添加需要更新的版本,与版本升级没有关系setAesKey(null) //<可选>用户自定义aes秘钥, 会对补丁包采用对称加密setEnableDebug(true) <可选> isEnabled默认为false, 是否调试模式, 调试模式下会输出日志以及不进行补丁签名校验.线下调试此参数可以设置为true, 查看日志过滤TAG正式发布必须改为false,否则存在安全风险setSecretMetaData(null, null, null) <可选,推荐使用> 三个Secret分别对应AndroidManifest里面的三个,可以不在AndroidManifest设置而是用此函数来设置SecretsetPatchLoadStatusStub <可选> 设置patch加载状态监听器,该方法参数需要实现PatchLoadStatusListener接口
code的各个返回码含义:
//兼容老版本的code说明int CODE_LOAD_SUCCESS = 1;//加载阶段, 成功int CODE_ERR_INBLACKLIST = 4;//加载阶段, 失败设备不支持int CODE_REQ_NOUPDATE = 6;//查询阶段, 没有发布新补丁int CODE_REQ_NOTNEWEST = 7;//查询阶段, 补丁不是最新的 int CODE_DOWNLOAD_SUCCESS = 9;//查询阶段, 补丁下载成功int CODE_DOWNLOAD_BROKEN = 10;//查询阶段, 补丁文件损坏下载失败int CODE_UNZIP_FAIL = 11;//查询阶段, 补丁解密失败int CODE_LOAD_RELAUNCH = 12;//预加载阶段, 需要重启int CODE_REQ_APPIDERR = 15;//查询阶段, appid异常int CODE_REQ_SIGNERR = 16;//查询阶段, 签名异常int CODE_REQ_UNAVAIABLE = 17;//查询阶段, 系统无效int CODE_REQ_SYSTEMERR = 22;//查询阶段, 系统异常int CODE_REQ_CLEARPATCH = 18;//查询阶段, 一键清除补丁int CODE_PATCH_INVAILD = 20;//加载阶段, 补丁格式非法//查询阶段的code说明int CODE_QUERY_UNDEFINED = 31;//未定义异常int CODE_QUERY_CONNECT = 32;//连接异常int CODE_QUERY_STREAM = 33;//流异常int CODE_QUERY_EMPTY = 34;//请求空异常int CODE_QUERY_BROKEN = 35;//请求完整性校验失败异常int CODE_QUERY_PARSE = 36;//请求解析异常int CODE_QUERY_LACK = 37;//请求缺少必要参数异常//预加载阶段的code说明int CODE_PRELOAD_SUCCESS = 100;//预加载成功int CODE_PRELOAD_UNDEFINED = 101;//未定义异常int CODE_PRELOAD_HANDLE_DEX = 102;//dex加载异常int CODE_PRELOAD_NOT_ZIP_FORMAT = 103;//基线dex非zip格式异常int CODE_PRELOAD_REMOVE_BASEDEX = 105;//基线dex处理异常//加载阶段的code说明 分三部分dex加载, resource加载, lib加载//dex加载int CODE_LOAD_UNDEFINED = 71;//未定义异常int CODE_LOAD_AES_DECRYPT = 72;//aes对称解密异常int CODE_LOAD_MFITEM = 73;//补丁SOPHIX.MF文件解析异常int CODE_LOAD_COPY_FILE = 74;//补丁拷贝异常int CODE_LOAD_SIGNATURE = 75;//补丁签名校验异常int CODE_LOAD_SOPHIX_VERSION = 76;//补丁和补丁工具版本不一致异常int CODE_LOAD_NOT_ZIP_FORMAT = 77;//补丁zip解析异常int CODE_LOAD_DELETE_OPT = 80;//删除无效odex文件异常int CODE_LOAD_HANDLE_DEX = 81;//加载dex异常// 反射调用异常int CODE_LOAD_FIND_CLASS = 82;int CODE_LOAD_FIND_CONSTRUCTOR = 83;int CODE_LOAD_FIND_METHOD = 84;int CODE_LOAD_FIND_FIELD = 85;int CODE_LOAD_ILLEGAL_ACCESS = 86;//resource加载public static final int CODE_LOAD_RES_ADDASSERTPATH = 123;//新增资源补丁包异常//lib加载int CODE_LOAD_LIB_UNDEFINED = 131;//未定义异常int CODE_LOAD_LIB_CPUABIS = 132;//获取primaryCpuAbis异常int CODE_LOAD_LIB_JSON = 133;//json格式异常int CODE_LOAD_LIB_LOST = 134;//lib库不完整异常int CODE_LOAD_LIB_UNZIP = 135;//解压异常int CODE_LOAD_LIB_INJECT = 136;//注入异常
七、生成补丁
下载补丁生成工具:https://help.aliyun.com/document_detail/93826.html?spm=a2c4g.11186623.4.4.a49654828syxUy
https://help.aliyun.com/document_detail/61082.html?spm=a2c4g.11186623.6.561.2b6b5c560xzkid
https://www.jianshu.com/p/19ca976804ce
本文来自互联网用户投稿,文章观点仅代表作者本人,不代表本站立场,不承担相关法律责任。如若转载,请注明出处。 如若内容造成侵权/违法违规/事实不符,请点击【内容举报】进行投诉反馈!
