1. 项目背景与核心需求在Android应用开发中我们经常会遇到需要复用已有C语言代码库的情况。特别是在性能敏感的场景下如图像处理、音视频编解码、加密算法等C语言的执行效率优势尤为明显。而Android Studio作为官方推荐的IDE提供了完善的NDK工具链支持使得在Java/Kotlin主程序中调用C/C代码成为可能。这个项目的核心目标是在Android Studio环境下实现C代码对C语言模块的调用。这种混合编程模式在实际开发中非常常见比如复用已有的C语言算法库如FFmpeg、OpenCV的部分模块需要极致性能优化的关键路径跨平台代码的共享iOS/macOS/Linux等平台同样使用C接口2. 环境准备与基础配置2.1 NDK工具链安装首先确保Android Studio已安装NDKNative Development Kit和CMake通过SDK Manager安装NDK建议选择LTS版本如25.xCMake3.22.1在项目的local.properties中添加NDK路径ndk.dir/Users/yourname/Library/Android/sdk/ndk/25.2.95196532.2 项目结构规划推荐采用以下目录结构app/ ├── src/ │ ├── main/ │ │ ├── cpp/ │ │ │ ├── CMakeLists.txt │ │ │ ├── native-lib.cpp # C入口文件 │ │ │ └── myclib/ # C语言代码目录 │ │ │ ├── algo.c │ │ │ └── algo.h3. C/C混合编程实现3.1 C语言模块编写以简单的CRC16校验算法为例algo.h#ifndef MYCLIB_ALGO_H #define MYCLIB_ALGO_H #ifdef __cplusplus extern C { #endif uint16_t crc16(const uint8_t *data, size_t length); #ifdef __cplusplus } #endif #endif //MYCLIB_ALGO_H对应的实现algo.c#include algo.h uint16_t crc16(const uint8_t *data, size_t length) { uint16_t crc 0xFFFF; for (size_t i 0; i length; i) { crc ^ data[i]; for (int j 0; j 8; j) { if (crc 1) { crc (crc 1) ^ 0xA001; } else { crc 1; } } } return crc; }关键点说明extern C声明确保C编译器使用C风格的函数命名规则头文件保护宏防止重复包含使用标准C数据类型uint16_t等保证跨平台一致性3.2 C调用层实现在native-lib.cpp中调用C函数#include jni.h #include myclib/algo.h extern C JNIEXPORT jshort JNICALL Java_com_example_myapp_MainActivity_calculateCrc16( JNIEnv* env, jobject /* this */, jbyteArray data) { jsize length env-GetArrayLength(data); jbyte* elements env-GetByteArrayElements(data, nullptr); uint16_t result crc16(reinterpret_castuint8_t*(elements), length); env-ReleaseByteArrayElements(data, elements, JNI_ABORT); return static_castjshort(result); }3.3 CMake配置关键点CMakeLists.txt的典型配置cmake_minimum_required(VERSION 3.22.1) add_library( # 最终生成的动态库名称 native-lib SHARED native-lib.cpp myclib/algo.c) find_library( log-lib log ) target_link_libraries( native-lib ${log-lib} )特别注意C源文件需要显式添加到add_library中如果C代码需要特殊编译选项可以单独设置set_source_files_properties(myclib/algo.c PROPERTIES COMPILE_FLAGS -O2)4. Java/Kotlin层调用4.1 加载原生库在MainActivity中class MainActivity : AppCompatActivity() { init { System.loadLibrary(native-lib) } external fun calculateCrc16(data: ByteArray): Short }4.2 实际调用示例val testData Hello,NDK.toByteArray() val crc calculateCrc16(testData) Log.d(CRCResult, Calculated CRC16: ${crc.toInt() and 0xFFFF})5. 调试与问题排查5.1 常见编译错误头文件找不到fatal error: myclib/algo.h file not found解决方案确保CMake中include_directories包含正确路径检查头文件路径大小写Linux系统区分大小写符号未定义undefined reference to crc16解决方案检查C函数是否正确定义为extern C确认.c文件已添加到CMake配置5.2 运行时问题JNI参数处理错误Java数组需要正确获取/释放jbyte* elements env-GetByteArrayElements(data, nullptr); // 使用后必须释放 env-ReleaseByteArrayElements(data, elements, JNI_ABORT);注意jshort与C的uint16_t类型转换ABI兼容性问题在build.gradle中指定支持的ABIndk { abiFilters armeabi-v7a, arm64-v8a, x86_64 }6. 性能优化建议减少JNI调用开销批量处理数据避免频繁跨越JNI边界对于简单计算考虑使用CriticalNative注解API级别26内存管理优化使用GetPrimitiveArrayCritical获取直接指针需谨慎使用考虑使用NDK中的malloc/free替代JNI内存操作多线程注意事项C/C代码需要自行处理线程安全避免在JNI调用中持有锁过长时间7. 高级应用场景7.1 回调函数实现C层定义回调接口typedef void (*ProgressCallback)(int percent); void long_running_task(ProgressCallback callback) { for (int i 0; i 100; i) { callback(i); usleep(100000); } }C/JNI层实现回调void progressHandler(int percent) { // 通过JNI调用Java方法 } extern C JNIEXPORT void JNICALL Java_com_example_myapp_MainActivity_startTask(JNIEnv* env, jobject obj) { long_running_task(progressHandler); }7.2 复杂数据结构传递处理自定义对象数组struct SensorData { float temperature; float humidity; long timestamp; }; // Java端定义对应的类 public class SensorData { public float temperature; public float humidity; public long timestamp; }通过JNI转换jobjectArray javaArray env-NewObjectArray(count, sensorDataClass, nullptr); for (int i 0; i count; i) { jobject dataObj env-AllocObject(sensorDataClass); // 设置字段值... env-SetObjectArrayElement(javaArray, i, dataObj); env-DeleteLocalRef(dataObj); }8. 替代方案对比方案优点缺点直接C调用C性能最佳无额外开销需要手动管理类型转换JNI直接调用C统一接口管理需要处理Java-C类型转换SWIG工具自动生成减少手写JNI代码量增加构建复杂度灵活性降低Android Rust绑定内存安全性更好学习曲线陡峭生态较新对于大多数性能敏感场景直接C调用C仍然是Android NDK开发中最可靠的选择。 
长河君 · 2026/9/11 6:25:07 · 阅读 1.2k Android NDK开发：C++调用C语言模块实战指南
1. 项目背景与核心需求在Android应用开发中我们经常会遇到需要复用已有C语言代码库的情况。特别是在性能敏感的场景下如图像处理、音视频编解码、加密算法等C语言的执行效率优势尤为明显。而Android Studio作为官方推荐的IDE提供了完善的NDK工具链支持使得在Java/Kotlin主程序中调用C/C代码成为可能。这个项目的核心目标是在Android Studio环境下实现C代码对C语言模块的调用。这种混合编程模式在实际开发中非常常见比如复用已有的C语言算法库如FFmpeg、OpenCV的部分模块需要极致性能优化的关键路径跨平台代码的共享iOS/macOS/Linux等平台同样使用C接口2. 环境准备与基础配置2.1 NDK工具链安装首先确保Android Studio已安装NDKNative Development Kit和CMake通过SDK Manager安装NDK建议选择LTS版本如25.xCMake3.22.1在项目的local.properties中添加NDK路径ndk.dir/Users/yourname/Library/Android/sdk/ndk/25.2.95196532.2 项目结构规划推荐采用以下目录结构app/ ├── src/ │ ├── main/ │ │ ├── cpp/ │ │ │ ├── CMakeLists.txt │ │ │ ├── native-lib.cpp # C入口文件 │ │ │ └── myclib/ # C语言代码目录 │ │ │ ├── algo.c │ │ │ └── algo.h3. C/C混合编程实现3.1 C语言模块编写以简单的CRC16校验算法为例algo.h#ifndef MYCLIB_ALGO_H #define MYCLIB_ALGO_H #ifdef __cplusplus extern C { #endif uint16_t crc16(const uint8_t *data, size_t length); #ifdef __cplusplus } #endif #endif //MYCLIB_ALGO_H对应的实现algo.c#include algo.h uint16_t crc16(const uint8_t *data, size_t length) { uint16_t crc 0xFFFF; for (size_t i 0; i length; i) { crc ^ data[i]; for (int j 0; j 8; j) { if (crc 1) { crc (crc 1) ^ 0xA001; } else { crc 1; } } } return crc; }关键点说明extern C声明确保C编译器使用C风格的函数命名规则头文件保护宏防止重复包含使用标准C数据类型uint16_t等保证跨平台一致性3.2 C调用层实现在native-lib.cpp中调用C函数#include jni.h #include myclib/algo.h extern C JNIEXPORT jshort JNICALL Java_com_example_myapp_MainActivity_calculateCrc16( JNIEnv* env, jobject /* this */, jbyteArray data) { jsize length env-GetArrayLength(data); jbyte* elements env-GetByteArrayElements(data, nullptr); uint16_t result crc16(reinterpret_castuint8_t*(elements), length); env-ReleaseByteArrayElements(data, elements, JNI_ABORT); return static_castjshort(result); }3.3 CMake配置关键点CMakeLists.txt的典型配置cmake_minimum_required(VERSION 3.22.1) add_library( # 最终生成的动态库名称 native-lib SHARED native-lib.cpp myclib/algo.c) find_library( log-lib log ) target_link_libraries( native-lib ${log-lib} )特别注意C源文件需要显式添加到add_library中如果C代码需要特殊编译选项可以单独设置set_source_files_properties(myclib/algo.c PROPERTIES COMPILE_FLAGS -O2)4. Java/Kotlin层调用4.1 加载原生库在MainActivity中class MainActivity : AppCompatActivity() { init { System.loadLibrary(native-lib) } external fun calculateCrc16(data: ByteArray): Short }4.2 实际调用示例val testData Hello,NDK.toByteArray() val crc calculateCrc16(testData) Log.d(CRCResult, Calculated CRC16: ${crc.toInt() and 0xFFFF})5. 调试与问题排查5.1 常见编译错误头文件找不到fatal error: myclib/algo.h file not found解决方案确保CMake中include_directories包含正确路径检查头文件路径大小写Linux系统区分大小写符号未定义undefined reference to crc16解决方案检查C函数是否正确定义为extern C确认.c文件已添加到CMake配置5.2 运行时问题JNI参数处理错误Java数组需要正确获取/释放jbyte* elements env-GetByteArrayElements(data, nullptr); // 使用后必须释放 env-ReleaseByteArrayElements(data, elements, JNI_ABORT);注意jshort与C的uint16_t类型转换ABI兼容性问题在build.gradle中指定支持的ABIndk { abiFilters armeabi-v7a, arm64-v8a, x86_64 }6. 性能优化建议减少JNI调用开销批量处理数据避免频繁跨越JNI边界对于简单计算考虑使用CriticalNative注解API级别26内存管理优化使用GetPrimitiveArrayCritical获取直接指针需谨慎使用考虑使用NDK中的malloc/free替代JNI内存操作多线程注意事项C/C代码需要自行处理线程安全避免在JNI调用中持有锁过长时间7. 高级应用场景7.1 回调函数实现C层定义回调接口typedef void (*ProgressCallback)(int percent); void long_running_task(ProgressCallback callback) { for (int i 0; i 100; i) { callback(i); usleep(100000); } }C/JNI层实现回调void progressHandler(int percent) { // 通过JNI调用Java方法 } extern C JNIEXPORT void JNICALL Java_com_example_myapp_MainActivity_startTask(JNIEnv* env, jobject obj) { long_running_task(progressHandler); }7.2 复杂数据结构传递处理自定义对象数组struct SensorData { float temperature; float humidity; long timestamp; }; // Java端定义对应的类 public class SensorData { public float temperature; public float humidity; public long timestamp; }通过JNI转换jobjectArray javaArray env-NewObjectArray(count, sensorDataClass, nullptr); for (int i 0; i count; i) { jobject dataObj env-AllocObject(sensorDataClass); // 设置字段值... env-SetObjectArrayElement(javaArray, i, dataObj); env-DeleteLocalRef(dataObj); }8. 替代方案对比方案优点缺点直接C调用C性能最佳无额外开销需要手动管理类型转换JNI直接调用C统一接口管理需要处理Java-C类型转换SWIG工具自动生成减少手写JNI代码量增加构建复杂度灵活性降低Android Rust绑定内存安全性更好学习曲线陡峭生态较新对于大多数性能敏感场景直接C调用C仍然是Android NDK开发中最可靠的选择。