零、AndroidStudio 下载 NDK
在 SDK 管理器中下载如下三项,会下载到 SDK 所在目录下,如有需要,请自行配置环境变量。如果您选择 ndk-build 作为构建工具,则无需下载第二项。
一、构建工具配置
AS 目前支持两种构建工具,分别是 ndk-build 和 cmake,目前官方推荐 cmake。下面会分别介绍。
1、cmake 构建工具
(1)在 Module 根目录下新建 CMakeLists.txt 文件,配置项如下图。
(2)build.gradle 配置
必要配置:在 android 内部配置,用于指明 CMakeLists.txt 路径(即该文件无需必须放在 module 根目录下)。
可选配置一:指定ABI,在 defaultConfig 下配置
可选配置二:cmake 配置,更多配置参数参考 cmake 配置参数官方文档
2、ndk-build 构建工具
使用这种构建工具,需要两个配置文件 Android.mk 和 Application.mk,一般都放在 src/main/jni 目录下。亦可在 build.gradle 中配置路径,下面有说明。
(1)Android.mk,更多详细信息参考 Android.mk 官方文档
(2)Application.mk,主要配置这两个,更多配置参考 Application.mk 官方文档
(3)build.gradle 配置
必要配置:在 android 下配置,指明 Android.mk 路径
二、Java 调用 C
1、代码实现
(1)在 Java 类的 static 代码块中,使用 System.loadLibrary("so-name") 加载 so 库;
(2)在 Java 类中声明 native 方法,无需实现;
(3)在 C 代码中实现 native 方法。
说明:
(1)extern "C":实现 C 和 C++ 的混合编程,用于 C++ 代码调用 C 的函数。
(2)jint:返回值类型必须是 jni 数据类型,下面会详细介绍。
(3)方法名:必须是 Java_包名_类名_方法名。
(4)参数:该方法至少两个参数。第一个是 JNIEnv 指针,仅限当前方法域内使用;第二个参数根据方法是否是 static 而不同。如果是 static 方法,该参数为 jclass,调用时传入 Java 类对象;如果不是 static 方法,该参数为 jobject,调用时传入 Java 类的实例对象。这两个参数后面可有其他参数,为该方法的真正参数。
(5)使用 cmake 构建工具,c代码放在 src/main/cpp 目录下;使用 ndk-build 构建工具,代码放在 src/main/jni 目录下。
2、Java 对应 JNI 数据类型
(1)void 对应 Void。
(2)基本数据类型(byte boolean int char等)对应 jbyte jboolean jint等。
(3)基本数据类型数组 对应 jbyteArray jintArray等。
(4)Class 对应 jclass,String 对应 jstring,Throwable 对应 jthrowable。
(5)其他 Object 及其子类均对应 jobject,数组均对应 jobjectArray
说明:基本数据类型可以进行强制类型转换,其他类型均通过 JNIEnv 进行访问,例如访问数组长度使用 env->GetArrayLength(jXXXArray);访问数组元素使用 env->GetObjectArrayElement(jxxxArray, index)等。
三、C 调用 Java
1、获取 jclass 两种方式
(1)通过 jobject 获取:JNIEnv->GetObjectClass(jobject)
(2)通过包名:JNIEnv->FindClass(packagename/classname$innerclassname)
2、访问类属性 (static) 或对象属性
分为两步:首先获取属性 id,然后获取属性值
(1)获取属性 id:JNIEnv->GetStaticXxxFieldID 和 JNIEnv->GetXxxFieldID,Xxx 指属性的数据类型,可以省略。参数有三个,分别是 jclass, fieldname(属性名), fieldsign(属性签名)。
(2)获取属性值:JNIEnv->GetStaticXxxField(jclass, fieldid) 和 JNIEnv->GetXxxField(jobject, fieldid),Xxx 指属性数据类型,不可省略。
属性签名详解:
3、访问类方法 (static) 或对象方法
同样分为两步:第一步获取方法 id,第二步调用方法。
(1)获取方法 id:JNIEnv->GetMethodID 和 JNIEnv->GetStaticMethodID,参数有三个,jclass, methodname(方法名), methodsign(方法签名)。特别:构造函数的方法名为 "<init>"
(2)调用方法:JNIEnv->CallXxxMethod(jobject, methodid, params...) 和 JNIEnv->CallStaticXxxMethod(jclass, methodid, params...),Xxx 指返回值类型,params... 指调用方法所需要的参数。
方法签名详解:
由于 Java 支持方法重载,所以仅凭方法名可能不能找到唯一方法,因此通过方法签名的方式指定唯一方法。
格式:(按顺序参数类型签名)返回值类型签名
四、其他
1、JNI_OnLoad 和 JNI_OnUnload 方法
这两个方法是系统加载和卸载 JNI 时调用的方法,如需全局做一些什么事情,可以在这两个方法中做。
OnLoad 方法有一些必要的实现,如下图。您可以在此基础上进行自己的修改。
2、打印 Logcat
首先引入 android/log.h,然后定义一些宏,如下图。即可使用。
注意:ndk-build 构建工具需要在 Android.mk 添加 LOCAL_LDLIBS :=-llog
3、JNI 多线程
JNI 规定:jobject 及其子类和 JNIEnv 为单线程局部作用域拥有,不能多线程和外部作用域使用。但 JavaVM 是全局公用。
(1)JNIEnv 解决方案
在 OnLoad 方法中保存 JavaVM,在多线程和外部作用域使用 JavaVM->AttachCurrentThread 来获取当前环境的 JNIEnv,退出时调用 JavaVM->DetachCurrentThread。
(2)jobject 及其子类解决方案
使用 JNIEnv->NewGlobalRef(jobject) 获取全局引用,退出时调用 JNIEnv->DeleteGlobalRef(jobject)。
(3)classholder 方案
对于项目中使用到的 jclass,使用 classholder 进行管理,jclass 的全局引用作为类的静态变量,可以直接类调用。在 OnLoad 方法中进行初始化,OnUnload 中进行释放。
4、jstring to char[]、std::string
https://blog.csdn.net/xlxxcc/article/details/51106721