对于入门级Android菜鸟的我来说,从配置到开发JNI是一个煎熬的过程,但还是取得了最终的成功。这里主要是整个过程进行了整理,让其他跟我一样受煎熬的人尽早跳出来,继续向光明迈进…
环境配置
开发JNI项目前提是需要有NDK(Native Development Kit)的支持。因此,在开发前需要先安装和配置NDK。步骤如下:
点击菜单”Tools” -> “Android” -> “SDK Manager”打开SDK管理器。
选中右边面板的”SDK Tools”页签,勾选”NDK”一栏,然后点击”Apply”来下载并安装NDK(如下图)。
第一个JNI例子
1. 新建Android项目
点击菜单“File”-“New”-“New Project…”打开新建项目界面, 输入项目名称:
选择支持的平台及最低支持的系统版本
选择项目模版Basic Activity
设置Activity的命名
至此,创建项目完成。
2. 设置项目支持JNI
打开gradle.properties文件,在该文件下添加:
android.useDeprecatedNdk=true
打开local.properties文件,在该文件下添加:
ndk.dir=NDK的路径
再打开模块的build.gradle文件,在android/defaultConfig下面添加ndk节点,如下所示:
apply plugin: 'com.android.application'
android {
compileSdkVersion 23
buildToolsVersion "23.0.3"
defaultConfig {
applicationId "vimfung.cn.jnisample"
minSdkVersion 15
targetSdkVersion 23
versionCode 1
versionName "1.0"
ndk {
moduleName "JNISample"
stl "stlport_static"
ldLibs "log"
}
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
}
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
testCompile 'junit:junit:4.12'
compile 'com.android.support:appcompat-v7:23.4.0'
compile 'com.android.support:design:23.4.0'
}
其中ndk节点下面的字段说明如下:
名称 | 说明 |
---|---|
moduleName | 模块名称,即编译出来的.so的名字 |
stl | 默认情况下JNI中是无法使用STL标准库的,加入此字段表示使用STL标准库。 |
ldLibs | “log” 表示加入Android的调试日志,只要在导入#include |
3. 编写JNI接口
创建一个叫JNIUtil的Java类,并声明一个使用native关键字修饰的test方法,代码如下:
package vimfung.cn.jnisample;
/**
* Created by vimfung on 16/9/8.
*/
public class JNIUtil
{
public native String test ();
}
* 注:声明jni的方法必须带有native关键字,否则将视为一般的方法。设置native的方法允许为静态/非静态方法(即加或不加static关键字)。*
Command+F9(或菜单“Build”-“Make Project”)进行编译,成功后点击界面最下面的Terminal按钮打开终端面板(终端会自动定位到当前项目目录非常方便^o^)。使用cd命令跳转到app/build/intermediates/classes/debug/目录下,输入脚本如下:
$ cd app/build/intermediates/classes/debug/
使用javah命令生成刚才创建的JNIUtil类的JNI的头文件(.h文件),如:
javah vimfung.cn.jnisample.JNIUtil
* 这里要注意的是javah要根据包名来对应目录路径来查找对应的.class文件,所以定位的目录必须要在包目录结构的上一级(即这里的debug目录),否则会提示找不到对应的类。*
执行成功后(执行成功是不会输出任何信息的,错误了才会提示-_-#)会在debug目录下多出一个vimfung_cn_jnisample_JNIUtil.h的头文件,如下所示:
/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class vimfung_cn_jnisample_JNIUtil */
#ifndef _Included_vimfung_cn_jnisample_JNIUtil
#define _Included_vimfung_cn_jnisample_JNIUtil
#ifdef __cplusplus
extern "C" {
#endif
/*
* Class: vimfung_cn_jnisample_JNIUtil
* Method: test
* Signature: ()Ljava/lang/String;
*/
JNIEXPORT jstring JNICALL Java_vimfung_cn_jnisample_JNIUtil_test
(JNIEnv *, jobject);
#ifdef __cplusplus
}
#endif
#endif
可以看到刚才定义的test方法在头文件中被声明为Java_vimfung_cn_jnisample_JNIUtil_test 方法(其命名规则我猜应该是Java+“”+“包名1”+“” +“包名2”+“”…+“”+“类名”+“_”+“方法名”)。其中有jstring、JNIEnv、jobject这些就是JNI提供给C/C++调用的类型和接口,利用这些东西可以跟Java层进行一些交互。
回到Android Studio中,右键app目录,在弹出菜单中选择“New”-“Folder”-“JNI Folder”建立一个JNI的目录。如图:
然后把刚才生成的头文件拷贝到这个目录下,最终效果如图:
创建一个c++的文件,名字叫vimfung_cn_jnisample_JNIUtil.cpp,然后Java_vimfung_cn_jnisample_JNIUtil_test方法进行实现,如:
//
// Created by vimfung on 16/9/8.
//
#include "vimfung_cn_jnisample_JNIUtil.h"
JNIEXPORT jstring JNICALL Java_vimfung_cn_jnisample_JNIUtil_test(JNIEnv *env, jobject obj)
{
return env -> NewStringUTF("Hello World!");
}
该方法直接通过env构造一个Java的字符串返回值并赋值为“Hello World!”进行返回。关于JNI提供的接口功能在后面的章节会进行介绍,我们这里只要知道是返回字符串就可以了。
现在再打开JNIUtil的Java类,让外部一旦使用该类时即加载JNISample.so这个库,修改如下:
package vimfung.cn.jnisample;
/**
* Created by vimfung on 16/9/8.
*/
public class JNIUtil
{
static
{
System.loadLibrary("JNISample");
}
public native String test ();
}
最后,打开MainActivity.java文件,添加一个JNIUtil的属性,并且在onCreate的时候初始化并调用test方法。这一步骤主要是验证我们的JNI接口是否正常运行,修改的代码如下:
public class MainActivity extends AppCompatActivity {
private