在一次版本迭代后,突然在部分机型上爆出了一些崩溃,查看崩溃原因,原因内容是java.lang.NoClassDefFoundError:Failed resolution of: Lcom/apache/commons/desc/binary/Hex
,具体如下图:
比较蛋疼的是在这次版本迭代后才出现这个问题,而且是高版本手机有问题,10.0的测试机有问题,6.0的测试却没问题。
基于上述不同机型的表现,用代码验证下,org.apache.commons.codec.binary.Hex
这个类的加载情况,验证代码如下:
try {
Class.forName("org.apache.commons.codec.binary.Hex");
Log.e("HexTest","success");
} catch (ClassNotFoundException e) {
e.printStackTrace();
Log.e("HexTest","failed");
}
经过验证,在10.0的手机上输出的是falied
,6.0的手机上输出的是success
。
org.apache.commons.codec.binary.Hex
这个类到底是干嘛的?是哪个包下的呢?
全局搜索项目代码,没发现org.apache.commons.codec.binary.Hex
,这就表示这个类不是我们项目自己添加的依赖。
为了先解决问题,我就找到了相应的jar包,具体位于Apache Commons Codec,通过下面的方式给项目添加了依赖:
compile group: 'commons-codec', name: 'commons-codec', version: '1.14'
问题暂时解决了。
接下来我们来分析下出现这个问题的原因,问题的核心在于6.0的手机上是可以加载到这个类的,10.0的手机加载不到,初步猜测是手机系统内置了这个类,高版本的手机默认把这个类给hide了。
后来经过详细的排查本次迭代的代码,发现了一处可能的原因,就是编译版本compileSdkVersion
从27
升级到了28
,然后把compileSdkVersion
回退到27
,这个问题果然没了。
api 28对应的是Android 9,具体对应关系请看Android version history。
emmmmmm,现在的问题是compileSdkVersion
从27到28,跟这个apache的包hide起来有什么关系?
突然想起来Android6.0(也就是api 23)中移除了对Apache HTTP
客户端的支持,这个也是apache包,他们之间是不是有什么关系呢?我们看下官网,它的解释是这样的:
Apache HTTP 客户端弃用
在 Android 6.0 中,我们移除了对 Apache HTTP 客户端的支持。从 Android 9 开始,该内容库已从 bootclasspath 中移除,且默认情况下应用无法使用它。
我们找一个org.apache.http.legacy
的jar包分析一下,具体如下:
org.apache.http.legacy
包下有我们想要的org.apache.commons.codec.binary.Hex
类,那么我们可以参照官网提供的在高版本使用org.apache.http.legacy
建议即可,具体参考Apache HTTP 客户端弃用。
我们只需要在AndroidManifest.xml
中添加以下内容即可:
当然了,我们还可以用另一种方式,在模块的build.gradle
中添加如下代码即可:
android {
useLibrary ‘org.apache.http.legacy'
}
需要说明的是,我们每个版本的Android sdk中其实都是有org.apache.http.legacy
的jar包的,具体位于sdk/platforms/android-xx/options/
路径下,如下图:
至此,出现问题的原因搞明白了,我们平时能引用到org.apache.commons.codec.binary.Hex
类或者org.apache.commons.codec.binary.Base64
这些类,是因为Android自带的org.apache.http.legacy
jar包中包含了它们。如果你项目的compileSdkVersion
是api 28
及以上,那你就需要注意下这个问题了。
Apache HTTP 客户端弃用