Eclipse之NDK配置

一、关于NDK:
NDK全称：Native Development Kit。 
1、NDK是一系列工具的集合。 
NDK提供了一系列的工具，帮助开发者快速开发C（或C++）的动态库，并能自动将so和java应用一起打包成apk。这些工具对开发者的帮助是巨大的。 
NDK集成了交叉编译器，并提供了相应的mk文件隔离CPU、平台、ABI等差异，开发人员只需要简单修改mk文件（指出“哪些文件需要编译”、“编译特性要求”等），就可以创建出so。 
NDK可以自动地将so和Java应用一起打包，极大地减轻了开发人员的打包工作。 
2、NDK提供了一份稳定、功能有限的API头文件声明。 
Google明确声明该API是稳定的，在后续所有版本中都稳定支持当前发布的API。从该版本的NDK中看出，这些API支持的功能非常有限，包含有：C标准库（libc）、标准数学库（libm）、压缩库（libz）、Log库（liblog）。


二、NDK实例的实现：
对于Windows环境下NDK的开发，如果使用的NDK是r7之前的版本，必须要安装Cygwin才能使用NDK，所以为Eclipse需要配置的builder，其实是执行Cygwin，然后传递ndk-build作为参数。在NDKr7开始，Google的Windows版的NDK提供了一个ndk-build.cmd的脚本，这样，就可以直接利用这个脚本编译，而不需要使用Cygwin了。只需要为Eclipse Android工程添加一个Builders，就能让Eclipse自动编译NDK。


本文是讲述NDK-r7下的实现实例。
下面是使用NDK-r7在windows下配置自动编译的builders的过程（实际上对于Linux，只需要修改ndk-build.cmd为ndk-build就可以了。）。
（1）先下载安装NDK-r7。
下载地址： http://developer.android.com/sdk/ndk/index.html
下载后解压缩就可以用了。
（2）打开Eclipse，新建一个Android工程（我的取名为TestNdk），在工程目录TestNdk下新建jni文件夹，该文件夹就用来保存NDK需要编译的文件代码等。
（3）新建并配置一个Builder：
  （a）Project->Properties->Builders->New，新建一个Builder。 
  （b）在弹出的【Choose configuration type】对话框，选择【Program】，点击【OK】： 
  （c）在弹出的【Edit Configuration】对话框中，配置选项卡【Main】。
       在“Name“中输入新builders的名称（我取名为Ndk_Builder）。
       在“Location”中输入nkd-build.cmd的路径。
      （我的是D:\AndroidDev\android-ndk-r7\ndk-build.cmd，根据各自的ndk路径设置，也可以点击“Browser File System…”来选取这个路径）。
       在“Working Diretcoty”中输入${workspace_loc:/TestNdk}（也可以点击“Browse Workspace”来选取TestNdk目录）。
 
  （d）【Edit Configuration】对话框中，配置选项卡【Refresh】。
      勾选“Refresh resources upon completion”，
      勾选“The entire workspace”，
      勾选“Recuresively include sub-folders”。
 
  （e）【Edit Configuration】对话框中，配置选项卡【Build options】。
      勾选“After a “Clean””，
      勾选“During manual builds”，
      勾选“During auto builds”，
      勾选“Specify working set of relevant resources”。
 
      点击“Specify Resources…”
      勾选TestNdk工程的“jni“目录，点击”finish“。 
点击“OK“，完成配置。
OK，到这里Eclipse就能够自动调用NDK编译jin目录下的C/C++代码了。
（4）在TestNdk工程中新建一个JniClient.class（为了调用C/C++代码） ，其内容如下：

[java]  view plain copy

1. package com.ndk.test;  
2.   
3.   
4. public class JniClient {  
5.   
6.   
7.     static public native String AddStr(String strA, String strB);  
8.     static public native int AddInt(int a, int b);  
9. }  

（5）用cmd命令定位到JniClient.class 所在目录，输入“javac JniClient.java“后回车，生成JniClinet.class文件（如果是用的Eclipse建的工程，在TestNdk\bin\classes\com\ndk\test目录下就已经有JniClinet.class文件了）。
（6）将JniClinet.class拷贝到TestNdk\bin\classes\com\ndk\test目录，将cmd命令定位到TestNdk\bin\classes目录，输入”javah com.ndk.test.JniClient“后回车，在TestNdk\bin\classes目录下就生成了C++头文件com_ndk_test_JniClient.h。com_ndk_test_JniClient.h的文件内容如下：

[cpp]  view plain copy

1. /* DO NOT EDIT THIS FILE - it is machine generated */  
2. #include <jni.h>  
3. /* Header for class com_ndk_test_JniClient */  
4.   
5.   
6. #ifndef _Included_com_ndk_test_JniClient  
7. #define _Included_com_ndk_test_JniClient  
8. #ifdef __cplusplus  
9. extern "C" {  
10. #endif  
11. /* 
12.  * Class:     com_ndk_test_JniClient 
13.  * Method:    AddStr 
14.  * Signature: (Ljava/lang/String;Ljava/lang/String;)Ljava/lang/String; 
15.  */  
16. JNIEXPORT jstring JNICALL Java_com_ndk_test_JniClient_AddStr  
17.   (JNIEnv *, jclass, jstring, jstring);  
18.   
19.   
20. /* 
21.  * Class:     com_ndk_test_JniClient 
22.  * Method:    AddInt 
23.  * Signature: (II)I 
24.  */  
25. JNIEXPORT jint JNICALL Java_com_ndk_test_JniClient_AddInt  
26.   (JNIEnv *, jclass, jint, jint);  
27.   
28.   
29. #ifdef __cplusplus  
30. }  
31. #endif  
32. #endif<span style="font-family:'Comic Sans MS';"><span style="font-size: 18px;">  
33. </span></span>  

（7）在jni目录下新建一个Android.mk文件，其内容如下（详细的语法以后再另外解释）：

[html]  view plain copy

1. LOCAL_PATH := $(call my-dir)  
2. include $(CLEAR_VARS)  
3. LOCAL_MODULE := TestNdk  
4. LOCAL_SRC_FILES := com_ndk_test_JniClient.c  
5. include $(BUILD_SHARED_LIBRARY)  

（8）将com_ndk_test_JniClient.h拷贝到TestNdk工程的jni目录下， 然后新建一个com_ndk_test_JniClient.c文件完成头文件中函数的实现，其内容如下（本来Java_com_ndk_test_JniClient_AddStr是想完成字符串相加的功能的，但数据转换有点问题，想先写完本文档，后续再研究jni数据类型的问题，所以只简单的返回一个字符串。）：

[cpp]  view plain copy

1. #include "com_ndk_test_JniClient.h"  
2. #include <stdlib.h>  
3. #include <stdio.h>  
4.   
5.   
6. #ifdef __cplusplus     
7. extern "C"    
8. {     
9. #endif    
10. /* 
11.  * Class:     com_ndk_test_JniClient 
12.  * Method:    AddStr 
13.  * Signature: (Ljava/lang/String;Ljava/lang/String;)Ljava/lang/String; 
14.  */  
15. JNIEXPORT jstring JNICALL Java_com_ndk_test_JniClient_AddStr  
16.   (JNIEnv *env, jclass arg, jstring instringA, jstring instringB)  
17. {  
18.     jstring str = (*env)->NewStringUTF(env, "HelloWorld from JNI !");  
19.     return str;         
20. }  
21.   
22.   
23. /* 
24. * Class:     com_ndk_test_JniClient 
25. * Method:    AddInt 
26. * Signature: (II)I 
27. */  
28. JNIEXPORT jint JNICALL Java_com_ndk_test_JniClient_AddInt  
29.   (JNIEnv *env, jclass arg, jint a, jint b)  
30. {  
31.     return a + b;  
32. }  
33.   
34.   
35. #ifdef __cplusplus     
36. }     
37. #endif<span style="font-family:'Comic Sans MS';font-size:18px;">  
38. </span>  

编辑com_ndk_test_JniClient.c并保存后，可以看到TestNkd工程下的obj/local/armeabi目录下将自动生成libTestNdk.so库。


（9）在TestNdkActivity.java中完成对JniClient.java中函数的调用：

[java]  view plain copy

1. package com.ndk.test;  
2.   
3.   
4. import android.app.Activity;  
5. import android.os.Bundle;  
6. import android.widget.TextView;  
7.   
8.   
9. public class TestNdkActivity extends Activity {  
10.     static {  
11.         System.loadLibrary("TestNdk");  
12.     }  
13.   
14.   
15.     /** Called when the activity is first created. */  
16.     @Override  
17.     public void onCreate(Bundle savedInstanceState) {  
18.         super.onCreate(savedInstanceState);  
19. //        setContentView(R.layout.main);  
20.           
21.         String str = JniClient.AddStr("prefix", "suffix");  
22.           
23.           
24.         int iSum = JniClient.AddInt(5, 2);          
25.         String strSum = "5 + 7 = " + iSum;  
26.           
27.         TextView tv1 = new TextView(this);  
28.         tv1.setText(str);  
29.         setContentView(tv1);  
30.     }  
31. }  

（10）运行TestNdk工程，在模拟器中可以看到界面输出来自com_ndk_test_JniClient.c 文件中的“HelloWorld from JNI ! “。


OK，NDK实例到此完成。后续就可以深入的学习NDK/JNI了，比如C/C++与Java的数据类型转换，Android.mk文件的编写格式等。