文档

热修复接入检查

更新时间:

热修复正式接入后CheckList

  1. 检查是否混淆,若有混淆必须-printmapping mapping.txt,发布版本后妥善保存代码和mapping.txt,不能修改。

  2. 检查是否加固,加固需要保存加固前的apk,并且若是梆梆加固,需配置忽略sophix文件夹。

  3. 检查是否关闭了资源优化:即在gradle.properties中新增android.enableResourceOptimizations=false。若资源优化开启,会导致代码比对异常,导致加载补丁时某些资源找不到。

  4. SophixStubApplication 类必须是java原生的,且不应与项目中的其他类有任何互相调用的逻辑,必须完全做到隔离。另外初始化时候不要判断进程。

  5. queryAndLoadNewPatch()是判断&请求新补丁发的方法,该方法会读取设备信息,请在隐私判断之后调用。SDK其他代码不会涉及隐私合规问题。最新SDK版本是3.3.7。

  6. 必须采用稳健接入,具体请参考SDK稳健接入

热修复更新补丁时CheckList

  1. 四大组件不能新增。AndroidManifest.xml,SophixStubApplication.java,build.gradle中的代码不能修改。

  2. 通知栏图标、启动图标资源以及RemoteViews等系统负责展示的资源也不能修改。

  3. 如果使用了混淆,新包-apply旧包的mapping.txt文件。确保新旧包混淆规则一致。

  4. 如果使用了加固,打包使用的新旧包必须是加固前的正常包。若是梆梆加固,需配置忽略sophix文件夹。

  5. 如果有SO库的修复,确保所需要修复的SO都是以System.loadLibrary的方式,而不是以具体路径的方式进行加载。

  6. asset资源和so文件的修改,最好配合代码修改:比如在调用处加一句log。以使修改生效。

  7. 基础包、修复包、补丁包三个版本号必须一致。如果基础包修改了代码后在其他渠道发布,则建议升级版本号,否则它加载了基础包生成的补丁会报错。

  8. 使用和同一个打包机来生成基础包和修复包, 打包机的更换可能导致apk代码对比出错。

  9. 请参考补丁发布推荐流程操作。

  10. running.log 是生成补丁时的代码对比log,其中的diff项目对应您的代码差异项。

发补丁前请检查此项是否符合预期,如果差异项过多或者只修改了一点代码但是补丁包很大的情况,请检查以上List。