Android JNI 使用的数据结构JNINativeMethod详解 ||建立Android SDK下的JNI、JAVA应用完整步骤---Android JAVA调用C++代码

    Andoird 中使用了一种不同传统Java JNI的方式来定义其native的函数。其中很重要的区别是Andorid使用了一种Java 和 C 函数的映射表数组，并在其中描述了函数的参数和返回值。这个数组的类型是JNINativeMethod，定义如下：

 

 

typedef struct {

const char* name;

const char* signature;

void* fnPtr;

} JNINativeMethod;

 

第一个变量name是Java中函数的名字。

 

第二个变量signature，用字符串是描述了函数的参数和返回值

 

第三个变量fnPtr是函数指针，指向C函数。

 

 

其中比较难以理解的是第二个参数，例如

 

"()V"

 

"(II)V"

 

"(Ljava/lang/String;Ljava/lang/String;)V"

 

 

实际上这些字符是与函数的参数类型一一对应的。

 

"()" 中的字符表示参数，后面的则代表返回值。例如"()V" 就表示void Func();

 

"(II)V" 表示 void Func(int, int);

 

 

具体的每一个字符的对应关系如下

 

 

字符 Java类型 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

 

 

数组则以"["开始，用两个字符表示

 

 

[I       jintArray      int[]

[F     jfloatArray    float[]

[B     jbyteArray    byte[]

[C    jcharArray    char[]

[S    jshortArray   short[]

[D    jdoubleArray double[]

[J     jlongArray     long[]

[Z    jbooleanArray boolean[]

 

 

上面的都是基本类型。如果Java函数的参数是class，则以"L"开头，以";"结尾中间是用"/" 隔开的包及类名。而其对应的C函数名的参数则为jobject. 一个例外是String类，其对应的类为jstring

 

 

Ljava/lang/String; String jstring

Ljava/net/Socket; Socket jobject

 

 

如果JAVA函数位于一个嵌入类，则用$作为类名间的分隔符。

 

例如 "(Ljava/lang/String;Landroid/os/FileUtils$FileStatus;)Z"

===============================================================================================================================

在开发Android应用的过程中，通常有两种方式：NDK和eclipse，或者直接在Android SDK增加。这里介绍如何在Android SDK环境中增加一个应用程序。其中涉及到JNI，JAVA对JNI的调用，其中JNI代码文件为C++。

 

---

  第一步，建立JNI层代码，注意，JNI代码的路径与JAVA的代码路径有很大的关系，一定要保持一致。

   在frameworks/base/core/jni目录下建立JNI C++文件android_test.cpp,内容如下：

 

#define LOG_TAG "FMC"

 

#include "jni.h"

#include "android_runtime/AndroidRuntime.h"

#include <nativehelper/JNIHelp.h>

 

#include "utils/Log.h"

 

 

 

extern "C" {

      int test(void);//此函数可以来自c代码或c库

 

};

 

 

namespace android   //注意名称空间和JAVA调用JNI所有的路径有紧密的关系，不能随便取名称空间。

{

static jint android_test(JNIEnv *env, jobject clazz)

{

return test();

}

 

 

static JNINativeMethod method_table[] = {

{ "my_test", "()I", (void*)android_test}, //第一个参数为字串，这是JAVA层看到的函数名；

//第二个参数为该函数的形参说明，

//JAVA代码就是靠这个参数知道所调用函数的形参情况；

//第三个参数为JNI代码中实际调用的C函数。

}

 

int register_android_test(JNIEnv *env)//这是JNI注册函数,android.test就是java调用层(第三步)看到的包路径,

//如果这里是register_android_hardware_test,

//那么JAVA调用层需要导入android.hardware.test包

 

{

return AndroidRuntime::registerNativeMethods(env, "android/test/Test",method_table,NELEM(method_table));

/*这里的第二个参数和应用层java文件调用包的路径有关联，"android/test/Test"字符串参数和

frameworks/base/core/java/android/test/Test.java完整路径是对应的，对应的包路径是anroid.test,android.test.Test*/

}

 

 

};

 

---

第二步，把JNI代码注册函数添加到AndroidRuntime运行时库中。编辑frameworks/base/core/jni/AndroidRuntime.cpp文件：

按照文件上的方法对应的增加以下两行：

..........

extern int register_android_test(JNIEnv* env);//这是android_test.cpp文件中的注册函数

..........................

static const RegJNIRec gRegJNI[] = {

.........

.........

REG_JNI(register_android_test),

.........

.......

};

 

 

 

---

第三步，建立JAVA调用层，在frameworks/base/core/java/android/test 目录下建立文件Test.java,内容如下：

 

 

package android.test;

 

 

/**

 * Native methods for managing fm.

 *

 * {@hide}

 */

public class Test {

private native int my_test();//Android 应用的代码中最终能调用的就是这个代码

 

public Test()//构造函数

{

//Add Your Code Here.............

}

};

 

 

---

第四步，在packages/apps/test目录下建立你的android应用（具体建立方法这里就不再作介绍），假设test_app.java是应用的主文件，则内容如下：

package com.app;

 

import android.test;//导入自己的包

 

在代码中这样使用：

test   test;

test.my_test();//最终调用