Android NDK(JNI)开发

《基于Windows平台,Android NDK(JNI)开发技术》


【摘要】本文介绍如何基于Windows平台,在Eclipse中使用Android NDK技术实现“Android平台上的JNI ( Java Native Interface ) ”开发。Android NDK开发需要一定的Java JNI技术基础。Android NDK实质,可以简单的认为是Android平台提供的一组套件,将一些C/C++代码通过JNI的形式为Android平台所复用,该技术可以使得以往写好的、成熟的C/C++代码不加修改或者稍加修改即可移植到Android。同时,在一些敏感的特殊场景,可能需要C/C++代码,如CPU敏感,图形图像等。
【关键词】Android , NDK , JNI , Windows


Android平台的NDK(Native Development Kit)开发,需要从谷歌官方下载Android NDK所需的SDK开发包。在旧版本的Android NDK开发中,需要额外的下载安装第三方Cygwin,但是最新Android NDK已经集成Cygwin功能,不需要再单独下载集成Cygwin,即免Cygwin安装。Android NDK官方下载页面:https://developer.android.com/ndk/downloads/index.html ,本文中下载和使用的Android NDK版本是基于64位Windows的Android NDK r10e版 :

版本名:Windows 64-bit , android-ndk-r10e-windows-x86_64.exe
下载链接:http://dl.google.com/android/ndk/android-ndk-r10e-windows-x86_64.exe

Windows 64-bit , android-ndk-r10e-windows-x86_64.exe下载完毕后是这样一个文件:

Android NDK(JNI)开发_第1张图片


实际上是一个包含Android NDK开发资源的压缩文件,点击安装后将其解压到一个文件夹下。本例是放在:D:\Program\android\ndk目录下。

然后打开Eclipse。Windows -> Preferences -> Android -> NDK,如图:

Android NDK(JNI)开发_第2张图片


在NDK Location中,选择刚才安装的Android NDK目录。
至此,Android NDK开发环境搭建完成。

接下来就是如何使用和具体开发。
新建一个NDKTest的Android项目:

Android NDK(JNI)开发_第3张图片


然后为项目NDKTest增加NDK:Add Native Support,在NDKTest的项目单击右键,Android Tools -> Add Native Support ,如图:

Android NDK(JNI)开发_第4张图片


当Add Natvie Support后,Eclipse弹出对话框,提示指定lib名字,缺省就是项目名,本例就用NDKTest作为lib名字。如图:

Android NDK(JNI)开发_第5张图片


(注意:Android NDK会自动为库添加前缀 “lib”,这样最后的库名为“libxxx.so”,假设在自己的项目中本来就是lib开头,那么Android NDK则不再添加“lib”前缀,直接使用你自己命名好的名称。)

此时项目的目录中会自动产生一个jni的子目录,jni下有两个文件:NDKTest.cpp和Android.mk,如图:

Android NDK(JNI)开发_第6张图片

其中Android.mk不需要我们修改,而NDKTest.cpp则是我们后面需要增加自己实现的内容。
通常,一个项目中所需要的NDK\JNI库\方法最好放在一个共同的Java类中,这样方便管理和代码维护。本例中,新增一个 MyJNI.java的类文件,在MyJNI.java这个类文件中,函数开头冠以native修饰符的,修饰符native表明这就是我们将要实现的JNI函数,写好的MyJNI.java文件内容及存放位置和内容如图:

Android NDK(JNI)开发_第7张图片


注意需要首先在此类中使用静态代码块包裹一层,load我们的库文件。

到这里,剩下的代码工作就是完成native方法。Run一下这个项目,此时Run这个项目没有意义,我们只是为了获得编译后的*.class文件才Run,拿到.class类文件后才能使用javah编译命令获得jni的头文件。
Run过后,在NDKTest/bin/classses目录下已经生成编译好的类文件包,如图:

Android NDK(JNI)开发_第8张图片

接下来我们要获得MyJNI.java相对应的JNI头文件,启动java控制台定位到classes目录下,然后执行javah命令:javah zhangphil.ndktest.MyJNI,如图:

Android NDK(JNI)开发_第9张图片


如果一切正常,那么此时就会在classes目录下生成:zhangphil_ndktest_MyJNI.h头文件,不要对这个代码文件进行修改。zhangphil_ndktest_MyJNI.h里面的代码内容如下:

/* DO NOT EDIT THIS FILE - it is machine generated */
#include 
/* Header for class zhangphil_ndktest_MyJNI */

#ifndef _Included_zhangphil_ndktest_MyJNI
#define _Included_zhangphil_ndktest_MyJNI
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     zhangphil_ndktest_MyJNI
 * Method:    getString
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_zhangphil_ndktest_MyJNI_getString
  (JNIEnv *, jobject);

#ifdef __cplusplus
}
#endif
#endif


将 zhangphil_ndktest_MyJNI.h此头文件复制到jni目录下,结构层次如图:

Android NDK(JNI)开发_第10张图片


打开由IDE自动生成的NDKTest.cpp文件,里面其实只有一行代码:

Android NDK(JNI)开发_第11张图片


接下来,
1, 我们将此文件的头部分include我们的zhangphil_ndktest_MyJNI.h文件。
2, 实现在zhangphil_ndktest_MyJNI.h文件中定义的:

JNIEXPORT jstring JNICALL Java_zhangphil_ndktest_MyJNI_getString
  (JNIEnv *, jobject);

Native方法。

(备注:Java_zhangphil_ndktest_MyJNI_getString(),这是一个由Java系统自动生成的JNI签名函数,其规律特点是Java开头,然后就是我们自己的包名,接着是类名,最后就是我们自己定义的native方法,只不过Java命名规则中的 “.” 由 “_” 取代 )

补写完成NDKTest.cpp,简单期间,假设我们的getString()函数仅仅返回“Hello , World ! I'm from JNI !”字符串:

#include 
#include 

JNIEXPORT jstring JNICALL Java_zhangphil_ndktest_MyJNI_getString
  (JNIEnv * env, jobject obj){
	return	env->NewStringUTF("Hello , World ! I'm from JNI !");
}


至此,Android JNI的全部代码已经完成,剩下的就是使用我们的native方法。
写一个简单的Android Activity测试我们完成的Android native函数。

package zhangphil.ndktest;

import android.support.v7.app.ActionBarActivity;
import android.widget.Toast;
import android.os.Bundle;

public class MainActivity extends ActionBarActivity {

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);

		MyJNI jni = new MyJNI();
		String s = jni.getString();

		Toast.makeText(this, s, Toast.LENGTH_LONG).show();
	}
}

运行结果如图:

Android NDK(JNI)开发_第12张图片


成功了!


总结:

Android NDK开发实际上可以认为就是Android平台框架下的Java JNI,具体步骤归结如下:
(第1步)下载安装最新的Android NDK,搭建好开发环境,然后“Add Natvie Support”。
(第2步)写好自己项目中需要的类和native方法。在本例中就是增加MyJNI类,在MyJNI类中我们写了一个用以演示的getString()函数,此函数为native。
(第3步)Run这个项目,这阶段Run目的只是为了获得编译后类文件。然后启动java控制台,定位到bin目录下的classes包,执行javah命令,为我们的MyJNI类文件生成 .h 头文件。在本例中即:zhangphil_ndktest_MyJNI.h文件。
(第4步)把第3步中获得的 .h 头文件复制到jni目录下,然后补全jni目录下的 .cpp 文件,注意在 .cpp 的头部需要 #include 我们在第3步产生的 .h 头文件。同时,在  .cpp 源代码文件中完成在 .h 头文件中定义的函数。
在本例中就是在 zhangphil_ndktest_MyJNI.h 定义的函数:

JNIEXPORT jstring JNICALL Java_zhangphil_ndktest_MyJNI_getString
  (JNIEnv *, jobject);

完成后的:

JNIEXPORT jstring JNICALL Java_zhangphil_ndktest_MyJNI_getString
  (JNIEnv * env, jobject obj){
	return	env->NewStringUTF("Hello , World ! I'm from JNI !");
}

(第5步)以上都完成后,就可以直接在我们的项目中使用 MyJNI类中的native方法getString()了。



你可能感兴趣的:(Android,Java,IT,C,Eclipse,Windows,Eclipse,android,Windows,JNI,Java)