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();//最终调用