android下NDK开发环境搭建及TestJNI入门实例完整过程

1.先搭建好基本的ndk的开发环境

在windows下安装下面两个软件

1、 Android NDK 安装
2、 安装Cygwin与使用NDK编译

本文建立在已经完成Android开发环境搭建的基础上。其基础环境至少需要包含以下内容：

1、 JDK

2、 Eclipse

3、 Android SDK and ADT

一、Android NDK 安装与配置

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

下载后解压缩到你的工作目录，例如：D:\Java\android-ndk-r8，结果如下图：

注意：samples下面包含几个实例开发演示项目，第一次接触NDK开发，建议先从示例开始。

二、安装Cygwin与使用NDK编译

由于NDK开发大都涉及到C/C++在GCC环境下编译、运行，所以在Windows环境下，需要用Cygwin模拟Linux编译环境。

下载：

Cygwin的下载地址：http://www.cygwin.com/

点击右上角的“setup.exe”即可下载。

安装：

    第一步：运行setup.exe程序，直接点击Next进入下一步。

第二步：选择安装方式。第一次可以采用Direct Connection在线下载安装，如有现成的离线包，可以选择离线安装（Install from Local Directory）。

第三步：选择安装目录。比如D:\Java\Cygwin，注意此目录是指Cygwin最终的安装目录，不是下载文件暂存目录。

第四步：设置本地包暂存路径。暂存目录默认是放到setup.exe的同级目录下，建议放到指定的文件夹，如D:\Cygwin_install_file。安装完成后把这个文件夹打包备份，以后再配置时不用重新下载。

第五步：设置网络连接方式。这个目前河蟹没爬过来，选第一个即可。

第六步：选择下载站点地址。据说国内163站点的速度不错，我也是用的这个。

第七步：等待加载安装项载入，选择安装项。点击Devel-Default，使之变成Devel-Install，展开后可以看到其下的子项被选中了（网上多数教程都说选中某12个包，找起来太坑爹了，直接全下载了吧，全选多了150M左右）。此界面其他设置都不用动。

第八步：等待下载完成。下载完成时间决定于你选择的安装包数量及网络连接速度，安装我安装的版本，约983M，下载完成后会自动安装到上文设置的安装目录，安装也要时间的，总时间较长，去吃个饭没啥问题。

提醒：第四步的备份建议，尽量去做。如果有备份，第二步中选择离线安装。

验证:

运行安装目录下的“Cygwin.bat”，第一次运行时，它会自动创建用户信息，用户信息存放在“.\Cygwin\home”中。

在运行“Cygwin.bat”打开的命令行窗口输入：“cygcheck -c cygwin”命令，会打印出当前Cygwin的版本和运行状态，如果status是ok的话，则cygwin运行正常。

分别输入：“make –v”和，“gcc –v”命令如果检测成功，会有make和gcc相关版本信息打印出来。

设置NDK路径：

在windows的系统环境变量中添加NDK的路径。使用“/cygdrive/d/Java/android-ndk-r8”这种Linux风格路径，如果使用Windows下的“D:\Java\android-ndk-r8”，Cygwin在编译时会发出警告。

运行Cygwin命令行，可以直接使用此环境变量，当然也可以手动的cd到该目录：

三、新建TestJni工程，使用NDK编译程序

1.创建Android工程

2首先建立一个名为TestJni的Android工程，包名默认为com.example.hellojni，src目录下自动创建MainActivity.java。
设计JNI接口，新建一个java文件，TestJni.java.如图

—工程目录图
TestJni.java代码如下

package com.example.hellojni;public class TestJni {    public native boolean init();    public native int add(int x,int y);    public native void destory();}

3.编译JNI
在E:\workplace\TestJni\bin\classes\com\example\hellojni文件夹下会生成TestJni.class文件。

在bin文件夹下，如果没有则创建目录：/com/example/jni，并把TestJNI.class复制到/bin/com/example/jni目录下。然后在终端里进入工程的bin目录，输入javah -jni com.example.jni.TestJNI，此时会生成一个com_example_jni_TestJNI.h文件。

注意：我在输入javah -jni com.example.jni.TestJNI的命令时会出错，改为
javah -classpath E:/software_tool/android/adt-bundle-windows-x86_64-20140702/sdk/platforms/android-20/android.jar;bin/classes -d jni com.example.hellojni.TestJni

4.用C/C++实现JNI
有了JNI的C/C++头文件，就可以在C层实现JNI接口了。首先在工程目录下创建一个jni目录，这个目录就是专门用来放C/C++代码的。把com_example_hellojni_TestJni.h文件复制到jni目录下，并在这里创建一个com_example_jni_TestJni.cpp文件。

由于我想用C++来实现JNI，所以上面两个文件我只是用来作为动态链接库的接口，具体的实现我希望放在一个类里面来完成，因此我再添加两个文件：Add.h和Add.cpp。如上操作结果见工程目录图

com_example_hellojni_TestJni.h

/* DO NOT EDIT THIS FILE - it is machine generated */#include <jni.h>/* Header for class com_example_hellojni_TestJni */#ifndef _Included_com_example_hellojni_TestJni#define _Included_com_example_hellojni_TestJni#ifdef __cplusplusextern "C" {#endif/* * Class:     com_example_hellojni_TestJni * Method:    init * Signature: ()Z */JNIEXPORT jboolean JNICALL Java_com_example_hellojni_TestJni_init  (JNIEnv *, jobject);/* * Class:     com_example_hellojni_TestJni * Method:    add * Signature: (II)I */JNIEXPORT jint JNICALL Java_com_example_hellojni_TestJni_add  (JNIEnv *, jobject, jint, jint);/* * Class:     com_example_hellojni_TestJni * Method:    destory * Signature: ()V */JNIEXPORT void JNICALL Java_com_example_hellojni_TestJni_destory  (JNIEnv *, jobject);#ifdef __cplusplus}#endif#endif

com_example_hellojni_TestJni.cpp

#include <stdio.h>#include <stdlib.h>#include "com_example_hellojni_TestJni.h"#include "Add.h"CAdd *pCAdd = NULL;JNIEXPORT jboolean JNICALL Java_com_example_hellojni_TestJni_init(JNIEnv *env,jobject obj) {   if (pCAdd == NULL) {        pCAdd = new CAdd;    }   return pCAdd != NULL;}JNIEXPORT jint JNICALL Java_com_example_hellojni_TestJni_add(JNIEnv *env, jobject obj,        jint x, jint y) {        int res = -1;       if (pCAdd != NULL) {          res = pCAdd->add(x, y);        }       return res;}JNIEXPORT void JNICALL Java_com_example_hellojni_TestJni_destory(JNIEnv *env, jobject obj){    if (pCAdd != NULL)    {        pCAdd = NULL;    }}

Add.cpp

#include "Add.h" CAdd::CAdd() { } CAdd::~CAdd() { } int CAdd::add(int x, int y) { return x + y;}

Add.h

#ifndef _TEST_JNI_ADD_H_#define _TEST_JNI_ADD_H_class CAdd {    public:        CAdd();        ~CAdd();        int add(int x,int y);};#endif

到此C/C++代码实现结束

5、创建Android.mk
JNI实现了之后就要把C/C++代码编译成动态链接库.so文件，这样Java程序才能调用JNI的接口。要编译so文件，需要写Android.mk和Application.mk两个文件。我们先来写Android.mk。

先在工程目录的jni下创建一个Android.mk文件：

LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)LOCAL_MODULE := TestJniLOCAL_SRC_FILES := com_example_hellojni_TestJni.cppLOCAL_SRC_FILES += Add.cppinclude $(BUILD_SHARED_LIBRARY)

其中LOCAL_PATH是C/C++代码所在目录，也就是我们的jni目录。
LOCAL_MODULE是要编译的库的名称。编译器会自动在前面加上lib，在后面加上.so。

LOCAL_SRC_FILES是要编译的C/C++文件。

现在我们在工程的根目录下创建一个Application.mk文件，并输入如下内容：

APP_PROJECT_PATH := $(call my-dir)APP_MODULES := TestJni

6、编译动态链接库（.so文件）
默认在Windows7下配置好了NDK开发环境，打开cygwin，进入到工程目录

编译生成.SO库

编译成功后会在工程目录的libs/armeabi目录下生成一个libTestJni.so文件。

7 在Java中调用JNI

现在我们的Android应用可以调用JNI计算加法的代码，如下：
MainActivity.java

package com.example.hellojni;import android.support.v7.app.ActionBarActivity;import android.app.Activity;import android.app.SearchManager.OnCancelListener;import android.os.Bundle;import android.view.Menu;import android.view.MenuItem;import android.view.View;import android.view.View.OnClickListener;import android.widget.Button;import android.widget.EditText;import android.widget.TextView;public class MainActivity extends Activity{    static{        System.loadLibrary("TestJni");    }    EditText tvX = null;    EditText tvY = null;    EditText tvSum = null;     Button   btnAdd = null;    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_main);        tvX = (EditText)findViewById(R.id.et_x);        tvY = (EditText)findViewById(R.id.et_y);        tvSum = (EditText)findViewById(R.id.et_sum);        btnAdd = (Button)findViewById(R.id.btn_add);        btnAdd.setOnClickListener(new OnClickListener() {            @Override            public void onClick(View v) {                // TODO Auto-generated method stub                int x = Integer.valueOf( tvX.getText().toString());                int y = Integer.valueOf( tvY.getText().toString());                int sum = 0;                TestJni jni = new TestJni();                boolean flag = jni.init();                if(flag){                sum = jni.add(x, y);                }                tvSum.setText(String.valueOf(sum));            }        });    }}

8.XML文件（activity_main.xml）

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"    xmlns:tools="http://schemas.android.com/tools"    android:layout_width="match_parent"    android:layout_height="match_parent"    android:orientation="horizontal"    >    <EditText        android:id="@+id/et_x"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_weight="1"         >    </EditText>    <TextView        android:id="@+id/tv1"        android:layout_width="wrap_content"        android:layout_height="wrap_content"                android:text="+" >     </TextView>      <EditText        android:id="@+id/et_y"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_weight="1"         >      </EditText>      <Button           android:id = "@+id/btn_add"          android:layout_width="wrap_content"          android:layout_height="wrap_content"          android:text="="          />       <EditText        android:id="@+id/et_sum"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_weight="1"         >      </EditText></LinearLayout>

程序运行结果如图

总结一下JNI开发基本步骤
①编写.java类
②生成.class文件
③生成.h文件
③查阅.h文件
　　JNIEXPORT 和 JNICALL 是jni的宏
　　函数前的注释Signature: ()Ljava/lang/String;中的括号含义为：表示函数的参数为空，Ljava/lang/String表示函数的返回值是java的String对象
④编写.c/cpp文件
⑤创建 Android.mk文件（和.c文件同级目录）
⑥编译生成.so文件

NDK开发中的一些常见错误及解决办法

一、常见的几个错误及其解决办法
1. android.mk文件不存在
错误代码形如：
AndroidNDK: Your APP_BUILD_SCRIPT points to an unknown file: ./jni/Android.mk
/cygdrive/h/heima6/jni2/ziliao/android-ndk-r7b/build/core/add-application.mk:133:* Android NDK: Aborting… 。 停止。
解决办法：
创建Android.mk文件。

2.android.mk文件的配置信息有错误
错误代码形如：
***Android NDK: Missing LOCAL_MODULE before including BUILD_SHARED_LIBRARY injni/Android.mk 。 停止。
解决办法：
修改Android.mk文件中的错误。有时候可能是一些看不见的特色字符导致，可以删除后重新建立一个。

3.c代码语法出现错误,编译不通过Error1.
错误代码形如：
make:* [obj/local/armeabi/objs/Hello/Hello.o]Error 1
解决办法：
检查C程序代码

4.java层c代码库没有找到
错误代码形如：
Causedby: java.lang.UnsatisfiedLinkError:Library Hell0 not found静态加载代码库的时候代码库没有找到.(调用库时出错)
解决办法：
检查库库的名字，看是否写错了。看

5.c代码函数签名出现错误(函数名出错)
错误代码形如：
Causedby: java.lang.UnsatisfiedLinkError: hello_from_c
解决办法：
C代码中函数名不合特定规范，改过来就行了。

1. 其他隐含错误
   如：在C代码中视图去访问已经释放了的内存空间。