Android中关于JNI 的学习(0)简单的例子,简单地入门

Android中关于JNI 的学习(零)简单的例子,简单地入门

Android中JNI的作用,就是让Java能够去调用由C/C++实现的代码,为了实现这个功能,需要用到Anrdoid提供的NDK工具包,在这里不讲如何配置了,好麻烦,配置了好久。。。

本质上,Java去调用C/C++的代码其实就是去调用C/C++提供的方法,所以,第一步,我们要创建一个类,并且定义一个Native方法,如下:

JniTest类:

public class JniTest {

	public native String getTestString();
}

可以看到,在这个方法的前面,用到了native关键字。

接着,我们要在命令行中编译这个java文件,得到一个class文件,如下:

Android中关于JNI 的学习(0)简单的例子,简单地入门

然后我们可以利用javah命令文件,生成一个C的头文件,其实javah这一步不是必需的,因为创建这个头文件,只是为了方便我们复制这个Jni中对应的方法名称,因为这些名称实在太复杂了。 

在这里有一点要注意,javah命令要在包的根目录下调用,对应的类文件,必须是完整的类名,如上图所示,会先回到src目录,再调用javah命令。

这样我们就会在src文件夹下在产生一个头文件,如下图所示:

Android中关于JNI 的学习(0)简单的例子,简单地入门

我们可以看到其名称是com_lms_jni_JniTest.h,其实就是包名+类名,我们可以看看里面的内容:

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class com_lms_jni_JniTest */

#ifndef _Included_com_lms_jni_JniTest
#define _Included_com_lms_jni_JniTest
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     com_lms_jni_JniTest
 * Method:    getTestString
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_lms_jni_JniTest_getTestString
  (JNIEnv *, jobject);

#ifdef __cplusplus
}
#endif
#endif

我们可以看到,在这里面有一个方法,名称是Java_com_lms_jni_JniTest_getTestString,够复杂吧,其实如果我们知道这个名称规则,并且知道如何去实现这样一个方法的话,我们是完全可以不生成这个头文件的,我们可以直接写出对应的C文件。

接下来,在jni文件中创建一个对应的C文件,名称是值得并无所谓,但为了统一,我们就把它叫JniTest.c吧,如下:

Android中关于JNI 的学习(0)简单的例子,简单地入门

在这里,我们也把com_lms_jni_JniTest.h也放到这里了,这个其实是没关系的,只是为了内容的协调和统一而已,一般情况下,我们会把所以由C/C++实现的文件都放在项目目录下一个叫 jni 的文件夹下面。

下面是在JniTest.c中实现native方法,getTestString,如下:

#include <stdio.h>
#include <stdlib.h>
#include <jni.h>

JNIEXPORT jstring JNICALL Java_com_lms_jni_JniTest_getTestString
  (JNIEnv *e, jobject obj){
	return (**e).NewStringUTF(e,"Hello from JniTest Function");
}

在这个c文件中,我们看到,并没有引用头文件com_lms_jni_JniTest.h,而只是引用了一般的C/C++库文件,比如stido.h和stdlib.h文件等,在这里注意到一点,我们还会引用jni.h文件,jni.h文件是JNI编程中很重要的一个头文件,关于Java中的数据类型跟jni中的数据类型的对应全部是在这个文件中定义的,后续会来看一下这个jni.h文件。

在上面JniTest.c文件中实现了方法之后,关于C/C++这边的实现其实也就实现了,那么接下来就是要将这个C文件编译成so文件由Android来调用。

为什么是so文件呢,这是因为Android本质上就是一个linux系统,所以其调用的JNI库文件,都是so形式。

Android提供的NDK库提供了ndk-build的命令来实现这个编译过程,但在此之前,我们要先创建一个Android.mk文件,这是一个简单的小小的Make文件,其内容如下:

LOCAL_PATH := $(call my-dir)

include $(CLEAR_VARS)

LOCAL_MODULE := com_lms_jni_HwDemo
LOCAL_SRC_FILES := \
HwDemo.c \
JniTest.c \

include $(BUILD_SHARED_LIBRARY)

在这里,我们会定义几个变量:

LOCAL_PATH:其值是call my-dir,而my-dir是个宏函数,会返回Android.mk所在的路径,在这里,就是jni文件夹。

include $(CLEAR_VARS),这个命令会清除掉所有LOCAL开头的变量,比如LOCAL_MODULE之类的,但有一个例外,就是其上面的LOCAL_PATH 。

LOCAL_MODULE:要生成的so包名,也是Android中Java代码加载时的名称。

LOCAL_SRC_FILES:要进行编译的源文件,如在这里,有HwDemo.c和JniTest.c等。

include $(BUILD_SHARED_LIBRARY):表明生成一个动态链接库。

定义后这样一个Android.mk文件之后,在命令行中调用ndk-build命令,如下:

Android中关于JNI 的学习(0)简单的例子,简单地入门

命令实行之后,我们可以在项目目录下看到libs中多了一个so库,如下:

Android中关于JNI 的学习(0)简单的例子,简单地入门

到这里,关于Jni实现的就结束了,接下来就是如何在Android中使用这个本地方法了。

我们创建了一个Activity,在它里面只放置一个TextView控件,它的布局如下:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" >

    <TextView
        android:id="@+id/tvJni"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="test" />

</LinearLayout>

然后在Activity中,我们要加载这个so库,如下:

public class HwDemo extends Activity {

	static {
		System.loadLibrary("com_lms_jni_HwDemo");//加载so库
	}
	
	public native String printHello();	

	@Override
	public void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);		
		setContentView(R.layout.main);
		TextView tv = (TextView)findViewById(R.id.tvJni);
		JniTest jniTest = new JniTest();//调用JniTest文件的方法
		tv.setText(jniTest.getTestString());
	}

}

1)利用static静态代码块,加载so库文件,可以看到在这里,这个名称就是Anrdoid.mk中定义的LOCAL_MODULE值。

2)创建JniTest对象,调用其getTestString()方法,最终显示结果如下:

Android中关于JNI 的学习(0)简单的例子,简单地入门

到这里,通过一个简单的例子,我们明白了如何在Android中利用JNI来调用C/C++的方法了。

最后,我们总结一下这几个步骤:

1)创建Java类文件,并定义Native方法,如JniTest类。

2)利用javac生成class文件,然后回到src目录,利用javah生成C/C++头文件,在这里要注意,javah命令要在包的根目录下调用,对应的类文件,必须是完整的类名,如下:

在Src目录:javah com.lms.jni.JniTest,在上面的截图,也可以看到javac之后,是回到src目录,再调用javah。

3)编写对应的C文件,如JniTest.c,在里面实现C/C++的方法,记得要放在jni文件夹下面。

4)编写Android.mk文件,利用ndk-build命令生成so文件。

5)在Android中利用static静态代码块,调用system.loadLibrary方法来加载so库文件。

6)在Java逻辑中调用之前定义的JniTest类的方法。

结束。源代码下载

1楼song849194554昨天 16:12
写的很详细,非常感谢,中间唯一不太清楚的地方是javah命令的使用,很多教程都有问题,不过自己解决了下已经通过了。
Re: foolsheep昨天 17:01
回复song849194554n不客气,至于 javah 的命令使用,需要在包的根目录下,也即com所在的文件夹下面,参数是包名+类名。。。这不清楚么?