Android之使用JNI调用NDK

配置NDK环境变量及生成so文件:
1、 首先找到cygwin的安装目录,找到一个home\<你的用户名>\.bash_profile文件,我的是:E:\cygwin\home\Administrator\.bash_profile。(注意:我安装的时候我的home文件夹下面神马都没有,解决的办法:首先打开环境变量,把里面的用户变量中的HOME变量删掉,在E:\cygwin\home文件夹下建立名为Administrator的文件夹(是用户名),然后把E:\cygwin\etc\skel\.bash_profile拷贝到该文件夹下)。

2、 打开bash_profile文件,(此处必须要使用UltraEdit文件编辑器打开,并且打开后不要转换格式!使用其他编辑工具打开的话编辑后是乱码,不能执行!)添加NDK=/cygdrive/<你的盘符>/<Android ndk 目录> 例 如:

NDK=/cygdrive/e/Android-ndk-r8b

export NDK

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

3、打开cygwin,输入cd $NDK,如果输出上面配置的/cygdrive/e/Android-ndk-r5信息(输出的信息为ndk的安装目录),则表明环境变量设置成功了。

 

4、编译成so文件,3的配置成功后就可以配置生成so文件啦。首先,需要进入需要进行生成so文件的项目,我这里是使用例子的路径(/cygdrive/e/android-ndk-r8b/samples/hello-jni) 然后键入$NDK/ndk-build就可以在项目下自动生成libs\armeabi文件夹及相应的so文件。

 

.c文件解析:
jstring
Java_com_example_hellojni_HelloJni_stringFromJNI( JNIEnv* env , jobject thiz )
{
    return (*env)->NewStringUTF(env, "Hello from JNI !");
}
Native的对应函数名要以“Java_”开头,后面依次跟上Java的“package名”、“class名”、“函数名”,中间以下划线“_” 分割,在package名中的“.”也要改为“_”。此外,关于函数的参数和返回值也有相应的规则。对于Java中的基本类型如int 、double 、char 等,在Native端都有相对应的类型来表示,如jint 、jdouble 、jchar 等;其他的对象类型则统统由jobject 来表示(String 是个例外,由于其使用广泛,故在Native代码中有jstring 这个类型来表示,正如在上例中返回值String 对应到Native代码中的返回值jstring )。而对于Java中的数组,在Native中由jarray 对应,具体到基本类型和一般对象类型的数组则有jintArray 等和jobjectArray 分别对应(String 数组在这里没有例外,同样用jobjectArray 表示)。

还有一点需要注意的是,在JNI的Native函数中,其前两个参数
JNIEnv *和jobject 是必需的——前者是一个JNIEnv 结构体的指针是JNI的核心数据,这个结构体中定义了很多JNI的接口函数指针,使开发者可以使用JNI所定义的接口功能;

JNIEnv *env参数的使用

所有JNI接口的第一个参数是JNIEnv *env, 在C中,使用方法是

(*env)->NewStringUTF(env, "Hello from JNI!");

但在C++中,其调用方法是

env->NewStringUTF("Hello from JNI!");


后者指代的是调用这个JNI函数的Java对象,有点类似于C++中的
this 指针。在上述两个参数之后,还需要根据Java端的函数声明依次对应添加参数。在上例中,Java中声明的JNI函数没有参数,则Native的对应函数只有类型为JNIEnv *和jobject 的两个参数。

 

JAVA文件: 

从上面Native函数的命名上我们可以了解到JNI函数的命名规则: Java代码中的函数声明需要添加native

例如:public native String  stringFromJNI(); 

当然,要使用JNI函数,还需要先加载Native代码编译出来的动态库文件(在Windows上是.dll,在Linux上则为.so)。这个动作是通过如下语句完成的:
  1. static  {  
  2.     System.loadLibrary("hello-jni" );  
  3. }  

 

 生成相应.h文件:

 注意一定要先编译java文件,使其生成.class文件后才能生成相应的.h文件

 1. 需要在命令行进入相应的项目里

 2. 键入 javah -classpath bin -d jni com.example.hellojni.HelloJni 绿色为包名+类名

************    后来发现,生成的 .class 文件并不是直接放到bin文件夹下的,而是包含一个名为classes的子目录。
************   所以,把以上命令改为:
************   javah -calsspath bin/classes -d jni <package>.<class>

************   也就是: javah -classpath bin/classes -d jni com.example.hellojni.HelloJni 绿色为包名+类名

 

 

编写Android.mk文件 :

在jni目录下(即hello-jni.c 同级目录下)新建一个Android.mk文件,Android.mk 文件是Android 的 makefile文件,内容如下:
 

LOCAL_PATH := $(call my-dir)

一个Android.mk 文件首先必须定义好LOCAL_PATH变量。它用于在开发树中查找源文件。在这个例子中,宏函数’my-dir’, 由编译系统提供,用于返回当前路径(即包含Android.mk file文件的目录)。

 

include $(CLEAR_VARS)
CLEAR_VARS由编译系统提供,指定让GNU MAKEFILE为你清除许多LOCAL_XXX变量(例如 LOCAL_MODULE, LOCAL_SRC_FILES, LOCAL_STATIC_LIBRARIES, 等等...), 除LOCAL_PATH 。这是必要的,因为所有的编译控制文件都在同一个GNU MAKE执行环境中,所有的变量都是全局的。 


LOCAL_MODULE    := hello-jni

编译的目标对象,LOCAL_MODULE变量必须定义,以标识你在Android.mk文件中描述的每个模块。名称必须是唯一的,而且不包含任何空格。注意:编译系统会自动产生合适的前缀和后缀,换句话说,一个被命名为'hello-jni'的共享库模块,将会生成'libhello-jni.so'文件。重要注意事项:如果你把库命名为‘libhello-jni’,编译系统将不会添加任何的lib前缀,也会生成 'libhello-jni.so',这是为了支持来源于Android平台的源代码的Android.mk文件,如果你确实需要这么做的话。 

LOCAL_SRC_FILES := hello-jni.c

LOCAL_SRC_FILES变量必须包含将要编译打包进模块中的C或C++源代码文件。注意,你不用在这里列出头文件和包含文件,因为编译系统将会自动为你找出依赖型的文件;仅仅列出直接传递给编译器的源代码文件就好。注意,默认的C++源码文件的扩展名是’.cpp’. 指定一个不同的扩展名也是可能的,只要定义LOCAL_DEFAULT_CPP_EXTENSION变量,不要忘记开始的小圆点(也就是’.cxx’,而不是’cxx’) 

include $(BUILD_SHARED_LIBRARY)

BUILD_SHARED_LIBRARY表示编译生成共享库,是编译系统提供的变量,指向一个GNU Makefile脚本,负责收集自从上次调用'include $(CLEAR_VARS)'以来,定义在LOCAL_XXX变量中的所有信息,并且决 

定编译什么,如何正确地去做。还有 BUILD_STATIC_LIBRARY变量表示生成静态库:lib$(LOCAL_MODULE).a, BUILD_EXECUTABLE 表示生成可执行文件。

 

LOCAL_STATIC_LIBRARIES :=?
引用第三方库

 

自己写的一个Demo:/Files/lee0oo0/MyJNINDK.rar 

 

以下说一说android-ndk-r8b下的例子各表示的作用:接下来详细分析以下5,6,7,8,12

1. bitmap-plasma如何在NDK中使用bitmap的例子,早期的NDK版本不能直接使用bitmap,后来的版本中增加了对bitmap的支持。
2. hello-gl2在NDK中如何使用OpenGLES的运用
3. hello-jni最基本的NDK使用方式,通过NDK获取字符串然后在Android应用中显示出来
4. hello-neon在NDK中有关neon的优化
5. module-exports多个库的调用方式。foo被编译为静态库,bar被编译为动态库并调用了库foo,zoo被编译为动态库并调用了库bar。
6. native-activity完全用NDK实现整个Android程序
7. native-audio在NDK中有关音频的操作
8. native-media在NDK中对视频的操作
9. native-plasma完全用NDK实现整个Android程序并且提供了涉及plasma的优化
10. san-angeles移植到Android平台的OpenGL ES的例子
11. test-libstdc++对C++的支持,但并非支持C++的全部特征

12. two-libs:两个库的使用,first为静态库,second为动态库,并且second库调用first库 

posted on 2012-09-05 14:19  lee0oo0  阅读(9217)  评论(0编辑  收藏  举报