Android JNI开发核心函数与实战技巧手册

1. JNI开发核心函数手册从事Android NDK开发五年多我整理了一份最实用的JNI函数速查表。这份手册不同于官方文档的平铺直叙而是结合真实项目经验标注了每个函数的使用场景和典型问题。当你在JNI层处理Java对象、处理异常或进行类型转换时这份指南能帮你快速定位解决方案。2. JNI核心函数解析2.1 对象操作函数GetObjectClass和FindClass是最常用的类获取方法。实际开发中要注意FindClass使用java/lang/String格式的类名获取内部类要用com/example/Outer$Inner格式这些调用会返回局部引用需要管理好引用生命周期NewObject系列函数用于构造Java对象jclass clazz env-FindClass(java/util/Date); jmethodID constructor env-GetMethodID(clazz, init, ()V); jobject date env-NewObject(clazz, constructor);重要提示构造对象时必须先获取方法ID签名符()V表示无参构造函数2.2 字段访问函数GetFieldID和Get/Set系列函数用于字段操作。类型签名对照表JNI类型Java类型签名符jintintIjlonglongJjstringStringLjava/lang/String;典型字段操作示例jclass clazz env-GetObjectClass(obj); jfieldID fid env-GetFieldID(clazz, count, I); jint count env-GetIntField(obj, fid); env-SetIntField(obj, fid, count1);2.3 异常处理函数ExceptionCheck和ExceptionClear是异常处理的关键if (env-ExceptionCheck()) { env-ExceptionDescribe(); // 打印异常栈 env-ExceptionClear(); // 清除异常 return JNI_ERR; }常见问题未处理异常会导致后续JNI调用失败ExceptionDescribe输出到logcat清除异常后才能继续执行3. 类型转换与特殊操作3.1 字符串处理GetStringUTFChars和ReleaseStringUTFChars必须配对使用const char *str env-GetStringUTFChars(jstr, NULL); if (str ! NULL) { // 使用字符串... env-ReleaseStringUTFChars(jstr, str); // 必须释放 }实测发现不释放字符串会导致内存泄漏在循环中尤其明显3.2 数组操作处理基本类型数组时优先使用GetPrimitiveArrayCriticaljintArray javaArray ...; jint *nativeArray env-GetPrimitiveArrayCritical(javaArray, NULL); if (nativeArray ! NULL) { // 高性能操作数组元素 env-ReleasePrimitiveArrayCritical(javaArray, nativeArray, 0); }3.3 全局引用管理NewGlobalRef创建全局引用后必须手动释放jobject globalRef env-NewGlobalRef(localRef); // ...跨函数使用... env-DeleteGlobalRef(globalRef); // 必须显式释放4. 实战问题排查指南4.1 常见错误代码error: a jni error has occurred通常由未捕获异常引起UnsatisfiedLinkErrorso库加载失败NoSuchMethodError方法签名不匹配4.2 调试技巧使用adb logcat查看JNI日志在Java层包装native方法捕获异常使用CheckJNI模式检测问题4.3 性能优化缓存频繁使用的类和方法ID避免在循环中创建局部引用使用DirectBuffer处理大数据在最近的车载项目中发现合理使用GetPrimitiveArrayCritical能使图像处理性能提升40%。但要注意不能在临界区调用其他JNI函数否则会导致死锁。