Android NDK之JNI使用例子

 目前android NDK只能編譯出動態庫.so文件，並不是能生成.apk文件，這裡我們簡單介紹下NDK中的Hello JNI列子。整個例子分Java和Native C兩個部分。首先是我們常用的Java端調用部分。

package com.example.hellojni;

import android.app.Activity;
import android.widget.TextVIEw;
import android.os.Bundle;

public class HelloJni extends Activity
{
@Override
public void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);

TextView tv = new TextVIEw(this);
tv.setText( stringFromJNI() ); //如果調用失敗將會拋出 Java.lang.UnsatisfIEdLinkError異常
setContentVIEw(tv);
} //注意下面的native關鍵字

public native String stringFromJNI();
public native String unimplementedStringFromJNI();

static {
System.loadLibrary("hello-jni"); //載入hello-jni庫
}
}

需要注意的是這裡必須設置SDK版本為1.5或以上版本即在androidmanifest.XML文件中指明<uses-sdk android:minSdkVersion="3" /> 這裡我們看到JNI調用無需特殊的權限。

而在Native C/C++中我們可以直接使用C++庫，不過這裡包含了jni這個頭文件。

#include <string.h>
#include <jni.h>

其中下面的返回類型JString是VM String，在jni.h頭文件中有定義

JString Java_com_example_hellojni_HelloJni_stringFromJNI( JNIEnv* env, jobject thiz )
{
return (*env)->NewStringUTF(env, "Hello from JNI, android123 Test!");
}

其實很好理解的，僅僅是換個了別名而以，定義如下

typedef uint8_t jboolean; /* unsigned 8 bits */
typedef int8_t jbyte; /* signed 8 bits */
typedef uint16_t jchar; /* unsigned 16 bits */
typedef int16_t JShort; /* signed 16 bits */
typedef int32_t jint; /* signed 32 bits */
typedef int64_t jlong; /* signed 64 bits */
typedef float jfloat; /* 32-bit IEEE 754 */
typedef double jdouble; /* 64-bit IEEE 754 */
#else
typedef unsigned char jboolean; /* unsigned 8 bits */
typedef signed char jbyte; /* signed 8 bits */
typedef unsigned short jchar; /* unsigned 16 bits */
typedef short JShort; /* signed 16 bits */
typedef int jint; /* signed 32 bits */
typedef long long jlong; /* signed 64 bits */
typedef float jfloat; /* 32-bit IEEE 754 */
typedef double jdouble; /* 64-bit IEEE 754 */
#endif

typedef jint JSize;

還有一些調用平時注意的聲明

#define JNI_FALSE 0
#define JNI_TRUE 1

#define JNI_VERSION_1_1 0x00010001
#define JNI_VERSION_1_2 0x00010002
#define JNI_VERSION_1_4 0x00010004
#define JNI_VERSION_1_6 0x00010006

#define JNI_OK (0) /* no error */
#define JNI_ERR (-1) /* generic error */
#define JNI_EDETACHED (-2) /* thread detached from the VM */
#define JNI_EVERSION (-3) /* JNI version error */

#define JNI_COMMIT 1 /* copy content, do not free buffer */
#define JNI_ABORT 2 /* free buffer w/o copying back */

#define JNIIMPORT
#define JNIEXPORT
#define JNICALL