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了。只需要为EclipseAndroid工程添加一个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++代码了。

Android NDK开发篇(一)：新版NDK环境搭建(免Cygwin，超级快)

2014-04-14     0 个评论   来源：Android NDK开发篇(一)：新版NDK环境搭建(免Cygwin，超级快)  

收藏  我要投稿

以前做Android的项目要用到NDK就必须要下载NDK，下载安装Cygwin(模拟Linux环境用的)，下载CDT（Eclipse C/C++开发插件），还要配置编译器，环境变量...

麻烦到不想说了，Shamoo在网上查了一下资料，发现了一个超级快配置NDK的办法。

Step1：到Android官网下载Android的开发工具ADT(Android Development Tool的缩写)，该工具集成了最新的ADT和NDK插件以及Eclipse，还有一个最新版本SDK。解压之后就可以用了，非常爽！

ADT插件：管理Android SDK和相关的开发工具的

NDK插件：用于开发Android NDK的插件，ADT版本在20以上，就能安装NDK插件，另外NDK集成了CDT插件

也可以在线更新ADT、NDK插件，不过速度超级慢...所以果断在网上下载集成开发工具ADT，下载链接见：http://developer.android.com/sdk/index.html

Step2：到Android官网下载最新的NDK，注：NDK版本在r7以上之后就集成了Cygwin，而且还是十分精简版。比起下载Cygwin要方便多啦！下载链接见：http://developer.android.com/tools/sdk/ndk/index.html

下载完成之后，解压搞定！

Step3：打开Eclipse，点Window->Preferences->Android->NDK,设置NDK路径，例如Shamoo的是E:\android-ndk-r9c

Step4：新建一个Android工程，在工程上右键点击Android Tools->Add Native Support...,然后给我们的.so文件取个名字，例如:my-ndk

这时候工程就会多一个jni的文件夹，jni下有Android.mk和my-ndk.cpp文件。Android.mk是NDK工程的Makefile，my-ndk.cpp就是NDK的源文件。

Step5：接下来仿着NDK的demo,Hello-JNI工程写一下。使用Alt + '/'可以代码提示！很爽！有木有？之前用CDT时候死活都按不出代码提示，郁闷...

JNI接口的命名规范是：Java_ + 调用该方法的包名(包名的点用_代替) + _ + 调用该接口的类名 + _ + 方法名，对于实例方法，有两个参数是必要的，一个JNI的环境指针JNIEnv *，另一个是调用该方法的Java实例jobject

my-ndk.cpp:

?

1

2

3

4

5

6

#include <jni.h>

 

JNIEXPORT jstring JNICALL Java_com_shamoo_activity_TestActivity_stringFromJNI(JNIEnv *env,

        jobject thiz) {

    returnenv->NewStringUTF("Hello jni");

}</jni.h>

TestActivity.java:

?

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

public class TestActivity extendsActivity {

 

    static{

        System.loadLibrary("my-ndk");

    }

     

    // 声明JNI层的原生方法，使用native关键字

    publicnative String stringFromJNI();

     

    @Override

    protectedvoid onCreate(Bundle savedInstanceState) {

        super.onCreate(savedInstanceState);

        TextView tvText =new TextView(this);

        tvText.setText(stringFromJNI());

        setContentView(tvText);

    }

 

}

使用ndk库必须在static代码块里面用System.loadLaibrary加载.so库

Step6：完成了，然后运行。运行之前先编译NDK，然后在编译JAVA代码。编译也许会遇到Unable to launch cygpath. Is Cygwin on the path?错误，解决办法如下：

1.工程右键，点Properties->C/C++ Build的Building Settings中去掉Use default build command，然后输入${NDKROOT}/ndk-build.cmd

2.在C/C++ Build中点击Environment，点Add...添加环境变量NDKROOT，值为NDK的根目录

3.再编译，问题就解决啦！

运行时崩溃，遇到java.lang.UnsatisfiedLinkError: stringFromJNI错误，解决办法：在C++文件中函数定义前添加extern "C"修饰

?

1

2

3

4

5

6

7

8

9

extern "C"{

JNIEXPORT jstring JNICALL Java_com_shamoo_activity_TestActivity_stringFromJNI(JNIEnv *env,

        jobject thiz);

}

 

JNIEXPORT jstring JNICALL Java_com_shamoo_activity_TestActivity_stringFromJNI(JNIEnv *env,

        jobject thiz) {

    returnenv->NewStringUTF("Hello jni");

}

原因是：使用extern "C"修饰，编译器会按C语言的方式编译和连接。在C语言中，函数编译之后函数名与C++函数编译之后不同，例如foo(int x, int y),C可能会编译成_foo的名字，而C++因为支持重载，所以会编译成像_foo_int_int这种带参数的函数名。如果是按照C语言的编译方式，调用foo函数是找不到_foo的函数名就会报出函数名找不到的错误。所以要添加extern "C"修饰。