Android Studio制作.so库实践

た入场券 2022-08-21 11:38 259阅读 0赞

# 前言 #

因为工作需要可能要用到JNI开发，本篇文章就分享一下我在这方面的实践，以前我们使用Eclipse做NDK开发，非常麻烦，需要配cygwin的编译环境，后面NDK功能完善才逐渐简单点，如果想了解Eclipse如何配置NDK编译环境可以参考我以前发表的旧文：

[Cocos2d-x 2.2.3 使用NDK配置编译环境][Cocos2d-x 2.2.3 _NDK]  
[JNI\_Android项目中调用.so动态库][JNI_Android_.so]

Eclipse的如何通过NDK生成so库就不多说了，目前已经不适用于Android开发，建议使用AS进行开发，本篇也是基于AS来进行讲解。

# 什么是JNI #

如果你进行Android开发一段时间还不知道什么是JNI的话，说明你还是初学者，没有理解Java层跟Native层之间是如何交互的。JNI（Java Native Interface的缩写），Java层通过JNI来调用Native层的功能模块，这样做的好处是能消除平台的差异性，避免重复制造轮子。Java的跨平台性也体现在这里。  
如何通过JNI调用Native层的c/c++代码，可以参考我的一篇文章：  
[JNI\_最简单的Java调用C/C++代码][JNI_Java_C_C]

> 注：window的动态库是.dll文件，而Linux下的动态库是.so文件

# 配置NDK #

如果翻不了墙，可以到这里下载相应平台的NDK版本  
[http://www.androiddevtools.cn/][http_www.androiddevtools.cn]

下载成功之后解压缩，然后配置系统环境变量，拿windows举例：  
先新建NDK\_HOME

![NDK\_HOME][NDK_HOME]

然后再添加到PATH环境变量中

![PATH环境变量][PATH]

ok，配好之后，直接可以在命令行使用ndk-build命令：

![ndk-build][]

这里提示没有定义NDK\_PROJECT\_PATH变量，暂且不管，我们后面说。

然后，在Android Studio配置NDK路径：

![AS配置NDK][AS_NDK]

上面是笔者的路径，具体按你们来配。

至此，NDK环境配置完毕。

# 定义Native方法 #

这里创建一个Android项目-JNIDemo，然后定义TestJNI类，代码如下：

package com.devilwwj.jnidemo;
    
    /** * Created by wwj_748 on 2016/4/27.15.47 */
    public class TestJNI { 
        public native boolean Init();
        public native int Add(int x, int y);
        public native void destory();
    }

# 使用javah命令生成.h文件 #

![javah命令生成.h文件][javah_.h]

执行完上面的命令之后，就生成了com\_devilwwj\_jnidemo\_TestJNI.h这个文件：

![com\_devilwwj\_jnidemo\_TestJNI.h][com_devilwwj_jnidemo_TestJNI.h]

ok，这样我们就可以进行下一步操作了。

# 创建jni目录，创建.cpp文件 #

![创建jni目录][jni]

然后根据.h文件，创建相对应的.cpp文件  
com\_devilwwj\_jnidemo\_TestJNI.cpp

//
    // Created by wwj_748 on 2016/4/27.
    //
    #include <stdio.h>
    #include <stdlib.h>
    #include "com_devilwwj_jnidemo_TestJNI.h"
    #include "Add.h"
    
    CAdd *pCAdd = NULL;
    
    JNIEXPORT jboolean JNICALL Java_com_devilwwj_jnidemo_TestJNI_Init(JNIEnv *env, jobject obj) {
      if (pCAdd == NULL) {
        pCAdd = new CAdd;
      }
      return pCAdd != NULL;
      }
    
    JNIEXPORT jint JNICALL Java_com_devilwwj_jnidemo_TestJNI_Add
      (JNIEnv *env, jobject obj, jint x, jint y) {
        int res = -1;
        if (pCAdd != NULL) {
            res = pCAdd->Add(x, y);
        }
        return res;
      }
    
      JNIEXPORT void JNICALL Java_com_devilwwj_jnidemo_TestJNI_destory
        (JNIEnv *env, jobject obj) {
        if (pCAdd != NULL) {
            pCAdd = NULL;
        }
        }

这里我还需要创建两个文件，CAdd.h和CAdd.cpp：

![CAdd.h][]

![CAdd.cpp][]

ok，到目前我们已经完成JNI层的实现了。

# 创建Android.mk和Application.mk文件 #

在jni目录下，我们需要创建两个mk文件

**Android.mk**

LOCAL_PATH := $(call my-dir)
    include $(CLEAR_VARS)
    
    LOCAL_MODULE := JNIDemo
    LOCAL_SRC_FILES := com_devilwwj_jnidemo_TestJNI.cpp
    LOCAL_SRC_FILES += Add.cpp
    
    include $(BUILD_SHARED_LIBRARY)

其中LOCAL\_PATH是C/C++代码所在目录，也就是我们的jni目录。  
LOCAL\_MODULE是要编译的库的名称。编译器会自动在前面加上lib，在后面加上.so。  
LOCAL\_SRC\_FILES是要编译的C/C++文件。

**Application.mk**

APP_ABI := all

表示生成所有平台的动态库。

# 配置gradle #

在defaultConfig下，配置ndk：

ndk {
                moduleName "JNIDemo" // 生成的so名字
            }

在android标签内配置sourceSets：

sourceSets {
            main {
                jniLibs.srcDirs = ['libs']
            }
        }

生成的so文件都在src/main/libs目录下。

完整的gradle配置，可以看源码。

# 执行ndk-build命令生成所有cpu架构的so库 #

![ndk-build生成库][ndk-build 1]

然后就可以在libs目录下看到所有平台的so库：

![so库生成][so]

至此，完整的so库实践基本完毕，期间遇到任何问题均可留言，欢迎讨论交流。

# 最后 #

关于NDK开发so库会有很多坑，本篇博客也只是引大家入门，我们在使用第三方的SDK的时候，就可能会用到别人提供的so库，也可能会遇到使用so库出现问题，有很多原因，可能是提供了不同的cpu架构的so库，在其他平台出现的crash或者是其他问题，相信我们会遇到的问题别人也会遇到，这时候google一下也许能找到解决方案，最后祝生活愉快。

--------------------

欢迎关注我的公众号：wwjblog  
![wwjblog][]

[Cocos2d-x 2.2.3 _NDK]: http://blog.csdn.net/wwj_748/article/details/30072379
[JNI_Android_.so]: http://blog.csdn.net/wwj_748/article/details/28300451
[JNI_Java_C_C]: http://blog.csdn.net/wwj_748/article/details/28136061
[http_www.androiddevtools.cn]: http://www.androiddevtools.cn/
[NDK_HOME]: /images/20220724/b8dee035985d42b7851877f49eddc3cb.png
[PATH]: /images/20220724/0f8c309451e14bfea454eef1ab377aed.png
[ndk-build]: /images/20220724/eb0065250b2444df843421cbaec01dad.png
[AS_NDK]: /images/20220724/5d832f4eaa8e44498a999d488c9fd822.png
[javah_.h]: /images/20220724/04066ca06f0d4ee7babe43a6d99e9c74.png
[com_devilwwj_jnidemo_TestJNI.h]: /images/20220724/c8e2950b9c434adb95042a93137bfed9.png
[jni]: /images/20220724/8bc07e67e9754e8aa19e57b32cf0216c.png
[CAdd.h]: /images/20220724/8af31ee7c6ad45b39770ef15690a14ed.png
[CAdd.cpp]: /images/20220724/1c5ff002610e4e82b59f4ed58075fcb3.png
[ndk-build 1]: /images/20220724/2d6105a2aada46759ef23346b6f628e2.png
[so]: /images/20220724/49c248de223c4f88b6c5a937eb80289d.png
[wwjblog]: https://raw.githubusercontent.com/fanatic-mobile-developer-for-android/A-week-to-develop-android-app-plan/master/images/wwjblog.jpg