JNI注册本地方法分为两种:
静态注册
- 静态注册主要体现在方法名称上。方法名称可以使用javah命令生成,也可以手动写。
1. javah命令生成
- 进入com所在目录 :
cd app/src/main/java
- 使用javah命令生成头文件。
例:javah com.***.***.NativeUtil
此时会在java目录下生成和java类名(全类名)相同的.h头文件。- 如果不想生成的.h文件名和java类名(全类名)一样长,可以使用-o指定生成的文件名。
例:javah -o NativeUtil.h com.***.***.NativeUtil
- 如果不想生成的.h文件在java目录下,可以使用-d指定输出目录。
例:
javah -d ../cpp com.***.***.NativeUtil
注:-o和-d不能同时使用。- Window中使用时可能会报编码错误。此时使用-encoding utf-8指定文件编码为utf-8即可。
- 如果本地方法中包含有Bitmap等对象需要-cp指定Bitmap所在的jar包。
例:javah -o NativeUtil.h -cp /***/***/Android/sdk/platforms/android-26/android.jar:. com.***.***.NativeUtil
:号前是Bitmap所在jar包,.代表当前目录。
2. 生成方法解释
例:
JNIEXPORT jstring JNICALL >>Java_com_***_***_NativeUtil_stringFromJNI (JNIEnv *env, jobject jobj) { std::string hello = "Hello from C++"; return env->NewStringUTF(hello.c_str()); }
- JNIEXPORT
Window中宏定义:#define JNIEXPORT __declspec(dllexport)
LInux/Unix中宏定义:#define JNIEXPORT
注:在Windows中编译dll动态库规定,如果动态库中的函数要被外部调用,需要在函数声明中添加__declspec(dllexport)标识,表示将该函数导出在外部可以调用。在Linux/Unix系统中,这两个宏可以省略不加 - JNICALL
Window中宏定义:#define JNICALL __stdcall
LInux/Unix中宏定义:#define JNICALL
注:用于约束函数入栈顺序和堆栈清理的规则。 - 方法命名规则
Java_包名类名方法名(JNIEnv *, jobject, ...){}
注:包名、类名、方法名中不能含有下划线,如果有则在下滑线后加1。
例:public native String string_FromJNI();
(java方法)
Java_com_***_***_NativeUtil_string_1FromJNI (JNIEnv *env, jobject jobj)
(本地方法名)。
如果是静态native方法请把jobject改成jcalss。 - JNIEnv
一个指向全部JNI方法的指针。该指针只在创建它的线程有效,不能跨线程传递。(从代码角度看:JNIEnv等价JNINativeInterface*,JNINativeInterface结构体定义了一些方法指针。) - JavaVM
虚拟机在JNI中的表示,一个JVM中只有一个JavaVM对象,这个对象是线程共享的。(从代码角度看:JavaVM等价JNIInvokeInterface*,JNIInvokeInterface结构体定义了一些方法指针。)
动态注册
准备
动态注册本地方法需要在JNI_OnLoad
方法中进行,JNI_OnLoad
方法会在加载动态库(System.loadLibrary("");
)时候执行。
主要步骤:
- JavaVM获取JNIEnv。
- JNIEnv注册java和C/C++方法。
下面是代码:
jstring stringFromJNI(
JNIEnv *env) {
std::string hello = "Hello from C++";
return env->NewStringUTF(hello.c_str());
}
/*
* JNINativeMethod数组。
* JNINativeMethod结构体包含三个元素。
* 第一个元素:java中的方法名。
* 第二个元素:方法签名。
* 第三个元素:C/C++中对应方法的指针。
*/
JNINativeMethod methods[] = {
{"stringFromJNI","()Ljava/lang/String;",(void*)stringFromJNI}
};
/**
* 注册本地方法。成功返回0,否则返回负数。
* @param pEnv
* @return
*/
int registerNativeMethods(JNIEnv *pEnv) {
jclass clazz = pEnv->FindClass("com/linuxpara/ndkexample/MainActivity");
//调用Env环境中的注册方法。
// 第一个实参:clazz是注册方法的类的字节码。
// 第二个实参:methods为JNINativeMethod结构体数组,
// 第三个参数为注册方法的个数。
return pEnv->RegisterNatives(clazz,methods, sizeof(methods)/ sizeof(methods[0]));
}
JNIEXPORT jint JNI_OnLoad(JavaVM* vm, void* reserved){
JNIEnv* env = NULL;
//通过JavaVM获取JNIEnv,成功后返回JNI_OK
jint result = vm->GetEnv((void **) &env, JNI_VERSION_1_6);
if (result != JNI_OK || env == NULL){
return -1;
}
if (registerNativeMethods(env) < 0){
return -1;
}
return JNI_VERSION_1_6;
}
原创不易,您的支持是我最大的动力。