Android JNI开发入门

JNI在Android开发中使用的比较广泛，因为Android应用层是用Java实现，底层是c/c++实现的，所以应用层调用底层库时需要使用JNI。如果你熟悉java和c/c++的话，那么学习JNI主要需要掌握java和c/c++数据类型的转换、JNI语法和函数编写规则。下面首先介绍java基本类型和引用类型跟JNI本地相关类型的对照，然后完成一个简单的demo。

1. 对照表

Java类型 本地类型 描述
boolean jboolean C/C++8位整型
byte jbyte C/C++带符号的8位整型
char jchar C/C++无符号的16位整型
short jshort C/C++带符号的16位整型
int jint C/C++带符号的32位整型
long jlong C/C++带符号的64位整型e
float jfloat C/C++32位浮点型
double jdouble C/C++64位浮点型
Object jobject 任何Java对象，或者没有对应java类型的对象
Class jclass Class对象
String jstring 字符串对象
Object[] jobjectArray 任何对象的数组
boolean[] jbooleanArray 布尔型数组
byte[] jbyteArray 比特型数组
char[] jcharArray 字符型数组
short[] jshortArray 短整型数组
int[] jintArray 整型数组
long[] jlongArray 长整型数组
float[] jfloatArray 浮点型数组
double[] jdoubleArray 双浮点型数组

2.打开eclipse，创建一个Android应用，名称：AndroidNDKTest

(1)打开自动生成的MainActivity.java，添加内容如下：

[java]  view plain copy

1. public class MainActivity extends Activity {  
2.     /** Called when the activity is first created. */  
3.     @Override  
4.     public void onCreate(Bundle savedInstanceState)  
5.     {  
6.         super.onCreate(savedInstanceState);  
7.    
8.         TextView  tv = new TextView(this);  
9.         tv.setText( stringFromJNI() );  
10.         setContentView(tv);  
11.         printString("hello");  
12.     }  
13.    
14.     /** 
15.      * 从c/c++文件中返回字符串 
16.      * @return 
17.      */  
18.     public native String  stringFromJNI();  
19.    
20.     /** 
21.      * 在c/c++文件中打印log信息 
22.      * @param info 
23.      */  
24.     public native void printString(String info);  
25.    
26.     static {  
27.         System.loadLibrary("hello-jni");  
28.     }  
29. }  

上面代码中，我们声明了两个本地函数，在返回值前添加了native标志，表明是在c/c++定义实现的。
(2)在项目根目录下创建一个jni文件夹，创建一个hello-jni.c文件，内容如下：

[java]  view plain copy

1. #include <string.h>  
2. #include <jni.h>  
3. #include <android/log.h>  
4.    
5. JNIEXPORT jstring JNICALL  
6. Java_com_example_ndktest_MainActivity_stringFromJNI( JNIEnv* env,  
7.                                                   jobject thiz )  
8. {  
9.     return (*env)->NewStringUTF(env, "Hello from JNI !");  
10. }  
11.    
12. JNIEXPORT void JNICALL  
13. Java_com_example_ndktest_MainActivity_printString( JNIEnv* env,jobject thiz,jstring info)  
14. {  
15.     const jchar* strDest;  
16.     strDest = (*env)->GetStringUTFChars(env,info,NULL);  
17.     if(strDest == NULL)  
18.     {  
19.         return NULL;  
20.     }  
21.     __android_log_print(ANDROID_LOG_INFO, "printString", strDest);  
22.     (*env)->ReleaseStringUTFChars(env,info,strDest);  
23. }  

 

JNIEXPORT和JNICALL都是JNI的关键字，是一些宏，这里不写也可以(JNIEXPORT jstring JNICALL可以改成jstring)。java的String对象对应于jni的jstring类型，但是在本地方法中不能直接使用，需要先转换成char*，这里使用GetStringUTFChars方法将传进来的jstring类型转换成为UTF－8格式的char*，就能够在本地方法中使用了。注意：使用完你所转换之后的对象之后，需要显示调用ReleaseStringUTFChars方法，让JVM释放转换的对象的空间，如果不显示的调用的话，该对象不会被垃圾回收器回收，因此可能会导致内存溢出。
下面是访问String的一些方法：
GetStringUTFChars 将jstring转换成为UTF-8格式的char*
GetStringChars 将jstring转换成为Unicode格式的char*
ReleaseStringUTFChars 释放指向UTF-8格式的char*的指针
ReleaseStringChars 释放指向Unicode格式的char*的指针
NewStringUTF 创建一个UTF-8格式的String对象
NewString 创建一个Unicode格式的String对象
GetStringUTFLength 获取UTF-8格式的char*的长度
GetStringLength 获取Unicode格式的char*的长度

(3) 添加一个Android.mk，相当于makefile，用来实现自动化编译的。内如如下：

[html]  view plain copy

1. LOCAL_PATH := $(call my-dir)  
2.    
3. include $(CLEAR_VARS)  
4.    
5. LOCAL_LDLIBS := -llog  
6. LOCAL_MODULE    := hello-jni  
7. LOCAL_SRC_FILES := hello-jni.c  
8.    
9. include $(BUILD_SHARED_LIBRARY)  

这里添加了LOCAL_LDLIBS := -llog和hello-jni.c中添加了#include <android/log.h>头文件，是为了实现在c/c++代码中打印log信息的，以便在logcat中查看。
（4）配置ndk编译环境，这个在我的这篇文章里有详细说明。
(5)clean，然后运行程序，如果不出错，结果如下图：
模拟器

 

LogCat打印信息