1. 项目背景与核心价值最近在做一个UniApp项目需要用到一些高性能的图像处理算法。用JavaScript写了个Demo跑起来那叫一个卡尤其是在一些中低端安卓设备上帧率直接掉到没法看。团队里负责算法的同事甩过来一个C写的动态链接库.so文件说核心逻辑都在里面性能有保障。这就引出了一个在混合开发中非常经典的需求如何在UniApp这个前端框架里去调用安卓原生平台上的、由C编译生成的so库这可不是简单的“引入一个JS插件”就能搞定的事。它涉及到一个完整的技术链路UniAppVue/JS - 安卓原生Java/Kotlin代码 - JNIJava Native Interface - C/C Native Code。很多刚开始接触这个领域的朋友看到这一串技术栈可能就有点发怵感觉每一步都是坑。确实这个过程比纯前端开发要复杂但一旦打通带来的能力提升是巨大的。你可以把那些对计算性能要求极高的模块比如音视频编解码、图像识别、物理仿真、加密解密用C实现然后在前端优雅地调用既享受了跨端的便捷又获得了原生的性能。网上关于这个主题的讨论不少但信息比较零散。有的只讲了怎么在Android Studio里写JNI没提怎么和UniApp对接有的只说了UniApp插件的大概没深入到C库的集成细节。这篇文章我就结合自己最近趟过的一遍坑从头到尾、手把手地把“在UniApp安卓原生插件中集成并调用C so库”这个事给讲透。目标很明确让你看完之后能独立完成从零到一的集成并且理解每一步背后的“为什么”而不仅仅是照抄命令。2. 技术链路全景与核心组件选型在动手写代码之前我们必须把整个调用链路的原理和涉及的关键组件搞清楚。脑子里有一张清晰的架构图后面填代码的时候才不会迷路。整个流程可以抽象为四个层级第一层UniApp前端JavaScript/Vue这是我们的业务入口。在这里我们希望通过一个简单的JavaScript API比如myNativeModule.processImage(imageData)来触发底层的复杂计算。第二层UniApp原生插件桥接JavaUniApp框架提供了原生插件机制允许我们编写Java或Kotlin代码来扩展能力。这一层充当了JS和安卓原生世界之间的“翻译官”和“调度员”。我们需要在这里定义一个模块类它继承自UniApp的特定基类如UniModule并声明可供JS调用的方法。第三层Java Native Interface (JNI)这是连接Java世界和C/C世界的标准桥梁。JNI定义了一套严格的规则在Java层你需要使用native关键字声明方法例如public native String processData(String input);。这个方法只有声明没有实现。在C/C层你需要实现一个具有特定命名规则的函数。这个函数名由包名、类名和方法名共同决定例如Java_com_example_myplugin_MyModule_processData。JVM会通过这个“丑陋”但唯一的函数名在加载的so库中找到并调用对应的C函数。数据类型转换JNI提供了海量的jstring,jint,jobject,jarray等类型用于在Java和C之间传递数据。这是最容易出错的地方之一。第四层C/C Native 代码 (.so库)这就是我们的核心算法库用C编写最终被编译成针对不同CPU架构如armeabi-v7a, arm64-v8a, x86的.soShared Object文件。.so库在安卓上相当于Windows的.dll或Linux的.so是编译好的二进制代码。核心工具链选型与理由Android Studio这是谷歌官方的安卓开发IDE我们用它来开发UniApp的原生插件部分。虽然UniApp开发可以用HBuilderX但原生插件尤其是涉及JNI的开发Android Studio在代码提示、NDK集成、编译调试方面有巨大优势。注意我们不是用AS开发整个UniApp应用而是开发其中的“原生插件”模块。NDK (Native Development Kit)这是Android Studio的一个组件它包含了将C/C代码编译成安卓可用的so库所需的全部工具链编译器、链接器、库文件等。没有NDKJNI调用就是无源之水。CMake 或 ndk-build这是两种构建so库的脚本系统。CMake是现在谷歌更推荐的方式语法更现代跨平台性好。我们这篇文章会以CMake为例。你需要在项目中创建一个CMakeLists.txt文件来告诉编译器源文件在哪、依赖哪些库、生成什么名字的so库。UniApp原生插件SDK你需要从UniApp官网下载对应版本的“原生插件开发SDK”。这个SDK里包含了uniapp-v8-release.aarUniApp运行环境和uniplugin_richalert.jar示例插件等关键文件更重要的是它提供了UniModule、UniService等基类的定义我们的插件类必须继承它们。为什么这么选因为这是安卓平台调用C库的“标准答案”。JNI是Java平台的标准NDK是谷歌官方的工具CMake是主流的构建系统。这套组合拳保证了最大的兼容性和最少的“黑魔法”。3. 开发环境搭建与项目结构初始化理论说再多不如动手搭环境。这一步的细节很多一步错可能导致后面编译都过不了。3.1 安装与配置Android Studio及NDK首先去官网下载并安装Android Studio。安装过程中在SDK Manager可以通过欢迎界面右下角的More Actions或打开项目后的File - Settings找到里必须勾选以下两项Android SDK这个一般默认就有。NDK (Side by side)这是关键务必安装。建议选择一个较新且稳定的版本比如25.x或26.x。太老的版本可能缺少某些C特性支持太新的版本有时会有兼容性问题。我目前用25.2.9519653比较稳定。安装好后需要配置环境变量虽然AS内部一般能自动找到但配了更稳妥ANDROID_HOME指向你的Android SDK安装路径例如C:\Users\YourName\AppData\Local\Android\Sdk。在PATH变量中添加%ANDROID_HOME%\ndk\版本号和%ANDROID_HOME%\platform-tools。3.2 创建UniApp原生插件模块我们不从零创建整个安卓App而是创建一个“原生插件”模块最后打包成aar文件供UniApp主工程使用。在Android Studio中选择File - New - New Project 模板选择Empty Views Activity选这个是因为它最干净我们只需要一个壳来编译我们的插件库。给项目起个名比如UniPluginSoDemo包名建议用逆域名格式如com.yourcompany.uniplugin。项目创建好后我们需要把它改造成一个“库模块”Library Module。在项目根目录的settings.gradle文件中确认包含我们的app模块。然后我们需要修改app模块的构建配置使其输出aar而不是apk。修改app模块下的build.gradle文件// 将第一行的 // plugins { id com.android.application } // 改为 plugins { id com.android.library } // 声明这是一个库模块 android { // ... 其他配置保持不变 defaultConfig { // applicationId com.yourcompany.uniplugin // 注释掉或删除这行库模块不需要applicationId minSdk 21 // 根据你的UniApp项目要求设置不能低于UniApp基础库的要求 targetSdk 34 // 建议与UniApp主项目保持一致 versionCode 1 versionName 1.0 } // 添加以下配置指定生成的库文件信息 libraryVariants.all { variant - variant.outputs.all { outputFileName uniplugin-so-demo.${variant.name}.aar } } }导入UniApp原生插件SDK。将下载的SDK中的uniapp-v8-release.aar文件复制到项目app/libs/目录下如果没有libs文件夹就新建一个。修改app模块的build.gradle文件的dependencies部分dependencies { implementation fileTree(dir: libs, include: [*.jar, *.aar]) // 引入libs目录下所有jar和aar // 移除默认的appcompat依赖因为uniapp的aar里可能已经包含了避免冲突 // implementation androidx.appcompat:appcompat:1.6.1 implementation com.alibaba:fastjson:1.1.46.android // Uniapp依赖的JSON库建议加上 // 其他依赖... }3.3 集成NDK并配置CMake在app模块的build.gradle文件的android块中添加externalNativeBuild配置android { // ... defaultConfig 等配置 defaultConfig { // ... 其他配置 externalNativeBuild { cmake { cppFlags -stdc11 -frtti -fexceptions // 指定C标准启用RTTI和异常 // 可以指定生成的so库支持的ABI应用二进制接口即CPU架构 abiFilters armeabi-v7a, arm64-v8a, x86, x86_64 } } } externalNativeBuild { cmake { path src/main/cpp/CMakeLists.txt // 指定CMakeLists.txt文件的路径 version 3.22.1 // 指定CMake版本建议与安装的版本一致 } } // 如果你有现成的so库文件不想用CMake编译也可以将其放入以下目录Gradle会自动打包进去 sourceSets { main { jniLibs.srcDirs [src/main/jniLibs] } } }创建C源代码目录和文件。在app/src/main/目录下新建一个名为cpp的文件夹。在cpp文件夹内新建两个文件native-lib.cpp我们的C JNI函数实现文件。CMakeLists.txtCMake构建脚本。现在你的app模块目录结构应该大致如下app/ ├── libs/ │ └── uniapp-v8-release.aar ├── src/ │ ├── main/ │ │ ├── cpp/ │ │ │ ├── CMakeLists.txt │ │ │ └── native-lib.cpp │ │ ├── java/ │ │ │ └── com/yourcompany/uniplugin/ (你的Java插件类将在这里) │ │ └── res/ │ └── ... └── build.gradle4. 编写C核心代码与JNI接口这是整个流程的技术核心也是最容易让人困惑的部分。我们一步步来。4.1 编写CMakeLists.txt构建脚本打开app/src/main/cpp/CMakeLists.txt写入以下内容# 设置CMake所需的最低版本 cmake_minimum_required(VERSION 3.18.1) # 定义项目名称和使用的编程语言 project(unipluginso) # 创建并命名一个库设置其类型为SHARED动态库即.so # 并提供其源代码的相对路径。你可以添加多个源文件用空格分隔。 add_library( # 设置库的名字最终生成的so文件名为 libunipluginso.so unipluginso # 设置库为共享库 SHARED # 提供源文件的相对路径 native-lib.cpp ) # 查找Android NDK中包含的日志库log并将其路径存储在变量log-lib中。 # 这个库是安卓NDK提供的用于在C代码中向Logcat输出日志调试必备。 find_library( log-lib log ) # 指定在链接原生库时需要链接的库。 # 你链接的库包括你用 add_library() 创建的库应该出现在此处。 target_link_libraries( # 指定目标库 unipluginso # 将日志库链接到目标库 ${log-lib} )这个脚本告诉CMake我要用native-lib.cpp这个源文件生成一个叫做unipluginso的动态链接库.so并且它需要链接安卓的log库。4.2 实现C JNI函数 (native-lib.cpp)现在打开native-lib.cpp。首先我们必须包含必要的头文件#include jni.h // JNI标准头文件定义了JNIEnv, jobject等所有JNI相关类型和函数 #include string // C标准字符串库 #include android/log.h // 安卓日志库头文件用于输出到Logcat // 定义一个日志输出的宏方便使用。__VA_ARGS__表示可变参数。 #define LOG_TAG UniPluginSo // 定义日志标签在Logcat中过滤 #define LOGI(...) __android_log_print(ANDROID_LOG_INFO, LOG_TAG, __VA_ARGS__) #define LOGE(...) __android_log_print(ANDROID_LOG_ERROR, LOG_TAG, __VA_ARGS__)接下来实现我们的核心函数。假设我们需要一个函数接收一个字符串在C层进行一些处理比如反转字符串然后返回结果。// 这是JNI函数的实现。 // 函数名必须遵循规则Java_包名_类名_方法名。 // 这里的包名中的点(.)要替换为下划线(_)。 // 假设我们的Java类全名为com.yourcompany.uniplugin.MyNativeModule // 类中有一个native方法public native String processString(String input); extern C JNIEXPORT jstring JNICALL Java_com_yourcompany_uniplugin_MyNativeModule_processString( JNIEnv* env, // JNI环境指针提供了所有JNI函数是操作Java对象的桥梁 jobject /* this */, // 调用该native方法的Java对象实例。如果方法是static的这里是jclass jstring input) { // 从Java层传入的jstring参数 // 1. 将jstring转换为C风格的字符串char* // 使用GetStringUTFChars获取指向原始字符串的指针。第三个参数isCopy可以传nullptr。 const char *nativeInput env-GetStringUTFChars(input, nullptr); if (nativeInput nullptr) { LOGE(GetStringUTFChars failed!); return nullptr; // 内存不足时可能返回null需要处理 } LOGI(C received string: %s, nativeInput); // 输出日志到Logcat // 2. 在C层进行处理这里简单做字符串反转 std::string cppStr nativeInput; std::string reversedStr(cppStr.rbegin(), cppStr.rend()); // 3. 释放从Java层获取的字符串资源这是一个非常重要的步骤防止内存泄漏。 env-ReleaseStringUTFChars(input, nativeInput); // 4. 将C字符串转换回jstring并返回给Java层 return env-NewStringUTF(reversedStr.c_str()); } // 你可以在这里继续添加更多的JNI函数 // 例如一个处理整型数组的函数 extern C JNIEXPORT jintArray JNICALL Java_com_yourcompany_uniplugin_MyNativeModule_processIntArray( JNIEnv* env, jobject /* this */, jintArray inputArray) { // 获取数组长度和指针 jsize length env-GetArrayLength(inputArray); jint *body env-GetIntArrayElements(inputArray, nullptr); if (body nullptr) { LOGE(GetIntArrayElements failed!); return nullptr; } LOGI(C processing int array of length: %d, length); // 示例将每个元素加1 for (int i 0; i length; i) { body[i] 1; } // 模式参数0-更新原数组并释放C数组JNI_COMMIT-更新原数组但不释放JNI_ABORT-释放C数组但不更新原数组 env-ReleaseIntArrayElements(inputArray, body, 0); // 因为我们在原数组上操作所以直接返回传入的数组即可。 // 如果需要返回一个新数组可以用env-NewIntArray创建。 return inputArray; }关键点解析与避坑指南函数签名是重中之重extern C是为了防止C编译器对函数名进行修饰mangle确保链接器能找到正确的C风格函数名。JNIEXPORT和JNICALL是平台相关的宏确保函数能被JVM正确调用。函数名必须一字不差包括大小写。一个快速验证方法是先写好Java的native方法声明然后用javah工具或Android Studio的javac -h命令自动生成头文件头文件里的函数签名就是标准答案。JNIEnv的使用*所有与Java对象的交互创建、访问、调用方法都必须通过JNIEnv*指针进行。每个线程都有自己的JNIEnv不能跨线程使用。如果需要在子线程中调用JNI必须通过JavaVM-AttachCurrentThread获取当前线程的JNIEnv。内存管理GetStringUTFChars、GetIntArrayElements这类函数可能会在本地代码中创建一份数据的副本也可能直接返回指向Java堆中原始数据的指针。无论哪种情况都必须使用对应的Release...函数来释放资源否则会导致内存泄漏或数据不同步。异常处理在JNI函数中如果发生异常比如Java层抛出了异常C代码应该立即返回让异常传播到Java层。不要试图在C层“吞掉”异常。可以使用env-ExceptionCheck()或env-ExceptionOccurred()来检查是否有未处理的Java异常。日志输出在C层使用__android_log_print输出日志至关重要这是调试JNI代码最主要的手段。记得在Logcat中过滤你定义的LOG_TAG。5. 创建UniApp原生插件Java类现在我们需要在Java层创建桥梁将UniApp的JS调用转发给我们的JNI函数。5.1 创建插件模块类在app/src/main/java/com/yourcompany/uniplugin/目录下创建一个新的Java类例如MyNativeModule.java。这个类需要继承UniApp的UniModule类。package com.yourcompany.uniplugin; import com.alibaba.fastjson.JSONObject; import io.dcloud.feature.uniapp.annotation.UniJSMethod; import io.dcloud.feature.uniapp.bridge.UniJSCallback; import io.dcloud.feature.uniapp.common.UniModule; // 必须继承UniModule public class MyNativeModule extends UniModule { // 静态代码块用于加载我们的C动态库。 // 库的名字是“unipluginso”对应CMakeLists.txt中add_library定义的名字 // 系统会自动加上前缀“lib”和后缀“.so”所以实际加载的是“libunipluginso.so”。 static { System.loadLibrary(unipluginso); } // 声明一个native方法。这个方法没有方法体其实现就在我们上面写的C代码里。 // 方法名和签名必须与C函数完全匹配。 public native String processString(String input); public native int[] processIntArray(int[] inputArray); // 对应处理int数组的native方法 // 定义一个供UniApp的JS调用的方法。 // UniJSMethod注解表明这是一个暴露给JS的方法。 // (uiThread false) 表示这个方法在非UI线程执行适合耗时操作。 UniJSMethod(uiThread false) public void callNativeProcessString(JSONObject options, UniJSCallback callback) { // 从JS传递的参数中获取输入字符串 String inputStr options.getString(input); if (inputStr null || inputStr.isEmpty()) { // 如果参数错误通过callback回调错误信息给JS if (callback ! null) { JSONObject result new JSONObject(); result.put(code, -1); result.put(msg, Input string is empty); callback.invoke(result); } return; } try { // 调用native方法这是真正的C代码执行处 String resultStr processString(inputStr); // 将处理结果封装通过callback回调给JS JSONObject result new JSONObject(); result.put(code, 0); result.put(msg, success); result.put(data, resultStr); if (callback ! null) { callback.invoke(result); } } catch (Exception e) { e.printStackTrace(); // 处理异常 JSONObject result new JSONObject(); result.put(code, -2); result.put(msg, Native process failed: e.getMessage()); if (callback ! null) { callback.invoke(result); } } } UniJSMethod(uiThread false) public void callNativeProcessIntArray(JSONObject options, UniJSCallback callback) { // 假设JS传递一个数组{ data: [1, 2, 3, 4, 5] } // FastJSON的解析方式可能略有不同这里假设options.getJSONArray能工作 // 更健壮的做法是 options.get(data) 然后判断类型 String dataStr options.getString(data); if (dataStr null) { // 错误处理 return; } // 这里需要将JSON数组字符串转换为int[]简化起见我们假设直接传入了List // 实际开发中JS传过来的参数结构需要前后端约定好 // 此处仅作示例省略了复杂的类型转换代码 // int[] inputArray ...; // 调用native方法 // int[] resultArray processIntArray(inputArray); // 将resultArray转换回JSON格式回调 // ... } }5.2 注册插件到UniApp框架UniApp原生插件需要在assets目录下的特定配置文件中注册这样UniApp运行时才能知道并加载你的插件。在app/src/main/assets/目录下如果没有就创建新建一个名为dcloud_uniplugins.json的文件。编辑该文件内容如下{ nativePlugins: [ { hooksClass: , // 生命周期钩子类非必需 plugins: [ { type: module, // 插件类型module 或 component name: MyNativeModule, // 在JS中调用时使用的模块名 class: com.yourcompany.uniplugin.MyNativeModule // 插件类的全限定名 } ] } ] }这个配置文件告诉UniApp我有一个名为MyNativeModule的原生模块它的实现类是com.yourcompany.uniplugin.MyNativeModule。6. 编译、打包与集成到UniApp主项目至此原生插件部分的代码就完成了。接下来需要把它编译打包并集成到你的UniApp主工程中。6.1 编译生成aar包在Android Studio中点击右侧的Gradle工具窗口展开UniPluginSoDemo - app - Tasks - build双击assembleRelease或assembleDebug。Gradle会开始编译项目。编译成功后你可以在app/build/outputs/aar/目录下找到生成的aar文件例如app-release.aar或者你之前在gradle中自定义的名字uniplugin-so-demo.release.aar。这个aar文件里已经包含了编译好的Java字节码你的MyNativeModule类。编译好的、针对不同ABI的so库libunipluginso.so。资源文件assets/dcloud_uniplugins.json。清单文件等。6.2 在UniApp主项目中集成插件aar在你的UniApp项目根目录下找到或创建nativeplugins文件夹与pages目录同级。在这个文件夹下为你插件创建一个子文件夹例如my-native-so-plugin。在my-native-so-plugin文件夹内创建标准的UniApp原生插件目录结构my-native-so-plugin/ ├── android/ // 安卓插件目录 │ └── uniplugin_so_demo.aar (将我们生成的aar文件复制到这里并重命名) └── package.json (插件的配置文件)编辑package.json文件{ name: my-native-so-plugin, id: my-native-so-plugin, version: 1.0.0, description: 一个调用C so库的UniApp原生插件示例, _dp_type: nativeplugin, _dp_nativeplugin: { android: { plugins: [ { type: module, name: MyNativeModule, class: com.yourcompany.uniplugin.MyNativeModule } ], integrateType: aar, minSdkVersion: 21 // 与插件模块中设置的最低版本一致 } } }注意class字段必须与Java类的全限定名完全一致。6.3 在UniApp的JS中调用插件现在你可以在你的Vue页面或任何JS代码中调用这个原生插件了。// 首先需要使用 uni.requireNativePlugin 获取原生模块的引用 // 参数是你在 package.json 和 dcloud_uniplugins.json 中定义的 name const myNativeModule uni.requireNativePlugin(MyNativeModule); // 然后就可以调用模块上暴露的方法了 export default { methods: { async processWithNative() { try { // 调用方式一使用Callback如我们Java方法所写 myNativeModule.callNativeProcessString({ input: Hello from UniApp JS! }, (result) { console.log(Native process result (callback):, result); if (result.code 0) { uni.showToast({ title: 反转结果: ${result.data} }); } else { uni.showToast({ title: 处理失败: ${result.msg}, icon: none }); } }); // 注意如果native方法不是异步的或者你想用Promise风格可以自己封装。 // 调用方式二封装为Promise (示例) const processStringPromise (input) new Promise((resolve, reject) { myNativeModule.callNativeProcessString({ input }, (result) { if (result.code 0) { resolve(result.data); } else { reject(new Error(result.msg)); } }); }); const reversed await processStringPromise(Async Call); console.log(Reversed (Promise):, reversed); } catch (error) { console.error(调用原生插件失败:, error); uni.showToast({ title: 调用失败, icon: none }); } } } }7. 真机调试、常见问题排查与性能优化代码写完了集成也做了但第一次运行大概率不会一帆风顺。下面是一些实战中必然会遇到的坑和解决方法。7.1 真机调试与日志查看连接设备用USB线连接安卓手机并开启USB调试模式。运行UniApp项目在HBuilderX中选择你的项目运行到“Android App基座”。查看日志这是调试的生命线。打开Android Studio的Logcat工具窗口View - Tool Windows - Logcat。在设备选择框中选择你的真机在过滤框中输入你的日志标签比如UniPluginSo就能看到C层LOGI/LOGE输出的信息。同时也要过滤Console查看JS层的console.log。7.2 常见崩溃与问题排查java.lang.UnsatisfiedLinkError: No implementation found for...原因这是最典型的错误意味着Java层声明的native方法在加载的so库中找不到对应的实现。排查步骤检查函数名核对C函数名是否与Java native方法名完全匹配包括包名、类名、方法名。特别注意如果Java类在内部类中函数名会包含$符号。检查so库是否打包进去检查最终生成的apk或app中lib/armeabi-v7a等ABI目录下是否存在libunipluginso.so文件。可以用解压软件打开apk查看。检查so库加载时机确保System.loadLibrary在调用任何native方法之前执行。通常放在类的静态代码块中是安全的。检查ABI兼容性你的手机CPU架构通常是arm64-v8a是否在abiFilters中包含了so库是否是为该架构编译的java.lang.UnsatisfiedLinkError: dlopen failed: library libunipluginso.so not found原因系统在默认的库搜索路径下找不到你的so文件。解决确保你的aar文件被正确集成并且UniApp的打包过程将其解压到了apk的lib目录下。检查package.json的integrateType是否为aar。Fatal signal 11 (SIGSEGV), code 1 (SEGV_MAPERR)原因段错误Segmentation Fault这是C/C层的“噩梦”。通常是由于访问了非法内存空指针、野指针、数组越界、使用已释放的内存引起的。排查仔细检查所有JNI函数中对JNIEnv*和jobject等参数的使用。检查所有通过Get...系列函数获取的指针在使用前是否判空。确保每个Get...都有对应的Release...。使用adb logcat查看更详细的native崩溃堆栈定位到具体的C代码行。JS调用插件方法无反应或返回undefined原因JS到Java的桥接可能出了问题。排查检查uni.requireNativePlugin的参数是否与package.json中的name一致。检查Java方法是否使用了UniJSMethod注解。检查dcloud_uniplugins.json文件是否在assets目录下且格式正确。在Java方法的入口处加Log.d看JS调用是否触发了Java方法。7.3 性能优化与最佳实践减少JNI调用开销JNI调用本身有一定开销。避免在循环或高频函数中频繁进行JNI调用和简单的数据交换。如果可能将一批数据一次性传入C处理再将结果一次性返回。注意线程安全JNIEnv*是线程相关的。如果你在C中创建了新的线程比如用std::thread并需要在这个新线程中回调Java方法不能直接使用主线程的JNIEnv。你需要通过JavaVM可以在JNI_OnLoad函数中保存全局引用来获取当前线程的JNIEnvjavaVM-AttachCurrentThread(env, nullptr)使用完后记得DetachCurrentThread()。管理本地引用Local Reference和全局引用Global Reference在JNI函数中创建的jobject、jstring、jarray等默认都是本地引用在函数返回后可能会被垃圾回收。如果需要在函数返回后继续持有这些对象比如保存在C的全局变量中必须使用env-NewGlobalRef()创建全局引用并在不再需要时用env-DeleteGlobalRef()释放否则会导致严重的内存泄漏。本地引用过多也可能导致local reference table overflow错误。在循环中创建大量本地引用时可以使用env-PushLocalFrame和env-PopLocalFrame来管理本地引用的生命周期。妥善处理异常在调用可能抛出异常的JNI函数如CallObjectMethod后使用env-ExceptionCheck()检查异常。如果发生异常应先调用env-ExceptionDescribe()打印异常信息然后调用env-ExceptionClear()清除异常再决定是返回错误码还是让异常传播到Java层。So库的尺寸优化发布时可以只保留你目标设备主流架构的so库如arm64-v8a在abiFilters中只保留这一个可以显著减小APK体积。对于C代码启用编译优化在CMakeLists.txt中设置-O2或-O3并移除调试符号-g标志也能减小so库大小。打通UniApp到C so库的调用链路确实比纯前端开发多了几层复杂度但带来的性能收益和能力扩展是质的飞跃。整个过程的关键在于理解每一层的职责JS桥接、JNI转换、Native计算和它们之间通信的协议函数签名、数据转换、内存管理。多动手实践多查看Logcat日志从简单的字符串传递开始逐步尝试更复杂的数据结构数组、对象、回调慢慢就能驾驭这套技术栈。当你第一次看到JS传来的数据经过C高速处理并返回结果时那种成就感会让你觉得这些折腾都是值得的。