Android中关于JNI 的学习（零）简单的例子，简单地入门

2021-07-24 11:56:58

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

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

JniTest类：

public class JniTest {

	public native String getTestString();
}

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

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

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

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

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

我们可以看到其名称是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吧，如下：

在这里，我们也把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命令，如下：

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

到这里，关于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()方法，最终显示结果如下：