JNI官方教程

Java官方JNI教程：

• https://docs.oracle.com/en/java/javase/11/docs/specs/jni/functions.html
• https://docs.oracle.com/javase/7/docs/technotes/guides/jni/spec/jniTOC.html
• https://docs.oracle.com/javase/8/docs/technotes/guides/jni/spec/jniTOC.html
• https://docs.oracle.com/javase/8/docs/technotes/guides/jni/enhancements.html
• https://docs.oracle.com/en/java/javase/19/docs/specs/jni/index.html
• https://docs.oracle.com/search/?category=java&product=e74273-01&q=jni

这里记录一下在C++中操作Java传递过来的数组，AndroidStudio向导创建的NDK项目中，默认是使用C++的，在Android开发中，经常的操作是给C++传递一个byte数组，然后使用另一个新的byte数组接收处理后的结果。NDK项目创建可参考这篇文章。假设在MainActivity中声明了如下JNI函数：

external fun arrayConvert(srcArray: ByteArray, destArray: ByteArray) // 这是一个JNI函数

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    。。。
    val srcByteArray = byteArrayOf(1, 2, 3)
    val destByteArray = ByteArray(srcByteArray.size)
    arrayConvert(srcByteArray, destByteArray)
    srcByteArray.forEachIndexed { index, byte ->
        Log.i("JniLog", "Main.src[${index}] = $byte")
    }
    destByteArray.forEachIndexed { index, byte ->
        Log.i("JniLog", "Main.dest[${index}] = $byte")
    }
}

如上代码，srcArray是需要处理的数据，传到C中做处理，C中处理完成后保存在destArray中。相应的JNI函数如下：

extern "C"
JNIEXPORT void JNICALL
Java_cn_android666_addosdtovideo_MainActivity_arrayConvert(JNIEnv *env, jobject thiz, jbyteArray src_array, jbyteArray dest_array) {
    jbyte *src_array_p = env->GetByteArrayElements(src_array, NULL);
    jbyte *dest_array_p = env->GetByteArrayElements(dest_array, NULL);
    jsize srcArrayLength = env->GetArrayLength(src_array);
    jsize destArrayLength = env->GetArrayLength(dest_array);
    LOGD("srcArrayLength = %d, destArrayLength = %d", srcArrayLength, destArrayLength);

    for (int i = 0; i < srcArrayLength; ++i) {
        src_array_p[i] = src_array_p[i] * 10;
        dest_array_p[i] = src_array_p[i] + 1;
    }

    for (int i = 0; i < srcArrayLength; ++i) {
        LOGD("src[%d] = %d", i, src_array_p[i]);
    }

    for (int i = 0; i < srcArrayLength; ++i) {
        LOGD("dest[%d] = %d", i, dest_array_p[i]);
    }
}

运行结果如下：

srcArrayLength = 3, destArrayLength = 3
src[0] = 10
src[1] = 20
src[2] = 30
dest[0] = 11
dest[1] = 21
dest[2] = 31
Main.src[0] = 1
Main.src[1] = 2
Main.src[2] = 3
Main.dest[0] = 0
Main.dest[1] = 0
Main.dest[2] = 0

可以看到，在C++中打印的数组结果是正确的，而在MainActivity中打印的数组结果是原来的数据，即没有被C++修改过，为什么会这么神奇，我也搞不清，加入一个释放的语句即可解决此问题，在JNI函数的最后添加两个释放语句，如下：

env->ReleaseByteArrayElements(src_array, src_array_p, 0);
env->ReleaseByteArrayElements(dest_array, dest_array_p, 0);

运行结果如下：

srcArrayLength = 3, destArrayLength = 3
src[0] = 10
src[1] = 20
src[2] = 30
dest[0] = 11
dest[1] = 21
dest[2] = 31
Main.src[0] = 10
Main.src[1] = 20
Main.src[2] = 30
Main.dest[0] = 11
Main.dest[1] = 21
Main.dest[2] = 31

OK，这次结果就正常了！

了解了这个，我们就可以做JNI开发了，因为一般的JNI都是我们在Java层传递byte数组类型的数据给C++加处理，处理完了再返回数据给我们，这里可以直接修改原数组，这样只传一个原数组参数即可，也可以通过一个新数组接收处理后的结果，这样就需要传递两个数组参数。