目的:在windows平台上,使用android ndk创建一个简单的.so动态库,并使用jni调用其函数。
当前开发环境:
- Android开发工具:Android Studio 2.3.1
- Android NDK版本:12.1.2977051
- JDK版本:1.8
我的原则:
尽量减少生成so的过程与Android Studio本身的关联,也就是说Android Studio中的的工程只负责调用so,至于生成过程,Android Studio最好少参与。
步骤:
1. 新建工程添加Java接口
Android Studio新建一个测试工程,添加一个接口类:JNInterface(ps:名字随便起),代码为:
public class JNInterface
{
static {
System.loadLibrary("interface");
}
public static native String stringFromJNI();
}
我的工程的目录结构:
2. 编译工程至成功
这个很简单,在Android Studio中build工程即可
3. 通过 javah 命令编译刚才定义的接口类"JNInterface",生成对应c语言使用的.h头文件
因为javah.exe文件在jdk的bin目录下,所以在系统环境变量"Path"中添加"C:\Program Files (x86)\Java\jdk1.8.0_131\bin";(对照自己机器上jdk的安装路径)
运行cmd,打开windows命令行窗口。为了最简单的使用javah(不想加 -classpath等参数),我先把当前位置cd到intermediates\classes\debug目录下:
然后输入命令:javah -jni com.example.temp.jnitest.JNInterface
执行后对应的头文件就生成在当前目录下了
4. 添加c/c++源文件
在工程的src\main下面新建一个叫"jni"的目录,把刚才生成的com_example_temp_jnitest_JNInterface.h拷到此目录中。
然后再在这个目录中创建一个.c文件,名字随便取,我的叫"JNInterface.c"。编辑这个c文件,添加如下内容:
#include "com_example_temp_jnitest_JNInterface.h"
JNIEXPORT jstring JNICALL Java_com_example_temp_jnitest_JNInterface_stringFromJNI(JNIEnv * env, jclass jcls)
{
return (*env)->NewStringUTF(env, "Android Studio NDK JNI !");
}
学过c/c++的都不会陌生
5. 添加编译文件
在jni目录下新建:"Android.mk"、"Application.mk"两个文件
Android.mk中添加内容为:
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := interface
LOCAL_SRC_FILES =: JNInterface.c
include $(BUILD_SHARED_LIBRARY)
说明:
LOCAL_PATH 定义了当前模块的相对路径(必须出现在所有编译模块之前)
每个编译模块是由include $(CLEAR_VARS) 开始,由include $(BUILD_XXX) 结束
include $(CLEAR_VARS) 会清空除LOCAL_PATH之外的所有LOCA_XXX变量
include $(BUILD_XXX) 描述了编译目标
LOCAL_MODULE := interface 指定了生成的.so文件的名字,一般生成的时候前面还会自动加上lib
LOCAL_SRC_FILES =: JNInterface.c 指定了源文件名(基于LOCAL_PATH的相对路径)
Application.mk中添加内容为:
APP_MODULES := interface
APP_ABI := all
说明:
APP_ABI 指明了编译与调试的CPU架构,它可以是:
APP_ABI := all 指明支持所有版本,当然也可以指定支持的版本,比如:
APP_ABI := armeabi,armeabi-v7a
6. 生成.so文件
以上工作都完成后,我们要开始生成.so文件了:
因为ndk-build命令在android sdk的ndk-bundle目录下,所以我们像添加javah那样,在系统环境变量"Path"中添加"D:\Android\android-sdk-windows\ndk-bundle";(对照自己机器上ndk-bundle的路径)
同样,为了在windows命令行中最简单的使用ndk-build命令,我把当前位置cd到项目的jni目录下,然后运行ndk-bundle,如下:
至此,各个版本的so文件已经生成
7. 配置gradle,并编译工程
进入工程的build.gradle,在android { }中添加:
sourceSets
{
main {
jni.srcDirs = [] //disable automatic ndk-build call
jniLibs.srcDirs = ['src/main/libs']
}
}
其中:
jniLibs.srcDirs = ['src/main/libs'] 指定了动态库的目录
jni.srcDirs = [ ] 是要加的,否则编译工程会出现下面错误:
Error:Execution failed for task ':app:compileDebugNdk'.
> Error: Your project contains C++ files but it is not using a supported native build system.
Consider using CMake or ndk-build integration with the stable Android Gradle plugin:
https://developer.android.com/studio/projects/add-native-code.html
or use the experimental plugin:
https://developer.android.com/studio/build/experimental-plugin.html.
这是因为AndroidStudio想自己自动生成Android.mk进行编译,而不是用你已经设置好的。
到了此时,相关动态库的配置和生成工作已经全部完成。
我们在JNInterface.java中设置的接口函数是:public static native String stringFromJNI();
我们可以使用一个TextView测试一下接口返回的内容是否正确,比如在MainActiviy的onCreate()中添加:
TextView textView = (TextView) findViewById(R.id.text);
textView.setText(JNInterface.stringFromJNI());
ok,编译整个工程,运行: