JNI注册本地方法

JNI注册本地方法分为两种:

  • 静态注册
  • 动态注册

静态注册

  • 静态注册主要体现在方法名称上。方法名称可以使用javah命令生成,也可以手动写。

1. javah命令生成

  1. 进入com所在目录 :cd app/src/main/java
  2. 使用javah命令生成头文件。
    例:javah com.***.***.NativeUtil
    此时会在java目录下生成和java类名(全类名)相同的.h头文件。
  3. 如果不想生成的.h文件名和java类名(全类名)一样长,可以使用-o指定生成的文件名。
    例:javah -o NativeUtil.h com.***.***.NativeUtil
  4. 如果不想生成的.h文件在java目录下,可以使用-d指定输出目录。
    例:
    javah -d ../cpp com.***.***.NativeUtil
    注:-o和-d不能同时使用。
  5. Window中使用时可能会报编码错误。此时使用-encoding utf-8指定文件编码为utf-8即可。
  6. 如果本地方法中包含有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());
}
  1. JNIEXPORT
    Window中宏定义:#define JNIEXPORT __declspec(dllexport)
    LInux/Unix中宏定义:#define JNIEXPORT
    注:在Windows中编译dll动态库规定,如果动态库中的函数要被外部调用,需要在函数声明中添加__declspec(dllexport)标识,表示将该函数导出在外部可以调用。在Linux/Unix系统中,这两个宏可以省略不加
  2. JNICALL
    Window中宏定义:#define JNICALL __stdcall
    LInux/Unix中宏定义:#define JNICALL
    注:用于约束函数入栈顺序和堆栈清理的规则。
  3. 方法命名规则
    Java_包名类名方法名(JNIEnv *, jobject, ...){}
    注:包名、类名、方法名中不能含有下划线,如果有则在下滑线后加1。
    例:public native String string_FromJNI();(java方法)
    Java_com_***_***_NativeUtil_string_1FromJNI (JNIEnv *env, jobject jobj)(本地方法名)。
    如果是静态native方法请把jobject改成jcalss。
  4. JNIEnv
    一个指向全部JNI方法的指针。该指针只在创建它的线程有效,不能跨线程传递。(从代码角度看:JNIEnv等价JNINativeInterface*,JNINativeInterface结构体定义了一些方法指针。)
  5. JavaVM
    虚拟机在JNI中的表示,一个JVM中只有一个JavaVM对象,这个对象是线程共享的。(从代码角度看:JavaVM等价JNIInvokeInterface*,JNIInvokeInterface结构体定义了一些方法指针。)

动态注册

准备

动态注册本地方法需要在JNI_OnLoad方法中进行,JNI_OnLoad方法会在加载动态库(System.loadLibrary("");)时候执行。
主要步骤:

  1. JavaVM获取JNIEnv。
  2. 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;
}

原创不易,您的支持是我最大的动力。

你可能感兴趣的:(JNI注册本地方法)