别人写好的动态库,需要自己写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里面调用头文件里面对应的方法。