Android jni开发资料--NDK环境搭建-CSDN博客

史上最易懂的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。
（b）在弹出的【Choose configuration type】对话框，选择【Program】，点击【OK】：
（c）在弹出的【Edit Configuration】对话框中，配置选项卡【Main】。
在“Name“中输入新builders的名称（这个名字可以任意取）。

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

图1

（d）继续在这个【Edit Configuration】对话框中，配置选项卡【Refresh】。如图2
勾选“Refresh resources upon completion”，
勾选“The entire workspace”，
勾选“Recuresively include sub-folders”。

图2

（e）继续在【Edit Configuration】对话框中，配置选项卡【Build options】。
勾选“After a “Clean””，(勾选这个操作后，如果你想编译ndk的时候，只需要clean一下项目就开始交叉编译)
勾选“During manual builds”，
勾选“During auto builds”，
勾选“Specify working set of relevant resources”。如图3

图3

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

图4

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

那么搭建完了，当然要玩一玩了，好了，下面我们来跑一个demo测试一把，让你了解一下ndk的开发流程

三、NDK程序demo的开发（下面是重点，请仔细查看）

1.在TestNdk工程中新建一个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.生成 .h 的c++头文件

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

(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
}
#endif
#endif

3.在jni目录下新建一个Android.mk文件，其内容如下(关于mk文件需要注意,很重要,还有c和c++文件的mk文件还不一样，此处是调用c语言的mk文件，至于其他的怎么调用，这个自己去百度吧，在此就不多说了)

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := TestNdk
LOCAL_SRC_FILES := com_ndk_test_JniClient.c
include $(BUILD_SHARED_LIBRARY)

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

然后新建一个com_ndk_test_JniClient.c文件完成头文件中函数的实现，其内容如下（本来想写两个方法的，现在只讲解第一个方法，返回一个字符串“HelloWorld from JNI ”,另一个方法是一个a+b的运算，方法写到这里，感兴趣的可以自己去研究）：

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 = (*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   
}   
#endif

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

5.在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("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);
    }
}

6.运行TestNdk工程，在控制台中可以看到界面输出来自com_ndk_test_JniClient.c 文件中的“HelloWorld from JNI ! "了。

NDK实例到此完成。

后续更复杂的操作就需要深入的学习NDK/JNI了，

比如C/C++与Java的数据类型转换，以及Android.mk文件的编写格式等。

如果有什么问题，欢迎沟通交流！非常感谢您对andye的关注！关于.h文件怎么生成，可以看我另一篇日志，虽然是用cygwin写的，有点旧，但是里面有关于怎么生成.h的截图，供参考，地址为:http://www.cnblogs.com/yejiurui/archive/2012/11/21/2780940.html

近期有朋友需求，忘记上传一份demo了，那么我重新整理了一份demo，各位朋友可以下载学习：

百度网盘下载地址：http://pan.baidu.com/s/1gdIeUvL

demo图片如下：

现在学习NDK开发，有时说得也是JNI开发。那为什么要学习JNI,JNI会学习到比较底层的东西，java可以实现上层应用的开发，但是不能写底层驱动，有些android项目必须和底层硬件打交道，比如要精确快速的获取某种传感器的值，那么java是不能办到的，那怎么办，就通过JNI开发，通过c/c++完成底层驱动或者值得获取，然后将值传回到java层。同样java层也可以将数据传递给c/c++层，这样通过JNI完成数据的交互。

那为什么java不能访问底层呢？先看一张java程序的执行流程图：

java源代码通过java编译器后变成字节码，然后装载到java平台运行期环境（java虚拟机），在不同的平台下游不同的java虚拟机，window下有window的，linux下有linux下的java虚拟机，java虚拟机屏蔽了与底层直接的细节，做到java运行与平台无关，所以java是不能访问底层的

那么java层怎么就能访问到c/c++层并将数据传输过去：c/c++又怎么能将数据传回java层呢。出来在java层通过native标记某个方法是本地方法外，重要是需要NDK这个android 本地开发工具集

什么是NDK(android native develop kits ):android 本地开发工具集 ,可以把c/c++ ->编译成一个 linux下可以执行的二进制文件 java代码里面就可以通过jni 调用执行二进制的文件.

什么是JNI ：java本地开发接口,JNI是一个协议这个协议用来沟通java代码和外部的本地代码(c/c++).通过这个协议,java代码就可以调用外部的c/c++，代码外部的c/c++代码也可以调用java代码。

JNI开发用途：驱动开发 (wifi-hotspot) 2.3无线热点共享，Native code效率高,数学运算,实时渲染的游戏上,音视频处理(极品飞车,opengl,ffmpeg)，复用代码(文件压缩,人脸识别…)等。

下面进入主题：JNI开发环境配置及简单的程序实现。

一：需要的工具及资源：开发工具，android studio，NDK开发工具集，至于没有的可以到网上下载，我用的是android studio1.3和 android-ndk-r10，当然不必和我一样的，好像听网上说android studio1.3开始支持DNK开发，而且支持也不太好的，经过这几天的学习，真的是感觉支持不是很好的，最新的NDK开发工具集集成了cygwin（一个模拟Linux运行环境的软件），所以就不像以前那样还要安装什么cygwin。

环境配置步骤如下（简单的说一下，网上有很多教程）：

1 解压NDK开发工具集，随便哪里都行，看你自己的习惯，但是还是要自己知道，别什么时候不知不觉删了，然后开发JNI始终不行，怎么都找不到错误，那就杯具了。

2打开android studio，依次点击：File ->ProjectStructure:如图：

点击右边，选择你解压的NDK，点击应用。这一步将工具包关联到android studio。

在 local.properties 文件中设置ndk的路径：

就是你解压的NDK工具集的路径我的是 E:/Android/android-ndk-r10，注意要对应加斜杠

到这里我说JNI（有时说的NDK开发，一样的，叫法不同）环境初步建好了，不想eclipse那样什么cygwin啊，怎么还要ndk-build的啊，我说什么都不用，就用一个命令就行了，下面就开始我们的第一个小demo。

程序过程讲解：

一：头文件生成：

第一步：像平时一样将一个空的android工程。

第二部：前面说了，要用native来标识一个方法，告诉程序这是一个本地方法。程序如下

public class NDK extends Activity{    static {        System.loadLibrary("MyJni");//导入生成的链接库文件    }    public native String getStringFromNative();//本地方法    public native String getString_From_c();    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.myjni);        System.out.println(getStringFromNative());    }    public void onClick(View view) {        System.out.println(getString_From_c());        Toast.makeText(this, getStringFromNative(), Toast.LENGTH_LONG).show();    }}
 这一步可以先不加这行代码：System.loadLibrary("MyJni");//导入生成的链接库文件 ，因为这里还没有建立C文件，不能生成库文件。
 然后make project一下，目的就是编译成对应的class文件。然后根据生成的class文件，利用javah生成对应的 .h头文件。如果没有编译就执行javah命令会提示找不到这个类文件的。下面是我的工程界面；
这里说一下：我工程里面的本地方法显示是红色，我一开始以为不能进行JNI开发，或者有错误，包括我后面的C文件和头文件里面也有很多地方是红色的，我开始定义这些方法的时候是红色的，但是有时又不是的，不知道是android studio对NDK支持不太好，还是怎么得，但是后面开发JNI程序没有任何影响的。所以就没有关了，如果那位大神知道还望告诉我一下，将非常感激。
第三部：打开命令窗口，点击view ->ToolsWindows->Terminal,如下图：
进来后默认是指向当前的工程目录，接下来输入命令：cd app/src/main 回车，切换到main目录下：如图：
至于怎么理解命令，建议你去学一下linux系统，这事linux最基本的操作。
第四部：输入javah -d jni -classpath E:/Android/sdk/platforms/android-22/android.jar;../../build/intermediates/classes/debug example.daosong.com.ndkdemo.NDK（注意前后有英文的;号隔开的哈）  生成头文件（要先编译程序的，不然会报错）。可能有些人看到这里就茫然了，这么长怎么写出来的哟，这怎么记得到的，我告诉大家根本不用记，我给你说怎么得来的，你们就能很快写出来了，是不是真的哟，不信试一试的。
首先：javah是生成头文件需要的工具，这个很好记得把，相信学java是都用过的。-d jni 在工程下生成jni目录，到时会在这个目录下建JNI开始的C/C++源文件的。-classpath E:/Android/sdk/platforms/android-22/android.jar 这个就是你SDK文件下android.jar所在的文件位置，找到后复制即可。在学java的时候讲了这个的，可以将E:/Android/sdk/platforms/android-22/android.jar配置到环境变量就可以不写出来，因为在生成头文件是需要这个jar包，因为我没有配置到环境变量，所以这里就显示写出来。这部分很好搞定把。前面好弄，那后面部分怎了弄得，相信学过linux的很快能够知道的。
../../build/intermediates/classes/debug example.daosong.com.ndkdemo.NDK 
首先是 ../../build/intermediates/classes/debug，结合到下面的图看：
..表示返回上级目录，../..表示返回上两级目录，也就是返回到那层目录，然后明白这个了啥../../build/intermediates/classes/debug，指向debug目录，然后空格和后面隔离，
然后就是后面部分example.daosong.com.ndkdemo.NDK，看上图明白啥，是该类的全路径，这里有.隔离开，平时写类的全路径都是用的.号，生成头文件是将类对应的class文件生成二进制文件，所以要指向这里的，然后回车就能完成了头文件的生成。意思是将该文件目录下的NDK.class文件生成相应的头文件。打开jni目录下会有本地方法相应的映射方法定义。
在jni目录下建立C源文件

网上说需要在jni下多建一个空的C文件，不让会出错，到底出什么错我也不知道的，反正我多不多建都没有什么影响的，不过多建一个没什么影响，也就建了。

jni.c

代码如下：

#include "example_daosong_com_ndkdemo_NDK.h"//#include <android/log.h>//#define  LOG_TAG  "System.out"//#define LOGD(...) __android_log_print(ANDROID_LOG_DEBUG, LOG_TAG,  __VA_ARGS__)//#define LOGINFO(...) __android_log_print(ANDROID_LOG_ERROR, LOG_TAG,  __VA_ARGS__)JNIEXPORT jstring JNICALL Java_example_daosong_com_ndkdemo_NDK_getStringFromNative        (JNIEnv * env, jobject obj){   // LOGINFO("LOGINFO");    return (*env)->NewStringUTF(env,"NDK 测试成功");}jstring Java_example_daosong_com_ndkdemo_NDK_getString_1From_1c        (JNIEnv * env, jobject jobject){    return  (*(*env)).NewStringUTF(env,"NDK 来自于C文件");}

讲到这里如果要运行还得配置一个地方：

现在运行控制台就会打印相应的消息（至于为什么这么写，代码代表什么意思，我会在下一篇博客讲解），不是eclipse还要配置android.mk这么文件吗？android studio不用，你还真猜对了，不过不是说不用就代表他没有，只不过这个配置过程不过你来做，你要做的就是配置上图的代码。那android.mk

在哪里的呢？看下图：