Android移植NDK子项目--以android-gif-drawable为例

布满荆棘的人生 2022-09-21 13:06 171阅读 0赞

前言：

一些非常优秀的开源项目引入起来都是比较麻烦的，麻烦到都可以写一篇博客来引导后来人少踩坑的程度。我在最近一次项目中想要做一个GIF的展示功能，光是引入著名的gifhub开源项目[android-gif-drawable][]就花费了一番功夫，今天把我踩过的坑都记录一下，提醒一下准备使用这个开源库的盆友。

GIF三方库引入方式：

方式一：直接添加dependence

这种方式在Android studio中最简单的一种方式，只需打开build.gradle文件，加入这一句话即可。一般我引入三方库都直接使用这样的方法，简便快捷，仅需一行就完成了依赖的部署，然后clean一下项目就可以使用依赖库里的类和方法了。

dependencies {
        compile 'pl.droidsonroids.gif:android-gif-drawable:1.1.+'
    }

但是我这样引入以后再运行阶段出现一个crash 异常，如下：

AndroidRuntime: FATAL EXCEPTION: DBExecutor #1
            Process: com.demo.app, PID: 15616
            java.lang.UnsatisfiedLinkError: dalvik.system.PathClassLoader[DexPathList[[zip file "/system/framework/com.google.android.maps.jar", zip file "/data/app/com.demo.app-2/base.apk"],nativeLibraryDirectories=[/data/app/com.demo.app-2/lib/arm64, /vendor/lib64, /system/lib64]]] couldn't find "xxxx.so"
            at java.lang.Runtime.loadLibrary(Runtime.java:366)
            at java.lang.System.loadLibrary(System.java:988)
            at com.demo.utils.JConstantUtils.<clinit>(Unknown Source)
            at com.demo.handler.bk.<init>(Unknown Source)
            at com.demo.handler.bj.f(Unknown Source)
            at com.demo.handler.aq.a(Unknown Source)
            at com.demo.handler.aq.a(Unknown Source)
            at com.demo.handler.io.a(Unknown Source)
            at com.demo.handler.io.a(Unknown Source)
            at com.demo.handler.run(Unknown Source)
            at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1112)
            at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:587)
            at java.lang.Thread.run(Thread.java:818)

从字面意思上来看，是在执行System.load()方法的时候没有找到对应的.so文件，然后我解压apk安装包，发现该so文件还在armeabi文件夹和x86文件夹下。

![Center][]

![Center 1][]

但是我的项目里却多出了多个CPU平台的so库，比如arm64\_v8a,x86\_64等，根据上面的报错异常可以看出，安卓系统找不到arm64下的.so文件，因为arm64\_v8a文件夹全都是这个gif框架的so库，缺少本项目的so库。那么问题就显而易见了：

Android在加载时会根据当前cpu型号自动选择相应的so文件夹，然后加载里面的so库，如果我的apk里面有arm64\_v8a文件夹，我使用的又是Android5.0 64位CPU，但文件夹里面又没有我要加载的so库，即使armeabi文件夹里有也不管用，就会出现这个异常。

这个问题的坑人之处在于如果apk包里没有arm64\_v8a文件夹，系统会自动使用armeabi文件夹的so库顶上，也就是使用32位的方法兼容64位CPU，但是Android Studio在编译项目时将第三方库的64位so编译进了apk，而项目原本的so只有armeabi版本，所以导致加载so库失败。

要处理这个异常有两个途径，第一是使用ndk r11以上版本将本项目的so库编译出arm64\_v8a的so，misp的so，x86\_64等等so库，注意只有NDK r11以上版本才支持64位的编译，r10是在Android5.0发布之前发布的，安卓是在5.0之后才开始支持64位CPU，所以r10是不能编译arm和x86 64位版本的。

第一个途径有一个明显的弊端是so库使用的太多，会造成app的体积过大，而且如果原项目中依赖了其他的库，比如xUtils，它只提供了armeabi和x86的so，真是令人瞬间傻眼，所以就有了第二个解决途径。

方式二：使用aar包

第二类途径就是删掉一部分本项目没有而gif第三方库有的so，让两边的so库数量相同，这样就不会出现缺少某一CPU平台的问题了。该方案需要用到aar包。aar包可以看成是添加了相关图片资源文件的jar包，这个gif第三方库在github上也提供了它的arr包下载，如果你下载不成功的话，可以去github上下载该项目的源码，使用android studio打开，clean一下项目。然后到 ：项目根目录\\build\\outputs\\aar文件夹下，取得android-gif-drawable-master-debug.aar，打开后如下图：

![Center 2][]

现在只需要在这个aar文件中将armeabi，x86以外的文件夹删掉，就可以避免在编译时将不需要的so文件打入apk了。

那么如何将arr导入自己的项目作为依赖，网上有很多方法，下面说一种:

这里演示的aar文件为： ”genius.aar“  
第一步：拷贝到：libs目录  
第二步：build.gradle 配置文件中更改为

repositories {
        flatDir {
            dirs 'libs'
        }
    }
    dependencies {
        compile(name:'genius', ext:'aar')
    }

摘自：http://www.tuicool.com/articles/V7reai

这样就可以请可以轻松的将一个外部NDK项目导入到自己的项目中使用了。

但是如果我想把外部NDK项目的c/c++源码一并导入进来并进行修改，过程就比较复杂了

方式三：将第三方库的源码全部导入自己的项目

将外部NDK项目完全导入自己的项目步骤：

1、去github上下载项目zip源码

2、解压zip，并使用Android Studio打开该项目，就像打开普通项目一样，点击file--project stucture--设置NDK的路径，如下

![Center 3][]

注意NDK使用r11以上版本，因为r10版本没有Android 23的jar包

3、使用AndroidStudio 把这个项目clean一下

4、将第三方项目拷贝到自己项目的libraries文件夹下

5、使用Android Studio打开自己的项目，在build.gradle中添加如下内容（android-gif-drawable 是libraries 里面的文件夹的名字）

dependencies {
        compile fileTree(include: ['*.jar'], dir: 'libs')
        compile project(':libraries:android-gif-drawable')
       
    }

6、在settings.gradle中添加一行，并像刚才子项目一样添加NDK的依赖

![Center 4][]

include ':libraries:android-gif-drawable'

7、然后clean一下当前项目。然后进入点击file--project structure查看外部项目是否已经导入进了项目目录，如下

![Center 5][]

如果导入成功，那么就可以看下面的部分，如果导入不成功，一般是缺少build-tools等sdk的依赖，一般翻墙下载就能解决，或者在build.gradle修改min sdk version , build tools version 等.

8、修改子项目的so库编译选项

进入gif子项目的jni目录，如下，修改Application.mk中的APP\_ABI：all为APP\_ABI := armeabi x86，这样就可以只编译armeabi x86两个版本的so库，就可以和项目里其他的so库匹配起来了。

![Center 6][]

9、去掉子项目编译前的单元测试

我在使用Android Studio编译整个项目时，并由执行gif的单元测试，但是我在使用命令行gradle build命令时，会首先执行gif子项目的单元测试，一共21个测试项目，如果失败任何一个编译过程就会终止。所以需要关掉单元测试，方法是修改build.gradle文件并删除相关测试文件，下面gif依赖库的build.gradle注释掉的内容即为和单元测试有关的内容：

buildscript {
    	repositories {
    		jcenter()
    	}
    
    	dependencies {
    		classpath 'com.android.tools.build:gradle:2.1.0'
    		//classpath 'com.dicedmelon.gradle:jacoco-android:0.1.1'//不进行代码覆盖率的测试
    	}
    }
    
    apply plugin: 'com.android.library'
    //apply plugin: 'jacoco-android'//不进行代码覆盖率的测试
    apply from: 'gradle-mvn-push.gradle'
    apply from: 'ndk.gradle'
    
    repositories {
    	jcenter()
    }
    
    project.version = VERSION_NAME
    project.group = GROUP
    
    android {
    	compileSdkVersion 23
    	buildToolsVersion '23.0.2'//如果编译器说build tools version本机sdk没有，就选择一个本机sdk里有的版本
    	compileOptions {
    		sourceCompatibility JavaVersion.VERSION_1_7
    		targetCompatibility JavaVersion.VERSION_1_7
    	}
    	defaultConfig {
    		versionName project.version
    		minSdkVersion 8
    		targetSdkVersion 23
    		consumerProguardFiles 'consumer-proguard-rules.pro'
    	}
    }
    
    dependencies {
    	provided 'com.android.support:support-annotations:23.3.0'//如果这里报错请修改版本号并翻墙，下面的也是
    //	testCompile 'junit:junit:4.12'//在编译时会进行单元测试，大约21个，如果有任何一个测试没有通过就会终止编译，所以将所有单元测试去掉
    //	testCompile 'org.mockito:mockito-core:1.10.19'
    //	testCompile 'org.robolectric:robolectric:3.0'
    //	testCompile 'org.assertj:assertj-core:1.7.1'
    //	testCompile 'net.jodah:concurrentunit:0.4.2'
    }
    
    //jacocoAndroidUnitTestReport {//不进行代码覆盖率的测试
    //	html.enabled true
    //	xml.enabled true
    //}

删除相关单元测试的java文件，不然会报编译错误，如下：

![Center 7][]

现在子项目已经完全移植到自己的项目中，可以打包apk了。

[android-gif-drawable]: https://github.com/koral--/android-gif-drawable
[Center]: /images/20220721/308e2a2fcef34e928f9ea871bad664d0.png
[Center 1]: /images/20220721/66f6f85fa86b4a128908b2dbc6080825.png
[Center 2]: /images/20220721/ab27183a8f8d4c65ac01806ac83e36ed.png
[Center 3]: /images/20220721/18d64ef971814845a075fd2e84be761f.png
[Center 4]: /images/20220721/87c84d90f89345eebe7121fb7abc11a1.png
[Center 5]: /images/20220721/5e343316e37845b9baa81bddcf007ef3.png
[Center 6]: /images/20220721/d4d1be981848492a965493d04798cd35.png
[Center 7]: /images/20220721/71b77970bab64549a8a84c8f6f9b64f3.png