一般我们开发主要是使用Java,但项目中有些涉及到复杂的算法或耗时操作时,通常使用C/C++完成算法实现并提供给java层(通过JNI)调用,以此提高运行的效率。这种情况下,C/C++所实现的代码以及JNI调用相关的代码被打包为.so库。
笔者在项目中遇到了需要使用JNI调用c++算法的情况,之前也没有相关的经验,折腾了一番之后终于跑通,故整理一下整个过程。
本文以一个加法运算的简单功能为例,说明如何使用JNI开发。
环境、工具的准备
1、系统环境:windows x10
2、工具:1)android studio 或者 eclipse;2)android-ndk-r10b
3、搭建:笔者因为已有android studio开发的环境,所以只需要搭建NDK环境。
1)Android官网下载NDK;
2)解压缩下载的ziP包到某个目录,例如 D:\android-ndk-r10b;
3)配置添加环境变量 NDK_ROOT 为: D:\android-ndk-r10b, 在环境变量 PATH 下追加 :%NDK_ROOT%;
4)验证ndk安装是否成功:cmd进入安装ndk的目录,找到D:\android-ndk-r10b\samples\hello-jni目录,运行ndk-build 命令,出现以下结果就表明环境安装成功
SO库编写
先看一下整个工程的目录,先说明一点,标红的命名需要一致。接下来就可以讲述整个过程的实现了
1、生成.h头文件
打开android studio,新建android项目JniTestApp,creat 一个package com.yxq.jnitestapp.add,建一个类AddUtil
AddUtil.java
package com.yxq.jnitestapp.add;
/**
* Created by yxq on 2016/12/15.
*/
public class AddUtil {
public static native int add(int addend,int summand);
static {
System.loadLibrary("addLib");
}
}
cmd进入JniTestApp工程所在的java目录, 用 Javac 编译成 AddUtil .java文件成class文件,再用javah编译生成.h文件
.h文件具体内容
/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class com_yxq_jnitestapp_add_AddUtil */
#ifndef _Included_com_yxq_jnitestapp_add_AddUtil
#define _Included_com_yxq_jnitestapp_add_AddUtil
#ifdef __cplusplus
extern "C" {
#endif
/*
* Class: com_yxq_jnitestapp_add_AddUtil
* Method: add
* Signature: (II)I
*/
JNIEXPORT jint JNICALL Java_com_yxq_jnitestapp_add_AddUtil_add
(JNIEnv *, jobject, jint, jint);
#ifdef __cplusplus
}
#endif
#endif
2、编写.c文件
在JniTestApp的app\src\main目录下新建一个文件夹jni,将第一步生成的com_yxq_jnitestapp_add_AddUtil.h文件拷贝至jni文件夹, 新建一个文件com_yxq_jnitestapp_add_AddUtil.c文件,c文件是源码文件,实现了此项目核心功能add。
#include <jni.h>
#include "com_yxq_jnitestapp_add_AddUtil.h"
JNIEXPORT jint JNICALL Java_com_yxq_jnitestapp_add_AddUtil_add
(JNIEnv *env, jobject obj, jint addend, jint summand){
return add(addend, summand);
}
int add(int addend, int summand){
return addend + summand;
}
3、编写Android.mk文件
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := addLib
LOCAL_SRC_FILES := com_yxq_jnitestapp_add_AddUtil.c
include $(BUILD_SHARED_LIBRARY)
4、编译
cmd进入工程所在的main目录,执行命令 ndk-build,就完成了。
完成后,删除多余的文件,并将生成armeabi文件夹移动到jniLibs目录下面,然后就可以在Java工程中调用了。
遇到的问题和注意事项
1、可能会遇到如下问题,原因是工程的路径有空格,NDK编译无法通过,解决方案是将整个工程换一个目录,比如换到D:\Android\workspace\JniTestApp>
D:\Program Files\Android\workspace\JniTestApp>ndk-build
Android NDK: Your Android application project path contains spaces: 'D:/ Files/Android/workspace/'
Android NDK: The Android NDK build cannot work here. Please move your project to a different location.
D:\android-ndk-r10b\build/core/build-local.mk:155: *** Android NDK: Aborting. . Stop.
2、可能会遇到如下问题,找到不库,解决方法是生成的lib库需要放到jniLibs目录下面才能调用成功,
Process: com.yxq.jnitestapp, PID: 19527
java.lang.UnsatisfiedLinkError: Couldn't load addLib from loader dalvik.system.PathClassLoader[DexPathList[[zip file "/data/app/com.yxq.jnitestapp-4.apk"],nativeLibraryDirectories=[/data/app-lib/com.yxq.jnitestapp-4, /vendor/lib, /system/lib]]]: findLibrary returned null
at java.lang.Runtime.loadLibrary(Runtime.java:358)
at java.lang.System.loadLibrary(System.java:526)
at com.yxq.jnitestapp.add.AddUtil.<clinit>(AddUtil.java:11)