NDK开发—基础知识实战Demo

简介

前面写了几篇NDK相关的文章：

NDK开发－简介&环境搭建(Eclipse，Android Studio)

NDK开发－Android Studio+gradle-experimental开发NDK，

NDK开发－零散知识点整理

这个demo就是对这几篇文章中涉及内容的一个应用。其功能只是对数组进行排序。如果单纯使用Java来做十分简单，只需写个排序方法，或者将数组转化为集合，然后调用sort函数就ok了。

但我们的目的是练习JNI所以需要使劲的折腾一下，其中主要涉及了：

Java调用JNI函数

JNI调用Java函数

JNI中打印Android Log

JNI中调用c++函数库

JNI调用普通方法／静态方法

JNI全局变量使用

JNI数组的操作

JNI异常处理

演示图

点击按钮对数组排序：

排序成功：

Java代码：

Activity代码：

public class MainActivity extends AppCompatActivity {

// 导入动态库
static {
System.loadLibrary("test");
}

// 本地排序方法
public native boolean doSort(int [] array);

private Button mOrderBtn;
private TextView mResultText;

// 需要排序的数组
int[] orderArrays = {6,2,5,9,1,3,4,7,8,0,10};

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);

// 调用jni调用静态方法返回一个字符串(hello world?)
Log.d("TestNDK", JNIHelper.getStringFromNative());

mResultText = (TextView) this.findViewById(R.id.result);
setResultText(orderArrays);

mOrderBtn = (Button) this.findViewById(R.id.plus_btn);
mOrderBtn.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
// 调用本地排序方法, 根据是否有异常打印success/failed
boolean isSuccess = doSort(orderArrays);
mOrderBtn.setText(isSuccess?"success":"failed");
}
});

}

public void setResultText(String resultText) {
mResultText.setText(resultText);
}

public void setResultText(int[] array) {
mResultText.setText(Arrays.toString(array));
}

}

JNI工具类：

public class JNIHelper {

@Keep
private void updateStatus(String msg) {
if (msg.toLowerCase().contains("error")) {
Log.e("JniHandler", "Native Err: " + msg);
} else {
Log.i("JniHandler", "Native Msg: " + msg);
}
}

public static native String getStringFromNative();
}

JNI代码

头文件

#include <jni.h>
/* Header for class com_dean_testndk_JNIHelper */

#ifndef _Included_com_dean_testndk_JNIHelper
#define _Included_com_dean_testndk_JNIHelper

#ifdef __cplusplus
extern "C" {
#endif
/*
* Class:     com_dean_testndk_JNIHelper
* Method:    getStringFromNative
* Signature: ()Ljava/lang/String;
*/
JNIEXPORT jstring JNICALL
Java_com_dean_testndk_JNIHelper_getStringFromNative(JNIEnv *, jclass);

JNIEXPORT jboolean JNICALL
Java_com_dean_testndk_MainActivity_doSort(JNIEnv *, jobject, jintArray);
#ifdef __cplusplus
}
#endif
#endif

c++代码

//
// Created by Dean Guo on 7/23/16.
//
#include "com_dean_testndk_JNIHelper.h"
#include "string.h"
#include "iostream"
#include "vector"
#include "algorithm"
#include <android/log.h>

using namespace std;
// Android log function wrappers
static const char* kTAG = "testNDK";
#define LOGI(...) \
((void)__android_log_print(ANDROID_LOG_INFO, kTAG, __VA_ARGS__))
#define LOGW(...) \
((void)__android_log_print(ANDROID_LOG_WARN, kTAG, __VA_ARGS__))
#define LOGE(...) \
((void)__android_log_print(ANDROID_LOG_ERROR, kTAG, __VA_ARGS__))

struct GLOBAL_CONTEXT {
JavaVM* javaVM;
jclass mainActivityClz;
jobject mainActivityObj;

jclass jniHelperClz;
jobject jniHelperObj;
};

/**
* 全局引用
*/
GLOBAL_CONTEXT mContext;

void sendJavaMsg(JNIEnv *env, jobject instance, jmethodID func, const char *msg) {

jstring javaMsg = env->NewStringUTF(msg);
env->CallVoidMethod(instance, func, javaMsg);
}

void callSetResult(JNIEnv *env, vector<int> vector_) {

char buff[1000] = "";

vector<int>::iterator it;

for (it = vector_.begin(); it != vector_.end(); it++) {
char numChar[100] = "";
sprintf(numChar, "%d", *it);
strcat(numChar, ",");
strcat(buff, numChar);
}

jstring javaMsg = env->NewStringUTF(buff);
jthrowable ex = env->ExceptionOccurred();
if (0 != ex) {
env->ExceptionClear();
env->DeleteLocalRef(javaMsg);
LOGE("Exception-sendJavaMsg!");
} else {
jmethodID methodID = env->GetMethodID(mContext.mainActivityClz, "setResultText", "(Ljava/lang/String;)V");
env->CallVoidMethod(mContext.mainActivityObj, methodID, javaMsg);
env->DeleteLocalRef(javaMsg);
}
}

/**
* 根据排序好的vector集合, 创建排序数组返回
*/
void callSetArrayResult(JNIEnv *env, vector<int> vector_) {

int size = vector_.size();

// 排序后需要返回的数组
jintArray array = env->NewIntArray(size);

// 为jni数组赋值
jint *num = new jint[size];
for (int i = 0; i < size; i++)
{
num[i] = vector_[i];
}
env->SetIntArrayRegion(array, 0, size, num);

// 调用java方法传递排序好的数组
jmethodID methodID = env->GetMethodID(mContext.mainActivityClz, "setResultText", "([I)V");
env->CallVoidMethod(mContext.mainActivityObj, methodID, array);

// 释放数组
env->ReleaseIntArrayElements(array, num, 0);
}

/**
* 系统函数, JNI初始化时调用。
* 可在这个函数这里做一些初始化赋值
*/
JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void* reserved) {

LOGI("JNI_OnLoad");

JNIEnv* env;

mContext.javaVM = vm;

if (vm->GetEnv((void**)&env, JNI_VERSION_1_6) != JNI_OK) {
LOGE("JNI_ERR");
return JNI_ERR; // 不支持该版本
}

// 对JNIHelper设置全局引用
jclass clz = env->FindClass("com/dean/testndk/JNIHelper");
mContext.jniHelperClz = (jclass) env->NewGlobalRef(clz);

jmethodID jniHelperCtor = env->GetMethodID(mContext.jniHelperClz, "<init>", "()V");
jobject handler = env->NewObject(mContext.jniHelperClz, jniHelperCtor);
mContext.jniHelperObj = env->NewGlobalRef(handler);

// 调用JNIHelper中updateStatus方法打印信息
jmethodID statusId = env->GetMethodID(mContext.jniHelperClz, "updateStatus", "(Ljava/lang/String;)V");
sendJavaMsg(env, mContext.jniHelperObj, statusId, "JNI: initializing...");

return JNI_VERSION_1_6;
}

/**
* 简单返回一个字符串
*/
JNIEXPORT jstring JNICALL Java_com_dean_testndk_JNIHelper_getStringFromNative
(JNIEnv *env, jclass jclz) {
return env->NewStringUTF("from Native");
}

/**
* 排序方法, 成功返回true, 否则false
*/
JNIEXPORT jboolean JNICALL
Java_com_dean_testndk_MainActivity_doSort(JNIEnv *env, jobject instance, jintArray arr_) {
// 设置全局引用
mContext.mainActivityClz = env->GetObjectClass(instance);
mContext.mainActivityObj = env->NewGlobalRef(instance);

// 获取传递过来的数组指针
jint *nums = env->GetIntArrayElements(arr_, NULL);
// 获取数组长度
jsize len = env->GetArrayLength(arr_);

// 使用标准库中的vector排序
vector<int> mVector;
for (int i=0; i< len; i++) {
mVector.push_back(nums[i]);
}
sort(mVector.begin(), mVector.end());

// 调用返回结果函数
callSetArrayResult(env, mVector);

// 释放数组
env->ReleaseIntArrayElements(arr_, nums, 0);

// 判断是否有异常, 没有表示成功返回true, 否则false
jthrowable ex = env->ExceptionOccurred();
if (0 != ex) {
env->ExceptionClear();
LOGE("Exception!");
return false;
} else {
return true;
}
}

最后

下载

https://github.com/a396901990/TestNDK

总结

demo中所有详细的知识点都可以在NDK开发－零散知识点整理中找到。

如果想深入NDK推荐Google NDK的官方demo：

https://github.com/googlesamples/android-ndk