1. 环境准备与基础概念在开始编写第一个JNI程序之前我们需要确保开发环境配置正确。Android Studio是官方推荐的开发工具它内置了对NDK和CMake的支持。1.1 安装必要组件首先确保你的Android Studio已经安装了以下组件Android SDKNDK (Native Development Kit)CMake在Android Studio中可以通过SDK Manager进行安装打开Android Studio点击菜单栏的Tools SDK Manager在SDK Tools选项卡中勾选NDK (Side by side)和CMake点击Apply进行安装提示NDK版本建议选择较新的稳定版但不要盲目追求最新版本某些项目可能需要特定版本的NDK。1.2 JNI基础概念JNI(Java Native Interface)是Java平台提供的一种机制允许Java代码与本地代码(通常是C/C)相互调用。在Android开发中JNI的主要用途包括重用现有的C/C库实现高性能计算密集型任务访问底层系统功能JNI的工作流程大致如下Java代码中声明native方法使用javah或javac -h生成头文件实现C/C本地方法编译生成动态链接库(.so文件)Java代码中加载库并调用native方法2. 创建JNI项目结构2.1 新建Android项目在Android Studio中创建一个新项目选择Empty Activity模板在Configure your project页面确保Language选择Java(虽然Kotlin也可以但Java更传统)勾选Include C support选项Android Studio会自动生成基本的JNI项目结构包括app/src/main/cpp目录存放C/C源文件CMakeLists.txtCMake构建脚本自动配置的build.gradle文件2.2 项目结构解析典型的JNI项目结构如下app/ ├── src/ │ ├── main/ │ │ ├── java/ │ │ │ └── com/example/myapp/ │ │ ├── cpp/ │ │ │ ├── CMakeLists.txt │ │ │ └── native-lib.cpp │ │ └── res/ ├── build.gradle关键文件说明native-lib.cpp默认生成的C源文件CMakeLists.txt定义如何构建native库build.gradle配置外部native构建3. 实现Hello World功能3.1 Java层代码首先在MainActivity中添加native方法声明public class MainActivity extends AppCompatActivity { static { System.loadLibrary(native-lib); } public native String stringFromJNI(); Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); TextView tv findViewById(R.id.sample_text); tv.setText(stringFromJNI()); } }关键点说明System.loadLibrary(native-lib)加载我们即将创建的本地库native关键字声明这是一个本地方法在onCreate中调用该方法并显示结果3.2 生成头文件现代Android Studio会自动处理头文件生成但了解手动生成方法很有帮助javac -h output-directory java-source-files例如javac -h ./jni com/example/myapp/MainActivity.java这将生成一个名为com_example_myapp_MainActivity.h的头文件。3.3 C层实现打开native-lib.cpp文件实现我们的Hello World功能#include jni.h #include string extern C JNIEXPORT jstring JNICALL Java_com_example_myapp_MainActivity_stringFromJNI( JNIEnv* env, jobject /* this */) { std::string hello Hello from C; return env-NewStringUTF(hello.c_str()); }代码解析#include jni.h包含JNI头文件extern C确保C编译器使用C风格的名称修饰JNIEXPORT和JNICALLJNI必需的宏定义方法名遵循Java_包名_类名_方法名的命名规则JNIEnv*提供访问JNI环境的接口jobjectJava对象的引用(这里对应MainActivity实例)env-NewStringUTF()将C字符串转换为Java字符串4. CMake配置详解4.1 CMakeLists.txt解析Android Studio生成的CMakeLists.txt通常如下cmake_minimum_required(VERSION 3.4.1) add_library( # 设置库名称 native-lib # 设置库类型 SHARED # 提供源文件路径 native-lib.cpp ) find_library( # 设置路径变量名 log-lib # 指定要查找的NDK库名称 log ) target_link_libraries( # 指定目标库 native-lib # 链接日志库到目标库 ${log-lib} )关键指令说明cmake_minimum_required指定CMake最低版本要求add_library定义要构建的库find_library查找NDK提供的预构建库target_link_libraries指定库依赖关系4.2 构建类型配置可以在build.gradle中配置不同的构建类型android { defaultConfig { externalNativeBuild { cmake { cppFlags // 可以在这里添加特定于所有构建类型的参数 } } } buildTypes { release { externalNativeBuild { cmake { // 发布版本特定配置 cppFlags -DNDEBUG } } } debug { externalNativeBuild { cmake { // 调试版本特定配置 cppFlags -DDEBUG } } } } externalNativeBuild { cmake { path src/main/cpp/CMakeLists.txt version 3.10.2 } } }5. 构建与调试技巧5.1 构建过程构建过程分为两个主要部分Java代码编译为DEX字节码C代码编译为平台特定的原生库(.so文件)构建完成后APK中将包含针对不同ABI的原生库通常位于lib/ ├── arm64-v8a/ │ └── libnative-lib.so ├── armeabi-v7a/ │ └── libnative-lib.so ├── x86/ │ └── libnative-lib.so └── x86_64/ └── libnative-lib.so5.2 调试技巧Android Studio提供了强大的原生代码调试功能设置断点直接在C代码中点击行号左侧设置断点调试配置选择Debug配置而非RunLLDB调试器Android Studio使用LLDB作为原生代码调试器查看原生变量在调试窗口可以查看C变量值混合调试可以同时调试Java和C代码注意调试原生代码需要设备支持某些模拟器可能不完全支持所有调试功能。5.3 常见问题排查UnsatisfiedLinkError通常表示库加载失败检查System.loadLibrary()的参数是否与CMake中定义的库名一致确保库文件被打包到APK中检查ABI过滤器设置JNI方法找不到检查方法签名是否完全匹配确保方法名遵循JNI命名规范使用javap -s查看准确的Java方法签名构建失败检查NDK和CMake版本是否兼容确保所有源文件路径正确查看Gradle Console获取详细错误信息6. 进阶主题与最佳实践6.1 JNI引用管理JNI中有三种引用类型局部引用(Local Reference)在native方法执行期间有效全局引用(Global Reference)显式创建直到显式释放前都有效弱全局引用(Weak Global Reference)不阻止垃圾回收的全局引用最佳实践及时释放不再需要的局部引用对于需要长期持有的对象使用全局引用注意避免局部引用表溢出6.2 异常处理JNI中的异常处理机制jthrowable exc env-ExceptionOccurred(); if (exc) { env-ExceptionDescribe(); // 打印异常信息到logcat env-ExceptionClear(); // 清除异常 // 处理异常情况 }关键点JNI函数调用后应立即检查异常在异常未清除前不要调用其他JNI函数可以将异常抛回Java层处理6.3 性能优化减少JNI调用次数批量处理数据而非频繁调用使用直接缓冲区对于大量数据使用ByteBuffer缓存字段ID和方法ID避免重复查找选择合适的数据类型避免不必要的转换6.4 多线程考虑JNIEnv是线程相关的不能在线程间共享需要时可以通过JavaVM获取当前线程的JNIEnv注意同步访问共享数据考虑使用线程安全的全局引用7. 项目扩展与进阶学习7.1 添加更多JNI方法要添加新的JNI方法遵循以下步骤在Java类中添加新的native方法声明在C文件中实现对应方法确保方法签名正确重新构建项目7.2 集成现有C/C库集成现有库的通用步骤将库源代码放入cpp目录或设置正确的包含路径在CMakeLists.txt中添加库的构建规则添加必要的链接指令创建适当的JNI包装函数7.3 学习资源推荐官方文档Android NDK官方文档JNI规范CMake官方文档书籍《Android C with NDK》《JNI Programming Guide》开源项目Android NDK samples流行的开源项目如FFmpeg的Android端口在实际项目中JNI开发往往会遇到各种挑战特别是在处理复杂数据结构、内存管理和多线程时。建议从简单项目开始逐步积累经验。记住良好的错误处理和日志记录是JNI开发的关键因为原生代码的崩溃往往会导致整个应用崩溃。