阿里云首页

Hotfix补丁工具报错排查步骤

HotFix补丁工具报错排查步骤

使用补丁工具生成补丁报错

  • 1.遇到问题可以先通过常见问题页进行关键字搜索,或者使用云博士检索,一般都能命中相关的疑问。

  • 2.首先需要正确安装Java环境且在JDK7或以上才能正常使用,JDK6及以下需要卸载,如是Windows系统,并将C盘中Windows\System32和Windows\SysWOW64文件夹下的java.exe, javaw.exe and javaws.exe文件删掉。注:环境变量要配置,也就是等同于Android开发环境,如第一次配置环境变量,重启一下电脑;java安装包需在官网下载正版。

  • 3.MAC版本启动就崩溃,请将补丁工具移到“应用程序”目录下即可。

  • 4.生成补丁报错,提示no any patchClasses,这是因为打包apk的时候开启了instant run,造成apk内部的构造与不开启有差异,致使打补丁时对比不出新旧包的差异,导致修复不成功,要在打包apk的时候关闭instant run,新旧包都要重新生成,然后再打补丁包,重新应用补丁。

  • 5.生成补丁报错,提示没有资源差异等,解决办法:如没改动资源或so,可勾选不比较资源或so再次进行生成。

  • 6.如对应用进行加固,需在加固前使用补丁工具进行加固。

  • 7.如补丁工具在直接生成补丁过程时直接就崩溃,可能是工程中改了不能修改的部分,比如AndroidManifest清单文件,具体支持什么修复,可看Sophix是否支持任何代码和资源的修复?

  • 8.自工具3.2.1版本起,新增了检查初始化功能。

    • 快速接入时,初始化initialize放到manifest直接注册的Application的attachBaseContext中。

    • 如有用到MutiDex,MultiDex.install(this)需要在initialize之前调用。

    • queryAndLoadNewPatch方法不能在attachBaseContext中。

    • 快速和稳健接入都要:在initialize之前,不能调用非Android官方API类。

    • 如使用了MutiDex,并开启了混淆,在混淆规则中添加如下:

      //support库使用
      -keep class android.support.multidex.**{*;}
      //androidx库使用
      -keep class androidx.multidex.**{*;}
    • 如使用kotlin,使用JAVA语言写热修复初始化所在的Application类。原因:kotlin会自行先调用一个类。

    • 如有其他插件往初始化之前插入代码,自行设置该插件不往初始化所在的Application类插代码。

    • 如工具检查出的是匿名内部类,由于匿名内部类无法检查到具体类名,自行确定SophixStubApplication中无非系统API的使用,所以可以不勾选检查初始化。

  • 9.初始化所在的Application,新旧包保持完全一致,不要有改动。

  • 10.如开启了资源混淆resguard,需要将res/raw 和 res/mipmap下的xml资源需要keep住不做混淆。

  • 11.如提示dex不支持,将minSdkVersion设置15~21任一值,重新生成新旧包,再生成补丁。

  • 12.如是win10系统,上述问题定位完毕后,还是会有报错,修改一下程序兼容性或以管理员启动程序。

    补丁工具

若上述步骤仍未能定位问题,可以询问技术支持解决:技术支持

首页 Hotfix补丁工具报错排查步骤