我的第一个NDK程序

在上一篇文章中搭建好了Eclipse下NDK环境，现在开始NDK的开发：

1、打开Eclipse，新建一个Android Project，名字就叫AndroidNDKTest2吧

2、在项目的目录下新建一个名为jni的目录，然后在该目录下新建一个Android.mk文件，文件内容如下：

LOCAL_PATH := $(call my-dir)

include $(CLEAR_VARS)

LOCAL_MODULE    := test-jni
LOCAL_SRC_FILES := test-jni.c

include $(BUILD_SHARED_LIBRARY)

 

说明：

LOCAL_PATH := $(call my-dir)

一个Android.mk 文件首先必须定义好LOCAL_PATH变量。它用于在开发树中查找源文件。在这个例子中，宏函数’my-dir’, 由编译系统提供，用于返回当前路径（即包含Android.mk file文件的目录）。

 

include $( CLEAR_VARS)

CLEAR_VARS由编译系统提供，指定让GNU MAKEFILE为你清除许多LOCAL_XXX变量（例如 LOCAL_MODULE, LOCAL_SRC_FILES, LOCAL_STATIC_LIBRARIES, 等等...),
但第1行定义的LOCAL_PATH不在清空的范围内。因为所有的脚本都将粘贴到同一个GNU Make的执行上下文中，而且所有变量都是全局变量，因此必须在每次使用前清空所有以前用过的变量

LOCAL_MODULE := test-jni

编译的目标对象，LOCAL_MODULE变量必须定义，以标识你在Android.mk文件中描述的每个模块。名称必须是唯一的，而且不包含任何空格。

注意：编译系统会自动产生合适的前缀和后缀，换句话说，一个被命名为'hello-jni'的共享库模块，将会生成'libtest-jni.so'文件。

重要注意事项：

如果你把库命名为‘libtest-jni’，编译系统将不会添加任何的lib前缀，也会生成 'libtest-jni.so'，这是为了支持来源于Android平台的源代码的Android.mk文件，如果你确实需要这么做的话。

LOCAL_SRC_FILES := test-jni.c

LOCAL_SRC_FILES变量必须包含将要编译打包进模块中的C或C++源代码文件。注意，你不用在这里列出头文件和包含文件，因为编译系统将会自动为你找出依赖型的文件；仅仅列出直接传递给编译器的源代码文件就好。

注意，默认的C++源码文件的扩展名是’.cpp’. 指定一个不同的扩展名也是可能的，只要定义LOCAL_DEFAULT_CPP_EXTENSION变量，不要忘记开始的小圆点（也就是’.cxx’,而不是’cxx’）

include $(BUILD_SHARED_LIBRARY)

BUILD_SHARED_LIBRARY表示编译生成共享库，是编译系统提供的变量，指向一个GNU Makefile脚本，负责收集自从上次调用'include $(CLEAR_VARS)'以来，定义在LOCAL_XXX变量中的所有信息，并且决定编译什么，如何正确地去做。还有 BUILD_STATIC_LIBRARY变量表示生成静态库：lib$(LOCAL_MODULE).a， BUILD_EXECUTABLE 表示生成可执行文件。

 

3、在JNI目录下新建一个test-jni.c的C文件，内容为：

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

jstring Java_com_king_ndk_AndroidNDKTest2Activity_stringFromJNI( JNIEnv* env,
                                                  jobject this )
{
    return (*env)->NewStringUTF(env, "Hello,it is from king's JNI !");
}

说明：

jstring表示返回类型为java的String类型；函数名由Java_<调用函数的包名(com_king_ndk)>_类名_方法名

env代表java虚拟机环境，Java传过来的参数和c有很大的不同，需要调用JVM提供的接口来转换成C类型的，就是通过调用env方法来完成转换的。

obj代表调用的对象，相当于c++的this。当c函数需要改变调用对象成员变量时，可以通过操作这个对象来完成。

本例比较简单，不需要用到这两个参数。但是这两个参数在JNI中非常重要。

 

4、在AndroidNDKTest2Activity中调用该方法，AndroidNDKTest2Activity的内容如下：

package com.king.ndk;

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

public class AndroidNDKTest2Activity extends Activity {
    
	static{
		System.loadLibrary("test-jni");
	}
	
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        TextView text = new TextView(this);
        text.setText(stringFromJNI());
        setContentView(text);
    }
    
    public native String stringFromJNI();
}

说明：

static{ 
System.loadLibrary("test-jni"); 
}

表明程序开始运行的时候会加载test-jni, static区声明的代码会先于onCreate方法执行。

public native String stringFromJNI();

可以看到这个方法的声明中有 native 关键字， 这个关键字表示这个方法是本地方法，也就是说这两个方法是通过本地代码（C/C++）实现的，在java代码中仅仅是声明。

 

4、编译C文件：

打开Cygwin切换到你的项目的目录下：$ cd F:/AndroidPrograme/AndroidNDKTest2

然后使用$NDK/ndk-build命令编译打包C文件：

（PS：也可以

1、右键——>properties选择builder，弹出项目的编译工具列表，之后点击New，新添加一个编译器，点击后出现添加界面，选择Program，点  击OK，然后给编译配置起个名字，如：C_Builder

2、设置Location为<你cygwin安装路径>\bin\bash.exe程序，例如：D:\cygwin\bin\bash.exe，设置Working    Directory为<你cygwin安装路径>\bin目录，例如：D:\cygwin\bin

3、设置Arguments为

  --login -c "cd /cygdrive/f/AndroidPrograme/AndroidNDKTest2&& $NDK/ndk-build", 接着切换到Refresh选项卡，给Refresh resources upon completion打上钩

4、 然后切换到Build Options选项卡，勾选上最后三项

5、 之后点击Specify Resources按钮，选择资源目录，勾选你的项目目录即可

6、 最后点击Finish，点击OK一路把刚才的配置都保存下来，注意：如果你配置的编译器在其它编译器下边，记得一定要点Up按钮，把它排到第一位，否则C代码的编译晚于Java代码的编译，会造成你的C代码要编译两次才能看到最新的修改:

这样每次修改了test-jni.c之后Eclipse会自动编译，就不需要每次手工编译了。

）

Ok，刷新一下你的项目，可以看到已经生成了相应 的文件及目录，然后运行项目，可以看到调用JNI的结果。