JNI
- 简介:
Java Native Interface,即java本地接口,本地接口就是指用C和C++开发的接口。
实际使用中,java需要与本地代码进行交互,因为java具备跨平台的特点,所以java与本地代码交互能力非常弱,所以采用JNI特性增强java与本地代码交互的能力。
使得java与本地其他类型语言(如c、c++)交互,即在java代码里调用c、c++等语言的代码或c、c++代码调用java代码。 - JNI是java调用Native语言的一种特性, JNI是属于java的,与Android没有直接关联。
NDK
- 简介
Native Development Kit
快速开发c、c++的动态库,并自动将so和应用一起打包成APK即可通过NDK在android中,使用JNI与本地代码(如c、c++)交互。
在Android的场景下使用JNI即Android开发的功能需要本地代码(c\c++)实现。 - NDK是Android的一个开发工具包,NDK是属于Android,与java没有直接关联
NDK与JNI
- NDK编译出.so文件,JNI把.so文件放在文件系统的特定位置
- JNI用于本地语言与java交互,是Java中的接口;
- 使用NDK与JNI开发java+cpp的cocos2dx工程,然后用gradle构建工具构建出apk包
如何在eclipse中使用JNI:
1. java工程:用native声明C/C++方法,导入lib库
public class Native {
static{
System.loadLibrary("HelloJava");
}
public static native String getString();
}
注意这里"HelloJava"是你新建的c/c++文件名,不要多余写东西。现在我们定义了一个类是Native.java,然后我们要把这个类变成头文件。不过谷歌出的android studio 2.2版本以后可以直接新建一个支撑c/c++工程了。这里不先不提。
首先需要将Native.java编译生成一个.class文件。这里要用的javac。不过你也可以直接运行一下。eclipse会主动帮你编译生成.class,打开cmd
生成的Native.class
这里注意javac的使用我直接cd到了这个类的目录。
生成.class文件之后,再用jdk另外一个工具生成.h文件javah
同样在cmd中:输入javah -help查看使用帮助
[options]是可选项目,是必须项目。这个就是我们之前生成的Native.class
现在我们要确定需要加载类的路径,还有输出目录。注意每一段之间的空格,容易出错
类的后缀不需要写。执行这个指令完成之后会在当前目录下生成对应的.h文件
在eclipse右键工程名,refresh(f5)以下就会显示出来
2. jni目录
在工程中新建一个jni目录并且将刚才的.h文件移过来
新建一个HelloJava.c的.c源文件在这里我们来实现java层中声明的native方法
#include <stdio.h>
#include <stdlib.h>
#include <jni.h>
JNIEXPORT jstring JNICALL Java_com_example_helloc_Native_getString
(JNIEnv *env, jclass j){
return (**env).NewStringUTF(env,"hello java!");
}
这个函数名字太复杂太扯淡了。其实jni有一个命名规则,我们现在不关心这个,这个函数名可以直接从之前生成的.h文件复制过来
下面就是.h文件的内容
/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class com_example_helloc_Native */
#ifndef _Included_com_example_helloc_Native
#define _Included_com_example_helloc_Native
#ifdef __cplusplus
extern "C" {
#endif
/*
* Class: com_example_helloc_Native
* Method: getString
* Signature: ()Ljava/lang/String;
*/
JNIEXPORT jstring JNICALL Java_com_example_helloc_Native_getString
(JNIEnv *, jclass);
#ifdef __cplusplus
}
#endif
#endif
这里只有函数声明,复制这个声明,我们只要在jni实现函数体就可以了。具体的编程方式这里先不提,这里只是返回了一个字符串
ndk中已经集成了部分c库。完成之后,我们需要将.c变成linux系统能使用的.so库。这个工作就由ndk来完成,具体如下:
ndk-build指令需要在工程目录下执行才有效果,但是并没有规定在什么子目录下,所有效果都是一样的。该指令会将.c或者c++文件生成对应的.so文件,而且是两份,一份在\project path\obj\local\armeabi,这份比较大,包含有调试信息,不会随着app一起发布。另外一份比较小\ project path \libs\armeabi,这个会随着apk一起发布。编译结果
生成了各个平台支持的.so文件完成之后工程目录的libs还没有出现.so文件,
需要右键工程refresh(F5)一下就会出现,这里系统会自动添加"lib"前缀。但是注意在java层导入库的时候不要写"libHelloJava"这个要写:
static{
System.loadLibrary("HelloJava");
}
完成之后执行结果。这是android代码
public class MainActivity extends Activity {
public Button btnShow;
public TextView tvShow;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
btnShow = (Button)findViewById(R.id.btn_show);
tvShow = (TextView)findViewById(R.id.tv_show);
btnShow.setOnClickListener(new OnClickListener() {
@Override
public void onClick(View v) {
// TODO Auto-generated method stub
tvShow.setText(Native.getString());
}
});
}
}
结果
3. 另外执行ndk-build之前需要先编写**.mk**文件。具体如下:
在jni中新建一个android.mk文件,内容如下:
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := HelloJava
LOCAL_SRC_FILES := HelloJava.c
#LOCAL_LDLIBS := -llog -ljnigraphics
include $(BUILD_SHARED_LIBRARY)
具体解释如下:
-
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 := Native
编译的目标对象,LOCAL_MODULE
变量必须定义,以标识你在Android.mk
文件中描述的每个模块。名称必须是唯一的,而且不包含任何空格。 -
LOCAL_SRC_FILES := Native.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
表示生成可执行文件。