初识Android NDK

本文介绍Windows环境下搭建Android NDK开发环境，并创建一个简单的使用Native代码的Android Application。

一、环境搭建

二、JNI函数绑定

三、例子

---

一、环境搭建

1. 操作系统：Windows7 64位

2. 安装Java，最新的JDK8貌似还不支持，敢于折腾的同学可以试试，下载JDK7安装即可，别忘了添加JDK的bin目录到PATH环境变量。http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html。"jdk-7u71-windows-x64.exe"

3. 下载Android ADT Bundle，https://developer.android.com/sdk/index.html。"adt-bundle-windows-x86_64-20140702.zip"

4. [可选]使用SDK Manager更新到最新，本文编辑之时API Level已经更新到21了。

5. 下载NDK开发包，解压即可，路径要固定不要轻易改动，因为Eclipse的NDK插件会配置这个路径。https://developer.android.com/tools/sdk/ndk/index.html。"android-ndk-r10b"

6. 安装NDK插件，在Eclipse中，打开菜单Help>Install New Software，Work with里用下拉菜单选择Android Developer Tools Update Site，下面就会出现Developer Tools的分组，展开选择Android Native Development Tool，点击Finish安装。不用选择Developer Tools里面其他的插件，它们已经安装好了。

从NDK r7开始就不需要使用cygwin了，因此以上就是所有的环境搭建步骤。

二、JNI函数绑定

先在Eclipse中创建一个Android Project。然后添加Native支持，在Project Explorer中右键选择新建的工程，在菜单中选择Android Tools>Add Native Support，会自动创建好JNI目录和Android.mk，以及配置好C\C++ Include路径。

JNI中Java方法调用Native方法的绑定有两种方法：一种是自动绑定，只需要C函数名和Java方法名称按照一定的规则能匹配上就能自动绑定。可以通过javah工具将绑定的规则都处理好，生成头文件方便使用，也可以根据规则自己定义函数，不使用生成头文件的方法。具体的规则是：

1. C函数要加上前缀"Java_"。

2. Java中package路径中的圆点要转换成下划线，类名和方法名都保持原样，用下划线隔开。

3. C方法中比Java方法多了两个参数放在最前面，JNIEnv*和jobject。前者是起到C代码和Java代码交互作用的一个结构体指针，后者是调用这个函数的Java对象在C代码中的代表。

4. Java调用Native方法还涉及到参数和返回值的传递，Java中的类型会转换为C中的对应类型，可以精确对应的类型有基本数据类型（如jint, jdouble）、数组（如jintArray）、String（jstring），其他类型一律当做Object（jobject）。

例如Java中定义的一个Activity的类：

package com.example.myhellojni;
public class MyHelloJniActivity extends Activity {
    private native String getNativeString();
}

在C文件中的对应函数：

jstring Java_com_example_myhellojni_MyHelloJniActivity_getNativeString(JNIEnv* env, jobject thiz) {
    return ...;
}

还有一种动态注册的方法，使得C代码定义的函数不必遵守命名规则也可以与Java中的方法绑定起来。这种绑定是在C代码中实现的，需要在加载这个动态链接库的时候的回调函数JNI_OnLoad中注册。注册方法见代码：

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

// 要绑定到Java的native方法
jstring ajey_getNativeString(JNIEnv* env, jobject thiz) {
    return (*env)->NewStringUTF(env, "what? this is a native string!!!!");
}

// 计算数组大小的小技巧，只能用于数组，不能用于指针（因为指针的sizeof得不到指针指向内存的大小）
#define SIZE_OF_ARRAY(array)  (sizeof(array)/sizeof(array[0]))

static JNINativeMethod gMethods[] = { // 这个结构体数组是传给register函数的参数，定义了java方法和C函数的对应关系
    // 成员依次是java方法名称、参数和返回值签名字符串、对应的C函数名
    { "getNativeString", "()Ljava/lang/String;", (void*)ajey_getNativeString },
};

static int registerNatives(JNIEnv* env) {
    // 先找到java的class。注意gMethods中并没有定义是哪个类的方法，需要在注册的时候指明。
    jclass clazz = (*env)->FindClass(env, "com/ajeyone/myhellojni/MyHelloJniActivity");
    if (clazz == NULL) {
        return JNI_FALSE;
    }
    // 这一步是真正注册的地方
    if ((*env)->RegisterNatives(env, clazz, gMethods, SIZE_OF_ARRAY(gMethods)) < 0) {
        return JNI_FALSE;
    }
    return JNI_TRUE;
}

jint JNICALL JNI_OnLoad(JavaVM* vm, void* reserved) {
    JNIEnv* env = NULL;
    // 第一步获取JNIEnv
    if ((*vm)->GetEnv(vm, (void**) &env, JNI_VERSION_1_4) != JNI_OK) {
        return -1;
    }
    // 第二步注册
    if (!registerNatives(env)) {
        return -1;
    }
    // 成功返回表示JNI version的常量，失败返回-1
    return JNI_VERSION_1_4;
}

以上代码有一个奇怪的地方：env指针（vm指针也是这样）使用这种方式来调用函数：(*env)->function(env, ...)，原因是JNIEnv实际上是typedef定义的指针类型，那么JNIEnv* env就是二级指针，因此需要(*env)->的方式来使用；而且有点像C++中对象成员函数的调用，但这些代码不是用C++编译的而是用C编译的，实际上是结构体中定义了函数指针，所以需要将"this"指针显式地传递过去，也就是env本身。jni.h中也为C++定义了基于对象的访问JNIEnv的方式，实际上是对C函数的包装，使其在C++中更容易使用，如果你的代码是写在cpp文件中的，那么使用的就是C++对象的方式，这时JNIEnv不再是一个typedef的指针，而是一个类类型，直接使用env->function(...)就行了，而且也不需要将env当做第一个参数传递给function。

三、例子

使用Android Tools>Add Native Development Support的时候，将Library名称定义成MyHelloJni。需要注意的是不要忘记写加载动态库的代码，否则肯定是找不到Native方法的。在Eclipse中C\C++代码不会在保存时自动编译，需要自己在菜单中选择Build或者在运行App时触发编译。

前面Java代码中Activity的全部内容：

package com.ajeyone.myhellojni;

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

public class MyHelloJniActivity extends Activity {

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		TextView text = new TextView(this);
		text.setText(getNativeString());
		setContentView(text); // 保持简单，未使用layout文件
	}

	private native String getNativeString();

	static { // 放在这里是一般的做法，如果有需求可以在其他地方加载
		System.loadLibrary("MyHelloJni"); // 千万不要忘了加载动态库
	}
}