android jni 使用别人编译好的c/c++动态so库

别人写好的动态库，需要自己写jni包一层，这样就可以在java中调用这个库了。其实还有第二种方法，就是使用jna来调用，这样不用写jni，但是今天我们不讨论jna的用法。这里介绍如何在Android Studio中，编写jni调用他人的.so动态库。

复制动态库到项目

他人提供的库，需要包含头文件，和.so文件。

先看一下我的项目主要目录：

把他人提供的so库放在libs目录下，如图所示，我这里他人提供的 libtts.so 包含 armeabi 和 armeabi-v7a这两种，我全部放在了libs目录下。

在libs里面新建一个header目录，如图所示，把so库的头文件放在里面。

修改CmakeList.txt文件

在app目录下新建CmakeLists.txt文件，其实要是在Android Studio新建项目时勾选了使用c++，那么这个文件和一些其他配置已经有了，稍微修改就行。

先看一下我的CmakeList.txt文件：

# Sets the minimum version of CMake required to build the native
# library. You should either keep the default value or only pass a
# value of 3.4.0 or lower.

cmake_minimum_required(VERSION 3.4.1)

#引用已经有的库
find_library( # Sets the name of the path variable.
              log-lib

               # Specifies the name of the NDK library that
              # you want CMake to locate.
              log )

#资源文件夹的位置libs
set(distribution_DIR ${CMAKE_SOURCE_DIR}/../../../../libs)

#导入类库,只是作为引用,不编译
add_library( tts
             SHARED
             IMPORTED )

#引用目标类库是本地类库位置在libs/armeabi/xxx.so
set_target_properties( tts
                       PROPERTIES IMPORTED_LOCATION
                       ../../../../libs/${ANDROID_ABI}/libtts.so )

#添加类库位置在src/main/cpp/xxx.cpp需要编译
add_library(native-lib
             SHARED
             src/main/cpp/native-lib.cpp )

#引入头文件目录位置
include_directories(libs/header)

#将预构建库与你本地库相关联
target_link_libraries( # Specifies the target library.
                       native-lib tts

                       # Links the target library to the log library
                       # included in the NDK.
                       ${log-lib} )

在你的CmakeLists.txt中参照我这个写就行，也可以直接复制然后再根据你的项目来修改。

修改app目录下的 build.gradle 配置文件

先看下我的build.gradle 相关部分的配置：

...
android {
    compileSdkVersion 26
    defaultConfig {
        applicationId "com.smart.astts"
        minSdkVersion 16
        targetSdkVersion 26
        versionCode 1
        versionName "1.0"
        externalNativeBuild {
            cmake {
                cppFlags "-frtti -fexceptions"
            }
        }

        ndk {
            abiFilters "armeabi", "armeabi-v7a"
        }
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }

    // 设置so文件路径
    sourceSets {
        main {
            // let gradle pack the shared library into apk
            jniLibs.srcDirs = ['libs']
        }
    }
    externalNativeBuild {
        cmake {
            path "CMakeLists.txt"
        }
    }
}
...

参照这个修改即可。

编写jni代码

在目录app/src/main/ 下新建目录cpp,在cpp目录下添加native-lib.cpp文件，其实用Android Studio新建项目时勾选使用c++，这个文件已经自动新建好了。

在native-lib.cpp 里面就有编写我们自己的代码，主要功能是调用so库头文件里面的函数。jni里面的方法名不用自己手写，下面简单示例一下。

我在MainActivity.java中新建一个native方法，这个方法返回native提供的字符串。

 public native String stringFromJNI();

这时候这个方法是红色的，因为jni里面还没有与之对应的方法。

鼠标指针点到方法名上，键盘按 “Alt”+“Enter”键，出来快捷菜单，选中 “Create function ….” 按“Enter”键确认。现在 在native-lib.cpp文件里就有这个方法了。我们这个方法是要返回一个字符串，所以在native-lib.cpp稍微修改一下这个方法：

extern "C"
JNIEXPORT jstring JNICALL
Java_com_smart_astts_MainActivity_stringFromJNI(JNIEnv *env, jobject instance) {
    std::string hello = "Hello from C++";
    return env->NewStringUTF(hello.c_str());
}

加载jni库和so动态库

然后在MainActivity中静态加载我们编写的jni库，同时也并加载第三方的so库：

   static {
        System.loadLibrary("tts");
        System.loadLibrary("native-lib");
    }

运行，测试jni是否编译成功

运行一下，如果app成功调用了我们的native方法 stringFromJNI()，我们之前的配置就算写对了。

调用第三方so库的方法

接下来就可以根据第三方库的头文件，在java代码里写对应的native方法，然后在jni里面调用头文件里面对应的方法。