ndk配置+android jni开发笔记

一、NDK配置

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

一、关于NDK的一点解释:                                                                                             

NDK全称：Native Development Kit。 

NDK提供了一系列的工具，帮助开发者快速开发C（或C++）的动态库，并能自动将so和java应用一起打包成apk。这些工具对开发者的帮助是巨大的。 
NDK集成了交叉编译器，并提供了相应的mk文件隔离CPU、平台、ABI等差异，开发人员只需要简单修改mk文件（指出“哪些文件需要编译”、“编译特性要求”等），就可以创建出so。

NDK可以自动地将so和Java应用一起打包，极大地减轻了开发人员的打包工作。

二、NDK坏境搭建：                                                                                                   

  注意事项：目前已经出了NDK-r9b了，由于作者写这篇日志的时候 当时下载的还是NDK-r8c，所以仍以NDK-r8c为例来讲解。

操作类似，从ndk-7后，谷歌已经改良了ndk的操作，不需用使用cygwin来交叉编译了，这大大的提高了我们的开发速度。

（1）下载安装NDK-r8c。

下载地址：http://developer.android.com/sdk/ndk/index.html

（2）打开Eclipse，新建一个Android工程（我的取名为TestNdk），在工程目录TestNdk下新建jni文件夹，该文件夹就用来保存NDK需要编译的文件代码等。

（3）开始新建并配置一个Builder

（a）Project->Properties->Builders->New，新建一个Builder。 

在“Location”中输入nkd-build.cmd的路径(这个是下载完ndk8后解压后的路径，这个建议放在根目录下面，路径不能有空格和中文)。根据各自的ndk路径设置，也可以点击“Browser File System…”来选取这个路径。 

图1

（b）在弹出的【Choose configuration type】对话框，选择【Program】，点击【OK】： 
（c）在弹出的【Edit Configuration】对话框中，配置选项卡【Main】。 
在“Name“中输入新builders的名称（这个名字可以任意取）。
在“Working Diretcoty”中输入TestNdk位置（也可以点击“Browse Workspace”来选取TestNdk目录）。如图1
勾选“Refresh resources upon completion”， 
勾选“The entire workspace”， 
勾选“Recuresively include sub-folders”。
勾选“After a “Clean””，(勾选这个操作后，如果你想编译ndk的时候，只需要clean一下项目 就开始交叉编译) 
勾选“During manual builds”， 
勾选“During auto builds”， 
勾选“Specify working set of relevant resources”。如图3

（d）继续在这个【Edit Configuration】对话框中，配置选项卡【Refresh】。如图2 

图2

（e）继续在【Edit Configuration】对话框中，配置选项卡【Build options】。 

图3

点击“Specify Resources…”勾选TestNdk工程中新建的“jni“目录，点击”finish“。 点击“OK“，完成配置。 如图4

图4

到此，恭喜你，编译环境以及成功搭建完毕！

然而，这并没有完。我们常常会出现找不到NDKROOT的情况，导致NDK编译在eclipse中无法成功，但在命令行中可以成功。我们还需要在项目右键->Properties->C/C++Build->Environment中Add一个名字为NDKROOT且值为...\android-ndk-r11b（这是NDK的路径）的一个环境变量。

二、android jni的配置方法

1、jni\Application.mk

Application.mk文件里的内容如下:

APP_STL:=gnustl_static
APP_CPPFLAGS:=-frtti -fexceptions 
APP_ABI:= armeabi-v7a 

2、jni\Android.mk

静态的opencv调用方法文件内容如下，其中OPENCV_LIB_TYPE:=SHARE则为动态调用opencv：

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)


OpenCV_INSTALL_MODULES:=on
OPENCV_CAMERA_MODULES:=off


OPENCV_LIB_TYPE:=STATIC


ifeq ("$(wildcard $(OPENCV_MK_PATH))","")
include D:\ProgramFile\OpenCV-2.4.9-android-sdk\sdk\native\jni\OpenCV.mk
else  
include $(OPENCV_MK_PATH)  
endif 


LOCAL_MODULE    := ProcessImg 
LOCAL_SRC_FILES := DetectFace_JNI.cpp \
src/copyToAssets.cpp \
src/detectFace.cpp
LOCAL_LDLIBS    += -lm -llog 

include $(BUILD_SHARED_LIBRARY) 

逐一解释下，OpenCV_INSTALL_MODULES:=on的意思是自动将依赖的OpenCV的so库拷贝到libs目录下，但很遗憾的是，这个命令只对OPENCV_CAMERA_MODULES有效。只有当OPENCV_CAMERA_MODULES:=on时，可以看到他会自动将里面的带camera的so拷贝至工程下的libs文件夹下。include D:\ProgramFile\OpenCV-2.4.9-android-sdk\sdk\native\jni\OpenCV.mk这句话比较关键，这是我安装OpenCV-2.4.9-android-sdk的地方，我将其安装到了D盘。而我的工作空间在E盘也是ok的。而不用像OpenCV2.3.1使用时，限制这个解压缩包的位置了。LOCAL_MODULE    是要生成的库的名字，LOCAL_SRC_FILES 是jni文件夹下的cpp文件，其中的src说明我的jni下还有个子文件夹名字是“src”，这块替换成自己的源码文件就ok了。

注意，如果将mk里的LOCAL_LDLIBS    += -lm -llog这一句错误的写为:LOCAL_LDLIBS    := -lm -llog，即将“+=”错写成了“：=”将会看到大量错误。

3、手动编写so的头文件JniClient.java。然后根据这个文件，可生成bin\package\JniClient.class(package为工程中包的名字，如com\example\test),然后再生成我们所需要的.h文件。

(1)用cmd命令定位到JniClient.class 所在目录，输入“javac JniClient.java“后回车，生成JniClinet.class文件（如果是用的Eclipse建的工程，在TestNdk\bin\classes\com\ndk\test目录下就已经有JniClinet.class文件了）。

JniClient.class（为了调用C/C++代码），其内容如下

package com.ndk.test; 
public class JniClient { 
static public native String AddStr(String strA, String strB); 
static public native int AddInt(int a, int b); }
}

(2)将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的文件内容如下：

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class com_ndk_test_JniClient */ 
#ifndef _Included_com_ndk_test_JniClient
#define _Included_com_ndk_test_JniClient
#ifdef __cplusplus
extern "C" { 
#endif
/*
* Class: com_ndk_test_JniClient
* Method: AddStr
* Signature: (Ljava/lang/String;Ljava/lang/String;)Ljava/lang/String;
*/
JNIEXPORT jstring JNICALL Java_com_ndk_test_JniClient_AddStr
(JNIEnv *, jclass, jstring, jstring); 
/*
* Class: com_ndk_test_JniClient
* Method: AddInt
* Signature: (II)I
*/
JNIEXPORT jint JNICALL Java_com_ndk_test_JniClient_AddInt
(JNIEnv *, jclass, jint, jint); #ifdef __cplusplus } 
#ifdef __cplusplus
}
#endif
#endif

将刚刚手动生成的com_ndk_test_JniClient.h拷贝到TestNdk工程的jni目录下，

(3)然后新建一个com_ndk_test_JniClient.c文件完成头文件中函数的实现，其内容如下

com_ndk_test_JniClient.c

#include "com_ndk_test_JniClient.h"
#include <stdlib.h>
#include <stdio.h> 
#ifdef __cplusplus 
extern "C" { 
{ 
#endif 
/*
* Class: com_ndk_test_JniClient
* Method: AddStr
* Signature: (Ljava/lang/String;Ljava/lang/String;)Ljava/lang/String;
*/
JNIEXPORT jstring JNICALL Java_com_ndk_test_JniClient_AddStr
(JNIEnv *env, jclass arg, jstring instringA, jstring instringB) { jstring str 
{
jstring str = (*env)->NewStringUTF(env, "HelloWorld from JNI !"); 
return str; } 
} 
/*
* Class: com_ndk_test_JniClient
* Method: AddInt
* Signature: (II)I
*/
JNIEXPORT jint JNICALL Java_com_ndk_test_JniClient_AddInt
(JNIEnv *env, jclass arg, jint a, jint b) { 
{
return a + b; } #ifdef __cplusplus } 
} 
#ifdef __cplusplus 
} 
#endif

此刻,当编辑com_ndk_test_JniClient.c并保存后，project下的—clean  一下工程，就可以看到TestNkd工程下的obj/local/armeabi目录下将自动生成libTestNdk.so库。

注意：此处.c与自动生成的.h一定要名字一致，并且.c中函数部分一定要用extern "C"包裹住，否则会出现找不到implement的bug。

(4)在TestNdkActivity.java中完成对JniClient.java中函数的调用(首先静态加载动态链接so库)：

package com.ndk.test; 
import android.app.Activity; 
import android.os.Bundle; 
import android.widget.TextView; 
public class TestNdkActivity extends Activity { 
static { System.loadLibrary(
System.loadLibrary("TestNdk"); } 
} 
/** Called when the activity is first created. */
@Override
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
// setContentView(R.layout.main); 
//第一个方法传入的两个参数没有做操作，直接返回hello jni，不用管
String str = JniClient.AddStr("test", "test"); 
//第二个方法暂时不实现 
// int iSum = JniClient.AddInt(5, 2); 
// String strSum = "5 + 7 = " + iSum; 
TextView tv1 = new TextView(this); tv1.setText(str); setContentView(tv1); } }
tv1.setText(str);
setContentView(tv1);
}
}

参考文献：

史上最易懂的Android jni开发资料--NDK环境搭建http://www.cnblogs.com/yejiurui/p/3476565.html

OpenCV4Android开发之旅(一)----OpenCV2.4简介及 app通过Java接口调用OpenCV的示例http://blog.csdn.net/yanzi1225627/article/details/16917961

OpenCV4Android+JNI开发快速上手入门http://my.oschina.net/cvnote/blog/180661?fromerr=RKLxOcNU

OpenCV4Android释疑: 透析Android以JNI调OpenCV的三种方式(让OpenCVManager永不困扰)http://blog.csdn.net/yanzi1225627/article/details/27863615