Android如何通过JNI调用C++方法？

Question

在Android开发中，如何通过JNI正确调用C++方法并传递参数？

Answer 1

一、JNI在Android开发中的作用与基础概念

JNI（Java Native Interface）是Java平台标准的一部分，它允许Java代码与本地代码（如C/C++）进行交互。在Android开发中，JNI被广泛用于性能敏感或需要调用底层系统API的场景。

要通过JNI正确调用C++方法并传递参数，首先需要理解几个核心概念：

• JNIEnv *：指向JNI环境的指针，提供了调用JNI函数的能力。
• jobject：代表Java对象实例。
• jclass：代表Java类的Class对象。

二、从Java到C++的基本调用流程

我们以一个简单的例子来说明如何在Java中声明native方法，并在C++中实现该方法。

1. Java层定义native方法

public class NativeLib {
    public native int addNumbers(int a, int b);
    
    static {
        System.loadLibrary("native-lib");
    }
}

2. C++层实现对应函数

C++函数命名规则为：Java_包名_类名_方法名，例如：

extern "C" JNIEXPORT jint JNICALL
Java_com_example_NativeLib_addNumbers(JNIEnv *env, jobject /* this */, jint a, jint b) {
    return a + b;
}

三、参数类型映射与转换规则

JNI提供了一套完整的类型映射机制，将Java类型转换为C/C++对应的类型。常见类型映射如下：

Java类型	JNI类型	C/C++类型
boolean	jboolean	unsigned char
int	jint	int
double	jdouble	double
String	jstring	const char*

四、复杂参数传递示例

当需要传递字符串或数组时，需使用JNIEnv提供的方法进行转换。

1. Java传String给C++

public native String sayHello(String name);

extern "C" JNIEXPORT jstring JNICALL
Java_com_example_NativeLib_sayHello(JNIEnv *env, jobject /* this */, jstring name) {
    const char *cName = env->GetStringUTFChars(name, NULL);
    std::string result = "Hello, ";
    result += cName;
    env->ReleaseStringUTFChars(name, cName);
    return env->NewStringUTF(result.c_str());
}

2. Java传int数组给C++

public native int sumArray(int[] array);

extern "C" JNIEXPORT jint JNICALL
Java_com_example_NativeLib_sumArray(JNIEnv *env, jobject /* this */, jintArray array) {
    jint *elements = env->GetIntArrayElements(array, NULL);
    jsize len = env->GetArrayLength(array);
    jint sum = 0;
    for (int i = 0; i < len; ++i) {
        sum += elements[i];
    }
    env->ReleaseIntArrayElements(array, elements, 0);
    return sum;
}

五、JNI调用中的线程安全与异常处理

JNI在多线程环境下调用时需要注意线程绑定问题。每个线程必须先调用AttachCurrentThread获取JNIEnv指针。

JNIEnv *env;
jvm->AttachCurrentThread(&env, NULL);
// 使用env调用JNI方法
jvm->DetachCurrentThread();

同时，C++中抛出异常会导致崩溃，应使用JNIEnv的ExceptionCheck或ExceptionOccurred来捕获Java异常：

jthrowable exception = env->ExceptionOccurred();
if (exception != NULL) {
    // 处理异常
    env->ExceptionClear();
}

六、JNI注册方式对比与最佳实践

JNI支持静态注册和动态注册两种方式：

• 静态注册：根据函数名自动匹配，适用于小型项目。
• 动态注册：通过RegisterNatives手动绑定，更灵活且适合大型项目。

动态注册示例：

static JNINativeMethod methods[] = {
    {"addNumbers", "(II)I", (void *)addNumbers},
    {"sayHello",   "(Ljava/lang/String;)Ljava/lang/String;", (void *)sayHello}
};

jint JNI_OnLoad(JavaVM* vm, void* reserved) {
    JNIEnv* env;
    if (vm->GetEnv((void**) &env, JNI_VERSION_1_6) != JNI_OK) {
        return -1;
    }

    jclass clazz = env->FindClass("com/example/NativeLib");
    env->RegisterNatives(clazz, methods, sizeof(methods)/sizeof(methods[0]));
    return JNI_VERSION_1_6;
}

七、调用流程图解析

下面是一个通过JNI调用C++函数的流程图：

graph TD
    A[Java调用native方法] --> B{JVM查找对应C++函数}
    B -->|静态注册| C[函数名匹配]
    B -->|动态注册| D[查找RegisterNatives注册表]
    C --> E[C++函数执行]
    D --> E
    E --> F[返回结果给Java层]