转至:http://blog.sina.com.cn/s/blog_4c451e0e0101339i.html
Android Jni 用动态库的加载与卸载函数说明
一、当 Android 的 Virtual Machine 执行到 System.loadLibrary( "动态库名" ) 函数时,
首先会去执行 C 语言动态库里的 JNI_OnLoad 函数。
它的用途有两个:
1)告诉 Virtual Machine 当前动态库使用了哪个版本的 Jni。
如果当前动态库中没有提供 JNI_OnLoad 函数,
Virtual Machine 会默认为动态库使用的是最老的 Jni 1.1 版本。
由于新版 Jni 做了许多扩充,例如 Jni 1.4 的 java.nio.ByteBuffer。
2)动态库的开发者可以在 JNI_OnLoad 函数中进行动态库内的初始化设置(Initialization),
将此动态库中提供的各个本地函数(Native Function)登记到 Virtual Machine 里,
以便能加快以后调用动态库中的本地函数的效率,就是初始化设置的重要一项。
应用层级的 Java 类通过 Virtual Machine 才能调用到动态库中的本地函数。
如果没有注册登记过的话,Virtual Machine 就在 动态库名.so 里寻找要调用的本地函数。
如果需要连续调用很多次且每次都需要寻找一遍的话,会多花许多时间。
因此 C 语言动态库开发者可以自已将动态库中的本地函数向 Virtual Machine 进行注册登记。
代码示例:(注:由于新浪博客不支持 C 注释,所以请将 /^ ^/ 想像替换为 /星 星/)
jint
JNI_OnLoad( JavaVM* vm,
void* reserved )
{
jint jintResult = -1;
JNIEnv* env = NULL;
/^Reference types, in C.
typedef void* jobject;
typedef jobject jclass; ^/
jclass cls = NULL;
/^ typedef struct {
const char* name; /^ Java 代码中调用的函数名字 ^/
const char* signature; /^ 描述了函数的 参数 和 返回值 ^/
void* fnPtr; /^ 函数指针转成无符号指针 ^/
} JNINativeMethod;
其中比较复杂的是第二个参数,
例如 "()V" 或 "(II)V" 或 "(Ljava/lang/String;)V"
实际上这些字符是与函数的 参数 及 返回值 类型是一一对应的,
括号()中的字符表示参数,括号后面的则代表返回值,
例如 "()V" 就表示 void 函数名();
"(II)V" 就表示 void 函数名( int, int );
"(Ljava/lang/String;)V" 就表示 void 函数名( jstring );
具体的每一个字符所表示的意义下面部分有所详见 ^/
/^ 动态库中的本地函数信息数组 ^/
JNINativeMethod aJNINativeMethod[] = {
{ "MeasureDistance",
"(Ljava/lang/String;)V",
(void*)Java_MyJni_MyNDK_MyDemo_MyJniNDKDemo_MeasureDistance }
};
/^ #if defined(__cplusplus)
typedef _JNIEnv JNIEnv;
typedef _JavaVM JavaVM;
#else
typedef const struct JNINativeInterface* JNIEnv;
typedef const struct JNIInvokeInterface* JavaVM;
#endif ^/
/^ JavaVM::GetEnv 原型为 jint (*GetEnv)(JavaVM*, void**, jint); ^/
/^ GetEnv()函数返回的 Jni 环境对每个线程来说是不同的,^/
/^ 因此我们必须在每次进入函数时都要重新获取 ^/
if ( JNI_OK != (*vm)->GetEnv( vm,
(void**)env,
JNI_VERSION_1_6 ) )
{
/^ 输出的 log 一般是到 /dev/log/ 下的三个设备中,可以用 logcat 工具查看 ^/
__android_log_write( ANDROID_LOG_INFO, /^ 日志信息 ^/
"MyJniDemo", /^ 日志标签 ^/
"Call JavaVM::GetEnv failed" ); /^ 日志内容 ^/
return jintResult; /^ 此时返回的是负壹(-1) ^/
}
/^ 如果 将动态库中的本地函数向 Virtual Machine 进行注册登记失败 的话,则 ^/
/^ 由于 aJNINativeMethod 是一组 函数名称 与 函数指针 的对照表,
在程序执行期间可以多次调用registerNativeMethods函数来更换注册登记本地函数 ^/
/^ #if defined(__cplusplus)
typedef _JNIEnv JNIEnv;
typedef _JavaVM JavaVM;
#else
typedef const struct JNINativeInterface* JNIEnv;
typedef const struct JNIInvokeInterface* JavaVM;
#endif ^/
/^ Reference types, in C.
typedef void* jobject;
typedef jobject jclass; ^/
/^ struct JNINativeInterface 里的函数指针
jint (*RegisterNatives)( JNIEnv*,
jclass,
const JNINativeMethod*,
jint ); ^/
cls = (*env)->FindClass( env,
/^ 下面的字符串就是描述 Java 代码中的主类 ^/
"MyJni/MyNDK/MyDemo/MyJniNDKDemo" );
if ( 0 > (*env)->RegisterNatives( env,
cls,
aJNINativeMethod,
sizeof( aJNINativeMethod ) /
sizeof( aJNINativeMethod[0] ) ) )
{
/^ 输出的 log 一般是到 /dev/log/ 下的三个设备中,可以用 logcat 工具查看 ^/
__android_log_write( ANDROID_LOG_INFO, /^日志信息^/
"MyJniDemo", /^日志标签^/
"Register native methods failed" ); /^日志内容^/
return jintResult; /^ 此时返回的是负壹(-1) ^/
}
jintResult = JNI_VERSION_1_6;
/^ 此函数回传 JNI_VERSION_1_6 宏值给 Virtual Machine,
于是 Virtual Machine 就知道当前动态库所使用的 Jni 版本了 ^/
return jintResult; /^ JNI_VERSION_1_6(0x00010006) ^/
}
二、JNI_OnUnload 函数与 JNI_OnLoad 函数相对应。
在 JNI_OnLoad 函数中进行的动态库内的初期化设置,
要在 Virtual Machine 释放该动态库时调用 JNI_OnUnload 函数来进行善后清除。
同 Virtual Machine 调用 JNI_OnLoad 一样,
调用 JNI_Unload 函数时,也会将 JavaVM 的指针做为第一个参数传递,原型如下:
jint
JNI_OnUnload( JavaVM* vm,
void* reserved );
三、JNINativeMethod::signature 描述字符串字符意义说明:
1)基本类型对应关系:
标识符 Jni 类型 C 类型
V void void
Z jboolean boolean
I jint int
J jlong long
D jdouble double
F jfloat float
B jbyte byte
C jchar char
S jshort short
2)基本类型数组:(则以 [ 开始,用两个字符表示)
标识串 Jni 类型 C 类型
[Z jbooleanArray boolean[]
[I jintArray int[]
[J jlongArray long[]
[D jdoubleArray double[]
[F jfloatArray float[]
[B jbyteArray byte[]
[C jcharArray char[]
[S jshortArray short[]
3)类(class):(则以 L 开头,以 ; 结尾,中间是用 / 隔开的 包 及 类名)
标识串 Java 类型 Jni 类型
L包1/包n/类名; 类名 jobject
例子:
Ljava/net/Socket; Socket jobject
4)例外(String 类):
标识串 Java 类型 Jni 类型
Ljava/lang/String; String jstring
5)嵌套类(类位于另一个类之中,则用$作为类名间的分隔符)
标识串 Java 类型 Jni 类型
L包1/包n/类名$嵌套类名; 类名 jobject
例子:
Landroid/os/FileUtils$FileStatus; FileStatus jobject