SopHix接口说明

1 initialize方法

• initialize(): <必选>

  该方法主要做些必要的初始化工作以及如果本地有补丁的话会加载补丁, 但不会自动请求补丁。因此需要自行调用queryAndLoadNewPatch方法拉取补丁。这个方法调用需要尽可能的早, 必须在Application的attachBaseContext方法的最前面调用（在super.attachBaseContext之后，如果有Multidex，也需要在Multidex.install之后）, initialize()方法调用之前你需要先调用如下几个方法进行一些必要的参数设置, 方法调用说明如下:

• setContext(application): <必选> 传入入口Application即可

• setAppVersion(appVersion): <必选> 应用的版本号

• setSecretMetaData(idSecret, appSecret, rsaSecret): <可选，推荐使用> 三个Secret分别对应AndroidManifest里面的三个，可以不在AndroidManifest设置而是用此函数来设置Secret。放到代码里面进行设置可以自定义混淆代码，更加安全，此函数的设置会覆盖AndroidManifest里面的设置，如果对应的值设为null，默认会在使用AndroidManifest里面的。

• setEnableDebug(isEnabled): <可选> isEnabled默认为false, 是否调试模式, 调试模式下会输出日志以及不进行补丁签名校验. 线下调试此参数可以设置为true, 查看日志过滤TAG:Sophix, 同时强制不对补丁进行签名校验, 所有就算补丁未签名或者签名失败也发现可以加载成功. 但是正式发布该参数必须为false, false会对补丁做签名校验, 否则就可能存在安全漏洞风险

• setAesKey(aesKey): <可选> 用户自定义aes秘钥, 会对补丁包采用对称加密。这个参数值必须是16位数字或字母的组合，是和补丁工具设置里面AES Key保持完全一致, 补丁才能正确被解密进而加载。此时平台无感知这个秘钥, 所以不用担心阿里云移动平台会利用你们的补丁做一些非法的事情。

• setPatchLoadStatusStub(new PatchLoadStatusListener()): <可选> 设置patch加载状态监听器, 该方法参数需要实现PatchLoadStatusListener接口, 接口说明见1.3.2.2说明

• setUnsupportedModel(modelName, sdkVersionInt):<可选> 把不支持的设备加入黑名单，加入后不会进行热修复。modelName为该机型上Build.MODEL的值，这个值也可以通过adb shell getprop | grep ro.product.model取得。sdkVersionInt就是该机型的Android版本，也就是Build.VERSION.SDK_INT，若设为0，则对应该机型所有安卓版本。目前控制台也可以直接设置机型黑名单，更加灵活。

2 queryAndLoadNewPatch方法

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

• 应用原本没有补丁, 那么如果当前应用的补丁是热补丁, 那么会立刻加载(不管是冷补丁还是热补丁). 如果当前应用的补丁是冷补丁, 那么需要重启生效.

• 应用已经存在一个补丁, 请求发现有新补丁后，本次不受影响。并且在下次启动时补丁文件删除, 下载并预加载新补丁。在下下次启动时应用新补丁。

  补丁在后台发布之后, 并不会主动下行推送到客户端, 需要手动调用queryAndLoadNewPatch方法查询后台补丁是否可用.

• 只会下载补丁版本号比当前应用存在的补丁版本号高的补丁, 比如当前应用已经下载了补丁版本号为5的补丁, 那么只有后台发布的补丁版本号>5才会重新下载.

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

3 killProcessSafely方法

可以在PatchLoadStatusListener监听到CODE_LOAD_RELAUNCH后在合适的时机，调用此方法杀死进程。注意，不可以直接Process.killProcess(Process.myPid())来杀进程，这样会扰乱Sophix的内部状态。因此如果需要杀死进程，建议使用这个方法，它在内部做一些适当处理后才杀死本进程。

4 cleanPatches()方法

清空本地补丁，并且不再拉取被清空的版本的补丁。正常情况下不需要开发者自己调用，因为Sophix内部会判断对补丁引发崩溃的情况进行自动清空。

5 PatchLoadStatusListener接口

该接口需要自行实现并传入initialize方法中, 补丁加载状态会回调给该接口, 参数说明如下:

• mode: 无实际意义, 为了兼容老版本, 默认始终为0
• code: 补丁加载状态码, 详情查看PatchStatus类说明
• info: 补丁加载详细说明
• handlePatchVersion: 当前处理的补丁版本号, 0:无 -1:本地补丁 其它:后台补丁

常见状态码说明如下: 一个补丁的加载一般分为三个阶段: 查询/预加载/加载

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

//兼容老版本的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;//注入异常