Android中的第一个NDK的例子

前几天研究了JNI技术后,想在Android上试一试研究结果,查阅了很多资料后,总结如下步骤:

首先来看一下什么是NDK

NDK 提供了一系列的工具,帮助开发者快速开发C(或C++)的动态库,并能自动将so 和java 应用一起打包成apk。这些工具对开发者的帮助是巨大的。
NDK 集成了交叉编译器,并提供了相应的mk 文件隔离CPU、平台、ABI 等差异,开发人员只需要简单修改mk 文件(指出“哪些文件需要编译”、“编译特性要求”等),就可以创建出so。NDK 可以自动地将so 和Java 应用一起打包,极大地减轻了开发人员的打包工作。比较简单的说,NDK是一套交叉编译工具,它可以帮你把你用C或C++书写的代码,编译为.so(类似与win下的.dll)格式的文件,使你可以在你的Android程序当中用Java语言(JNI)调用这些代码

下面来看一下具体的操作步骤


第一步:搭建NDK环境


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

下载放到指定的目录下,解压即可,这一步很简单的

第二步:下载安装cygwin


由于NDK编译代码时必须要用到make和gcc,所以你必须先搭建一个linux环境,cygwin是一个在windows平台上运行的unix模拟环境,它对于学习unix/linux操作环境,或者从unix到windows的应用程序移植,非常有用。通过它,你就可以在不安装linux的情况下使用NDK来编译C、C++代码了。下面我们一步一步的安装cygwin吧。

下载地址:http://cygwin.com/install.html

1、 然后双击运行吧,运行后你将看到安装向导界面:

2、 点击下一步,此时让你选择安装方式:
1)Install from Internet:直接从Internet上下载并立即安装(安装完成后,下载好的安装文件并不会被删除, 而是仍然被保留,以便下次再安装)。
2)Download Without Installing:只是将安装文件下载到本地,但暂时不安装。
3)Install from Local Directory:不下载安装文件,直接从本地某个含有安装文件的目录进行安装。

3、选择第一项,然后点击下一步:

4、选择要安装的目录,注意,最好不要放到有中文和空格的目录里,似乎会造成安装出问题,其它选项不用变,之后点下一步:

5、上一步是选择安装cygwin的目录,这个是选择你下载的安装包所在的目录,默认是你运行setup.exe的目录,直接点下一步就可以:

6、此时你共有三种连接方式选择:
1) Direct Connection:直接连接。
2) Use IE5 Settings:使用IE的连接参数设置进行连接。
3) Use HTTP/FTP Proxy:使用HTTP或FTP代理服务器进行连接(需要输入服务器地址、端口号)。
根据自己的网络连接的实情情况进行选择,一般正常情况下,均选择第一种,也就是直接连接方式。然后再点击“下一步”,

7、 这是选择要下载的站点,选择后点下一步.

8、 此时会下载加载安装包列表

9、Search是可以输入你要下载的包的名称,能够快速筛选出你要下载的包。那四个单选按钮是选择下边树的样式,默认就行,不用动。View默认是Category,建议改成full显示全部包再查,省的一些包被隐藏掉。左下角那个复选框是是否隐藏过期包,默认打钩,不用管它就行,下边开始下载我们要安装的包吧,为了避免全部下载,这里列出了后面开发NDK用得着的包:autoconf2.1、automake1.10、binutils、gcc-core、gcc-g++、gcc4-core、gcc4-g++、gdb、pcre、pcre-devel、gawk、make共12个包

10、然后开始选择安装这些包吧,点skip,把它变成数字版本格式,要确保Bin项变成叉号,而Src项是源码,这个就没必要选了。

11、下面测试一下cygwin是不是已经安装好了。
运行cygwin,在弹出的命令行窗口输入:cygcheck -c cygwin命令,会打印出当前cygwin的版本和运行状态,如果status是ok的话,则cygwin运行正常。
然后依次输入gcc --version,g++ --version,make –version,gdb –version进行测试,如果都打印出版本信息和一些描述信息,非常高兴的告诉你,你的cygwin安装完成了.

第三步:配置NDK环境变量


1、首先找到cygwin的安装目录,找到一个home\<你的用户名>\.bash_profile文件,我的是:c:\cygwin\home\Administrator\.bash_profileAndroid中的第一个NDK的例子

2、打开bash_profile文件,添加NDK=/cygdrive/<你的盘符>/<android ndk 目录> ,就是第一步中下载下来的NDK解压的目录我的目录是:

Android中的第一个NDK的例子例如:
NDK=/cygdrive/e/android-ndk-r9c
export NDKRoot

(NDKRoot这个名字是随便取的,为了方面以后使用方便,选个简短的名字,然后保存)

(这里还要注意的是盘符是"/"而不是"\",因为cygwind是Linux,不是windows的)

3、打开cygwin,输入cd $NDK,如果输出上面配置的/cygdrive/e/android-ndk-r9c信息,则表明环境变量设置成功了。

第四步:用NDK来编译程序,测试功能是否可用


1、现在我们用安装好的NDK来编译一个简单的程序吧,我们选择ndk自带的例子hello-jni,我的位于E:\android-ndk-r9c\samples\hello-jni(根据你具体的安装位置而定).

2、运行cygwin,输入命令cd /cygdrive/e/android-ndk-r9c/samples/hello-jni,进入到E:\android-ndk-r9c\samples\hello-jni目录。

3、 输入$NDK/ndk-build,执行成功后,它会自动生成一个libs目录,把编译生成的.so文件放在里面。($NDK是调用我们之前配置好的环境变量,ndk-build是调用ndk的编译程序)

(早期NDK版本是make APP=hello-jni ,还要对应app和source2个目录的项目目录,现在改成了$NDK/ndk-build)

第五步:开发一个简单的Android NDK例子


在Eclipse中新建一个AndroidNDKDemo工程

Android中的第一个NDK的例子

其中JNI.java是定义的本地方法的类,代码如下:

package com.ndk.demo;
public class JNI {
//获取字符串
public native String getString();
//进行加法操作
public native int plus(int a,int b);
}

在来看一下AndroidNDKDemoActivity.java,主要是测试的Demo,代码如下:

package com.ndk.demo;

import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast; import com.ndk.demo.R; public class AndroidNDKDemoActivity extends Activity {
//使用静态代码块加载类库
static{
System.loadLibrary("first_jni");//一定要注意名称没有“lib"
}
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
Button btn1 = (Button)findViewById(R.id.show_btn);
final EditText oneEdit = (EditText)findViewById(R.id.one_number);
final EditText twoEdit = (EditText)findViewById(R.id.two_number);
final Button btn2 = (Button)findViewById(R.id.calculate_btn);
//定义本地类
final JNI jni = new JNI();
btn1.setOnClickListener(new OnClickListener(){
public void onClick(View v) {
//显示从C代码中返回的字符串
Toast.makeText(getApplicationContext(), jni.getString(), 1500).show();
}});
btn2.setOnClickListener(new OnClickListener(){
public void onClick(View v) {
//调用C代码中的加法操作
String oneNumber = oneEdit.getText().toString();
String twoNumber = twoEdit.getText().toString();
int oneNumbers = Integer.valueOf(oneNumber);
int twoNumbers = Integer.valueOf(twoNumber);
btn2.setText(jni.plus(oneNumbers, twoNumbers)+"");
}});
}
}

上面的工作搞定后,就生成c代码的头文件吧!具体操作,这里不再赘述,可以访问我的博客:

http://blog.csdn.net/jiangwei0910410003/article/details/17465085

同时使用VC6.0建一个NDKDemo.c代码,如下:

#include"jni.h"
/*
* Class: com_ndk_demo_JNI
* Method: getString
* Signature: ()Ljava/lang/String;
*/
JNIEXPORT jstring JNICALL Java_com_ndk_demo_JNI_getString(JNIEnv* env, jobject obj)
{
//返回一个字符串
return (*env)->NewStringUTF(env,"Hello NDK!");
} /*
* Class: com_ndk_demo_JNI
* Method: plus
* Signature: (II)I
*/
JNIEXPORT jint JNICALL Java_com_ndk_demo_JNI_plus(JNIEnv* env, jobject obj, jint a, jint b)
{
//返回计算结果
return a+b;
}

到这一步,离成功就不远了,现在需要将NDKDemo.c编译成.so库,在目录中新建一个文件夹(这个目录是随便建立的),这里我为了方便就在AndroidNDKDemo工程的bin\classes目录中新建一个jni文件夹(这里一定要注意文件夹的名称一定是"jni",不然后面的编译会报错的),下面是我的目录图:

Android中的第一个NDK的例子Android中的第一个NDK的例子

你同样可以在D盘下新建一个jni文件夹,或者其他的目录下都可以的,但是一定要注意文件夹的名称必须是"jni"

然后将生成的C代码的头文件和你刚刚新建的.c文件拷贝到jni文件夹下,(这里的NDKDemo.cpp不要管了,是C++代码文件)

下面接着新建一个Android.mk文件,文件内容如下:

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE    := first_jni (最终so文件名是libfirst_jni.so)
LOCAL_SRC_FILES := NDKDemo.c (C代码)
include $(BUILD_SHARED_LIBRARY)

上面的准备工作都做完了,现在就开始编译吧:

打开cygwin,输入以下命令:

cd /cygdrive/e/workspace/AndroidNDKDemo/bin/classes  

进入到jni文件夹的根目录,这个是我的目录,你们要进入你们刚才新建的jni文件夹的根目录即可

然后输入命令:

$NDK/ndk-build

进行编译

Android中的第一个NDK的例子

上面说明编译成功,这时候到jni的根目录中可以看到多出两个文件夹,一个是libs,一个是obj,我们这里只关心libs中的文件

Android中的第一个NDK的例子

进入到lib文件夹下,看到有一个libfirst_jni.so文件,这时候,我们的编译工作全部搞定了,这时候只需要将libfirst_jni.so文件拷贝到AndroidNDKDemo工程中的libs文件夹下,如果libs下没有文件夹armeabi,就新建一个armeabi文件夹,将libfirst_jni.so文件放到armeabi文件夹中,加载库的代码具体可以看上面。

运行结果如下:

Android中的第一个NDK的例子Android中的第一个NDK的例子

可以看到,成功的运行了!

问题

就是我这里面使用了C代码测试的,其实我开始的时候是用C++代码测试的,就是上面的NDKDemo.cpp文件:代码如下:

#include"jni.h"
/*
* Class: com_ndk_demo_JNI
* Method: getString
* Signature: ()Ljava/lang/String;
*/
JNIEXPORT jstring JNICALL Java_com_ndk_demo_JNI_getString(JNIEnv* env, jobject obj)
{
//返回字符串
return env->NewStringUTF("Hello NDK!");
} /*
* Class: com_ndk_demo_JNI
* Method: plus
* Signature: (II)I
*/
JNIEXPORT jint JNICALL Java_com_ndk_demo_JNI_plus(JNIEnv* env, jobject obj, jint a, jint b)
{
//计算结果
return a+b;
}

这里面就是方法:JNICALL Java_com_ndk_demo_JNI_getString不一样

C代码中是:

return (*env)->NewStringUTF(env,"Hello NDK!");

C++代码是:

return env->NewStringUTF("Hello NDK!");

但是使用C++代码的话,在Eclipse中编译报错,很是纠结,现在还没有解决,如果哪位大神能够告诉我一下,本人将不胜感激!

Demo的下载的地址: 

http://download.csdn.net/detail/jiangwei0910410003/7594551

上一篇:从零开始搭建Java开发环境第一篇:Java工程师必备软件大合集


下一篇:Python学习--12 异常处理、调试