1. 项目概述为什么Android开发者需要懂C如果你是一个Android开发者最近在项目里遇到了性能瓶颈或者想集成一个用C写的牛逼开源库又或者面试时被问到了JNI和NDK那你大概率已经意识到光靠Java或Kotlin可能不够用了。没错我说的就是Android NDKNative Development Kit。它让你能在Android应用里直接运行C和C代码听起来很酷但对很多习惯了高级语言的移动端开发者来说这扇门背后仿佛是一个充满指针、内存管理和编译错误的“黑暗森林”。我最初接触NDK是因为一个图像处理项目。纯Java实现的滤镜在低端机上卡成PPT而用OpenCV一个C写的计算机视觉库通过NDK调用性能直接起飞。但我也踩了无数的坑.so库加载失败、内存泄漏导致应用闪退、Java和C之间数据类型转换的诡异错误……这些经历让我明白想玩转NDKC基础不是“加分项”而是“入场券”。这篇内容就是帮你把这张入场券拿到手。我们不求成为C专家但至少要能看懂、能修改、能写出稳定可用的NDK代码让C成为你解决性能难题的利器而不是项目里的“定时炸弹”。2. 核心需求解析NDK开发中的C到底要学什么很多Android开发者一听到要学C就头大感觉又要从“Hello World”重新开始。其实不然对于NDK开发我们需要的是一套“精准打击”的知识体系而不是面面俱到的C教科书。你的核心目标很明确写出能被JNIJava Native Interface正确调用、且能在Android系统上安全稳定运行的C代码。基于这个目标我们需要聚焦以下几个层面2.1 与Java的交互能力这是NDK开发的第一道关卡。C代码如何被Java调用参数怎么传返回值怎么处理这涉及到JNI的基础用法而理解JNI的前提是理解C的基本函数定义、数据类型特别是与jint, jstring等JNI类型的对应关系和头文件.h的作用。2.2 内存管理的自觉性在Java/Kotlin的世界里垃圾回收器GC帮你打理一切。但在C里你申请的内存new出来的对象、malloc分配的空间必须自己负责释放delete,free。内存泄漏在Android NDK中后果很严重轻则应用越来越卡重则直接崩溃。你必须对堆栈内存、指针、引用的生命周期有清晰的概念。2.3 平台兼容性与ABI你的C代码最终会被编译成.so共享对象库供Android应用加载。而Android设备有armeabi-v7a, arm64-v8a, x86等多种CPU架构ABI。你的C代码尤其是涉及内联汇编或特定编译器扩展时和使用的第三方库都需要考虑跨平台的兼容性。这要求你对编译过程和基本的预处理器指令如#ifdef __ANDROID__有所了解。2.4 基础数据结构和算法虽然NDK允许你使用C标准库STL但在资源受限的移动设备上盲目使用std::vector或std::string可能带来不必要的开销。你需要了解数组、指针、结构体等更底层的数据组织方式以及如何高效地操作它们。这对于处理音视频帧、图像像素块等大量数据至关重要。简单说NDK所需的C知识是以解决JNI调用和系统级性能问题为导向的、强调安全和效率的实践性知识。下面我们就围绕这几个核心需求拆解必备的C基础知识。3. 环境准备搭建你的C/NDK开发与学习环境工欲善其事必先利其器。一个好的环境能让你避开很多初学者的坑。对于NDK相关的C学习我推荐以下组合它兼顾了学习、调试和实际项目开发。3.1 核心工具链选择Android Studio (主力IDE) 这是Android开发的官方标准对NDK的支持已经非常完善。它内置了CMake和LLDB调试器可以无缝地进行Java/Kotlin和C的混合调试。确保你安装时勾选了“Android NDK”和“CMake”组件。Visual Studio Code (辅助编辑器) 如果你需要快速查看、编写独立的C代码片段或测试小程序VSCode配上C/C扩展体验非常轻快。但对于完整的Android NDK项目还是建议以Android Studio为主。NDK版本管理 通过Android Studio的SDK Manager下载NDK。关键建议不要总是用最新的NDK。新版本可能包含不兼容的变更。对于一个生产项目建议选择一个稳定的版本例如NDK r25c并在build.gradle中固定。对于学习可以使用Android Studio推荐的稳定版。3.2 第一个“Hello World”项目配置在Android Studio中新建一个“Native C”项目模板是最快的方式。创建完成后关注这几个文件app/src/main/cpp/native-lib.cpp: 这是你的C源码入口。模板已经包含了一个从Java传递字符串并返回新字符串的函数。app/build.gradle 查看android块下的defaultConfig和externalNativeBuild配置。这里定义了CMake的路径和参数。app/src/main/cpp/CMakeLists.txt 这是C的构建脚本。它定义了要编译哪些源文件生成什么库SHARED或STATIC以及链接哪些库。注意 初次构建时Android Studio会下载CMake和NDK工具链可能需要一些时间。如果遇到网络问题可以考虑配置代理或使用国内镜像源但请务必通过合规的开发环境网络设置解决严禁使用任何违规的网络访问工具或服务。3.3 一个独立的学习环境可选但推荐为了纯粹地练习C语法不受JNI和Android构建的干扰我强烈建议你在电脑上配置一个本地的C编译环境。Windows 安装MinGW-w64或直接使用Visual Studio Community Edition。macOS/Linux 系统通常自带GCC或Clang。在终端输入g --version检查。 创建一个test.cpp文件用简单的命令编译运行g -o test test.cpp ./test。这个环境用于快速验证C语法概念效率极高。4. C核心语法精要为NDK铺路现在我们进入正题。以下内容不是C语法大全而是经过筛选的、对NDK开发最关键的部分。我会用对比Java/Kotlin的方式让你更快理解。4.1 从“变量”到“指针”理解内存的钥匙在Java中你声明一个对象MyClass obj new MyClass();obj是一个引用。在C中情况更丰富栈上对象MyClass obj;// 声明时构造函数已被调用生命周期在作用域结束时自动结束。高效但不适合大对象或需要延长生命周期的对象。堆上对象指针MyClass *objPtr new MyClass();//new在堆上分配内存返回地址。你必须负责delete objPtr;。这是NDK中复杂对象或大数据的主要存在方式也是内存泄漏的重灾区。引用MyClass objRef obj;// 是对象的别名必须初始化。在函数参数传递中常用以避免拷贝开销类似Java的引用。指针是C的灵魂也是噩梦的开始。对于NDK你必须掌握指针与JNI的交互 JNI函数经常返回或需要jobject、jintArray等类型的指针。理解指针才能操作它们。指针运算与数组 在C中数组名通常可视为指向其首元素的指针。处理从Java传来的数组如jintArray时你需要用JNI函数获取指向底层数据的指针进行操作。// 假设从JNI获得一个jintArray对象array jint *cArray env-GetIntArrayElements(array, nullptr); // 现在cArray就是一个指向整数数组的指针可以像普通C数组一样使用 cArray[0] 100; // 操作完毕后必须释放 env-ReleaseIntArrayElements(array, cArray, 0);实操心得 每一个GetXXXArrayElements都必须有对应的ReleaseXXXArrayElements配对使用并且注意最后一个参数模式0表示复制回并释放JNI_COMMIT复制回不释放JNI_ABORT释放不复制回。这是初级开发者最容易忘记导致内存问题或数据不同步的地方。4.2 函数接口与实现的契约C函数声明在头文件.h实现在源文件.cpp。这对于组织NDK代码至关重要。一个典型的供JNI调用的函数如下// native-lib.h #ifndef NATIVE_LIB_H #define NATIVE_LIB_H #include jni.h // 必须包含JNI头文件 #ifdef __cplusplus extern C { // 告诉编译器按C语言方式编译函数名防止C的名称修饰mangling #endif // 函数声明 JNIEXPORT jstring JNICALL Java_com_example_myapp_MainActivity_stringFromJNI(JNIEnv *env, jobject /* this */); #ifdef __cplusplus } #endif #endif //NATIVE_LIB_H // native-lib.cpp #include native-lib.h 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()); // 将C string转换为Java的jstring }JNIEXPORT和JNICALL 用于确保函数在动态库中可见且调用约定正确。JNIEnv* env这是最重要的参数它提供了所有JNI函数的指针是你与Java世界通信的桥梁。每个线程的JNIEnv都不同不能跨线程缓存。jobject thiz 如果native方法是实例方法这是调用该方法的Java对象引用如果是静态方法则是jclass。函数命名规则Java_包名_类名_方法名。这是JNI的硬性规定必须严格遵守否则Java层会找不到native方法。4.3 类与对象面向对象的基石C的类与Java类似但有几点关键区别对NDK影响很大构造函数/析构函数 析构函数~ClassName()在对象销毁时自动调用是释放资源如内存、文件句柄的关键位置。在NDK中如果一个C类通过new创建必须在某个地方delete它此时析构函数会被调用。拷贝控制 拷贝构造函数、拷贝赋值运算符。在C中对象默认是按值拷贝。如果类管理了堆内存例如有一个指针成员简单的按值拷贝会导致两个对象指向同一块内存浅拷贝这是灾难性的。你需要定义这些函数来实现深拷贝或禁用拷贝。在NDK中当C对象需要在JNI层之间传递或存储时这个问题必须考虑。class NativeBuffer { private: int* data; size_t size; public: // 构造函数 NativeBuffer(size_t sz) : size(sz) { data new int[sz]; } // 析构函数 - 释放资源的关键 ~NativeBuffer() { delete[] data; } // 禁用拷贝一种简单做法 NativeBuffer(const NativeBuffer) delete; NativeBuffer operator(const NativeBuffer) delete; // 移动构造函数C11可以提升效率 NativeBuffer(NativeBuffer other) noexcept : data(other.data), size(other.size) { other.data nullptr; other.size 0; } };头文件与实现分离 类的声明放在.h文件成员函数的实现放在.cpp文件。这能加快编译速度也是大型NDK项目的标准做法。4.4 标准模板库STL的使用与警惕STL提供了容器vector, map、算法等非常方便。但在NDK中使用需要谨慎优点 提高开发效率减少低级错误。缺点 会增加二进制文件大小特别是如果静态链接某些容器的异常处理在跨JNI边界时可能有问题。建议明确链接STL库 在CMakeLists.txt中使用find_package或target_link_libraries链接c_static或c_shared。优先使用std::vector等连续容器 它们与JNI数组的互操作相对容易可以通过data()方法获取底层指针。避免在JNI接口直接传递STL对象 JNI只认识基本类型和jobject。STL对象需要转换成C数组或序列化后再传递。通常在C内部逻辑中使用STL在JNI边界处进行数据转换。5. JNI编程深度解析打通Java与C的任督二脉掌握了C基础我们来看看如何让它与Java对话。JNI是两者之间的桥梁也是NDK开发中最容易出错的部分。5.1 数据类型映射建立共同语言首先必须牢记基本类型的对应关系这是所有交互的基础Java 类型JNI 类型C/C 类型大小/符号booleanjbooleanunsigned char无符号 8位bytejbytesigned char有符号 8位charjcharunsigned short无符号 16位shortjshortsigned short有符号 16位intjintsigned int有符号 32位longjlongsigned long long有符号 64位floatjfloatfloat32位浮点doublejdoubledouble64位浮点voidvoidvoidN/A对于引用类型所有Java对象在JNI中都以jobject形式出现更具体的如jstring,jclass,jarray及其子类jintArray,jobjectArray等都是jobject的别名。5.2 字符串处理最频繁的陷阱字符串在JavaUTF-16和C通常是UTF-8或窄字符之间的转换是JNI的常客也最容易导致内存和编码问题。// Java - C JNIEXPORT void JNICALL Java_com_example_MyClass_processString(JNIEnv *env, jobject, jstring javaStr) { // 错误做法直接使用 GetStringUTFChars 而不检查 // const char *cStr env-GetStringUTFChars(javaStr, nullptr); // 正确做法检查是否成功获取 const char *cStr env-GetStringUTFChars(javaStr, JNI_FALSE); if (cStr nullptr) { return; // 内存不足处理错误 } // 使用 cStr 进行你的C操作... std::string cppStr(cStr); // ... // 绝对不要忘记释放 env-ReleaseStringUTFChars(javaStr, cStr); } // C - Java JNIEXPORT jstring JNICALL Java_com_example_MyClass_getString(JNIEnv *env, jobject) { std::string cppStr Hello from C; // NewStringUTF 期望一个修改过的UTF-8编码字符串。 // 注意cppStr.c_str() 必须是有效的UTF-8且不包含嵌入的null字符。 jstring javaStr env-NewStringUTF(cppStr.c_str()); // 不需要手动释放javaStrJava的GC会管理它。 return javaStr; }关键注意事项GetStringUTFChars/GetStringChars和ReleaseStringUTFChars/ReleaseStringChars必须成对出现。NewStringUTF创建的字符串其生命周期由Java虚拟机管理C侧无需释放。对于可能很长的字符串操作考虑使用GetStringRegion或GetStringUTFRegion它们直接将内容复制到你提供的缓冲区避免额外的内存分配和指针管理更安全。5.3 数组操作性能与安全的平衡处理数组特别是基本类型数组是NDK进行高性能计算如图像、音频处理的核心。// 处理一个整型数组 JNIEXPORT jint JNICALL Java_com_example_MyClass_sumArray(JNIEnv *env, jobject, jintArray javaArray) { jint sum 0; // 方式1GetIntArrayElements (用于需要直接修改原数组或长时间操作) jint *cArray env-GetIntArrayElements(javaArray, nullptr); if (cArray nullptr) { return 0; // 错误处理 } jsize length env-GetArrayLength(javaArray); for (jsize i 0; i length; i) { sum cArray[i]; // cArray[i] * 2; // 可以直接修改 } // 将修改复制回Java数组并释放C数组 env-ReleaseIntArrayElements(javaArray, cArray, 0); // 模式0复制回并释放 // 模式 JNI_COMMIT: 复制回不释放后续可能还要用 // 模式 JNI_ABORT: 不复制回直接释放用于只读操作 // 方式2GetIntArrayRegion / SetIntArrayRegion (用于小型数组或一次性拷贝) // jint buffer[100]; // env-GetIntArrayRegion(javaArray, 0, length, buffer); // ... 操作 buffer ... // env-SetIntArrayRegion(javaArray, 0, length, buffer); return sum; }选择策略大数组、需要频繁或复杂操作 使用Get/ReleaseXXXArrayElements。注意配对释放。小数组、或只需一次读取/写入 使用Get/SetXXXArrayRegion。更安全无需担心释放问题。直接缓冲区 (Direct Buffer) 对于极高性能要求如OpenGL、音频流可以使用NewDirectByteBuffer在Java层创建直接缓冲区在C层通过GetDirectBufferAddress获取指针。这避免了拷贝但需要更小心地管理内存访问同步。5.4 访问Java字段与调用方法有时需要在C中读取或设置Java对象的字段甚至调用Java方法。这很强大但也影响性能。// 假设一个Java类class MyJavaClass { public int value; public native void nativeMethod(); } JNIEXPORT void JNICALL Java_com_example_MyJavaClass_nativeMethod(JNIEnv *env, jobject thiz) { // 1. 获取类引用 jclass clazz env-GetObjectClass(thiz); // 获取thiz对象的类 // 2. 获取字段ID (每次调用都需要获取可缓存以提高性能) jfieldID fid env-GetFieldID(clazz, value, I); // I是int的签名 // 3. 获取字段值 jint javaValue env-GetIntField(thiz, fid); // 4. 修改字段值 env-SetIntField(thiz, fid, javaValue 100); // 调用Java方法示例 jmethodID mid env-GetMethodID(clazz, callback, (I)V); // (I)V是 void callback(int) 的签名 if (mid ! nullptr) { env-CallVoidMethod(thiz, mid, 200); } // 局部引用clazz不需要手动删除函数返回后会自动处理。但在循环中创建大量局部引用时需注意使用env-DeleteLocalRef()防止溢出。 }性能优化技巧GetFieldID,GetMethodID的查找开销较大。最佳实践是在类加载时如JNI_OnLoad函数中或静态变量中缓存这些ID避免每次调用都查找。6. CMake构建系统详解从源码到.so库Android Studio现在默认使用CMake来构建原生库。理解CMakeLists.txt是管理NDK项目依赖和构建选项的关键。6.1 基础CMakeLists.txt结构解析让我们看一个典型的CMakeLists.txt# 指定CMake最低版本 cmake_minimum_required(VERSION 3.22.1) # 定义项目名称和原生库支持的语言 project(myndkproject LANGUAGES CXX) # 使用C # 创建一个库目标SHARED表示动态库(.so)STATIC表示静态库(.a) add_library( native-lib # 库的名称将生成 libnative-lib.so SHARED native-lib.cpp # 列出所有源文件 another.cpp ) # 查找并链接系统库。log库用于在Android Logcat中输出日志。 find_library( log-lib log ) # 链接库到你的目标 target_link_libraries( native-lib # 你的目标库 # 在这里链接其他库包括你find_library找到的或自己添加的 android # 如果需要访问Android特定API如AAssetManager ${log-lib} ) # 包含头文件目录 # target_include_directories(native-lib PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/include)6.2 引入预构建库和第三方库这是NDK项目中的常见需求例如使用一个预编译好的.so库或开源C库如OpenCV。# 1. 引入预构建库假设我们有一个预编译的 libprebuilt.so add_library(prebuilt_lib SHARED IMPORTED) # 声明一个IMPORTED库 set_target_properties(prebuilt_lib PROPERTIES IMPORTED_LOCATION ${CMAKE_CURRENT_SOURCE_DIR}/libs/${ANDROID_ABI}/libprebuilt.so) # 根据ABI指定路径 # 然后通过 target_link_libraries(native-lib prebuilt_lib) 链接 # 2. 引入源代码形式的第三方库假设库源码在 third_party/foo 目录 # 先添加子目录该目录下应有自己的CMakeLists.txt add_subdirectory(third_party/foo) # 或者直接将其源文件添加为一个库 # file(GLOB_RECURSE FOO_SOURCES third_party/foo/*.cpp) # add_library(foo STATIC ${FOO_SOURCES}) # target_include_directories(native-lib PRIVATE third_party/foo/include) # target_link_libraries(native-lib foo) # 链接到主库 target_link_libraries(native-lib prebuilt_lib foo)6.3 关键配置与ABI过滤在app/build.gradle中你可以控制CMake的配置android { defaultConfig { externalNativeBuild { cmake { cppFlags -stdc17 // 指定C标准版本 // 定义宏可以在C代码中用 #ifdef MY_FLAG 判断 arguments -DMY_FLAGON // 指定ABI过滤器减少APK体积 abiFilters arm64-v8a, armeabi-v7a } } } externalNativeBuild { cmake { path src/main/cpp/CMakeLists.txt version 3.22.1 } } }避坑指南abiFilters非常重要。如果你只支持arm64-v8a就只写这一个。把不支持的ABI去掉可以显著减小APK大小。但如果你引入了第三方预编译库必须确保它提供了你所过滤的ABI版本否则链接会失败。7. 调试与问题排查从崩溃日志到稳定运行NDK代码崩溃时日志往往不如Java崩溃那么友好。掌握调试技巧是生存必备技能。7.1 日志输出你的第一双眼睛Android提供了android/log.h头文件用于在Logcat中输出日志其重要性堪比Java的Log.d。#include android/log.h // 定义日志标签 #define LOG_TAG MyNativeLib // 定义便捷宏 #define LOGD(...) __android_log_print(ANDROID_LOG_DEBUG, LOG_TAG, __VA_ARGS__) #define LOGE(...) __android_log_print(ANDROID_LOG_ERROR, LOG_TAG, __VA_ARGS__) JNIEXPORT void JNICALL Java_com_example_MyClass_nativeFunc(JNIEnv *env, jobject thiz) { int importantValue 42; LOGD(Native function started. Value %d, importantValue); // ... 你的代码 if (someError) { LOGE(A critical error occurred!); } }在Android Studio的Logcat中选择你的设备和应用进程然后过滤LOG_TAG如MyNativeLib即可看到输出。这是追踪程序流程和变量状态最直接的方法。7.2 使用LLDB进行原生调试Android Studio内置了LLDB调试器可以像调试Java代码一样调试C。在native-lib.cpp中设置断点。以“Debug”模式运行应用点击虫子图标。当执行到断点时程序会暂停。在Debug窗口的“LLDB”标签页你可以输入LLDB命令或直接在下方的“Variables”和“Watches”窗口查看变量。常用LLDB命令p variable 打印变量值。bt 打印调用堆栈backtrace这是分析崩溃位置的神器。n 单步跳过。s 单步进入。7.3 分析原生崩溃Native Crash当发生SIGSEGV段错误、SIGABRT等崩溃时Logcat会输出一堆看似天书的堆栈跟踪通常包含内存地址和库偏移量。你需要使用ndk-stack工具将其符号化。在崩溃日志中找到从*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***开始到应用重启之间的所有日志复制到一个文件中比如crash.log。打开终端导航到你的项目目录或NDK目录。运行命令路径根据你的NDK位置调整$ANDROID_SDK_ROOT/ndk/version/ndk-stack -sym ./app/build/intermediates/cmake/debug/obj/armeabi-v7a/ -dump crash.log其中-sym参数指定包含带调试符号的.so文件的目录通常在build/intermediates/cmake/下的obj目录中根据你的构建变体选择debug或release以及对应的ABI。命令输出会将内存地址转换为具体的C函数名和行号如果你在build.gradle的debug变体中启用了debuggable true和带符号的构建从而精准定位崩溃代码行。7.4 常见问题速查表问题现象可能原因排查思路java.lang.UnsatisfiedLinkError: No implementation found for...1. JNI函数名签名不匹配包名、类名、方法名、参数类型。2..so库未正确加载名字不对、ABI不兼容、路径错误。1. 用javah或javac -h生成头文件核对函数名。2. 检查System.loadLibrary参数。3. 检查APK中lib/目录下是否有对应ABI的.so文件。应用随机崩溃Logcat有signal 11 (SIGSEGV)空指针解引用、访问已释放内存、数组越界、栈溢出。1. 使用ndk-stack分析崩溃堆栈。2. 检查所有指针在使用前是否有效。3. 检查数组索引是否越界。4. 使用AddressSanitizer (-fsanitizeaddress)编译调试版本。内存使用持续增长泄漏C层new/malloc的内存没有delete/freeJNI全局引用未释放。1. 使用Valgrind或Android Studio的Memory Profiler需结合Native内存跟踪。2. 检查所有NewGlobalRef是否有对应的DeleteGlobalRef。3. 确保GetXXXArrayElements与ReleaseXXXArrayElements配对。调用JNI函数后应用卡死或行为异常JNIEnv使用错误如在错误的线程中使用、死锁。1.记住JNIEnv是线程相关的。在子线程中需要通过JavaVM的AttachCurrentThread获取当前线程的JNIEnv。2. 避免在持有锁的情况下调用可能阻塞的JNI函数。第三方库无法链接库文件缺失、ABI不匹配、CMake链接语句错误。1. 检查.so文件是否放在正确的jniLibs/ABI目录。2. 检查CMakeLists.txt中target_link_libraries语句。3. 检查库依赖的其它库是否也已链接。8. 实战演练构建一个简单的图像处理NDK模块让我们把上面的知识串联起来做一个简单的实战在NDK中实现一个将图片灰度化的函数并在Android App中调用。8.1 Java层定义首先在Android的Java/Kotlin类中声明native方法。public class ImageProcessor { // 加载原生库 static { System.loadLibrary(image-processor); } // 声明一个native方法传入图片的像素数组ARGB_8888格式和宽高 public static native void convertToGray(int[] pixels, int width, int height); }8.2 C层实现创建image-processor.cpp文件。#include jni.h #include android/log.h #define LOG_TAG ImageProcessor #define LOGD(...) __android_log_print(ANDROID_LOG_DEBUG, LOG_TAG, __VA_ARGS__) extern C { JNIEXPORT void JNICALL Java_com_example_myapp_ImageProcessor_convertToGray(JNIEnv *env, jclass clazz, jintArray pixels_, jint width, jint height) { // 1. 获取指向Java数组的指针 jint *pixels env-GetIntArrayElements(pixels_, nullptr); if (pixels nullptr) { LOGE(Failed to get array elements); return; } // 2. 图像处理核心逻辑灰度化 (公式: Gray 0.299*R 0.587*G 0.114*B) int totalPixels width * height; for (int i 0; i totalPixels; i) { jint color pixels[i]; // 提取ARGB分量 jint a (color 24) 0xFF; jint r (color 16) 0xFF; jint g (color 8) 0xFF; jint b color 0xFF; // 计算灰度值 jint gray (jint)(0.299 * r 0.587 * g 0.114 * b); // 组合回ARGB格式 pixels[i] (a 24) | (gray 16) | (gray 8) | gray; } // 3. 将修改后的数据复制回Java数组并释放C数组资源 // 使用0模式复制回数据并释放原生数组 env-ReleaseIntArrayElements(pixels_, pixels, 0); LOGD(Image grayscale conversion completed.); } } // extern C8.3 CMakeLists.txt配置cmake_minimum_required(VERSION 3.22.1) project(myndkimage LANGUAGES CXX) add_library( image-processor SHARED image-processor.cpp ) find_library( log-lib log ) target_link_libraries( image-processor ${log-lib} )8.4 在Android中调用在Activity或ViewModel中获取Bitmap的像素调用native方法再重新设置像素。// 假设有一个Bitmap bitmap int width bitmap.getWidth(); int height bitmap.getHeight(); int[] pixels new int[width * height]; bitmap.getPixels(pixels, 0, width, 0, 0, width, height); // 调用Native方法 ImageProcessor.convertToGray(pixels, width, height); // 将处理后的像素设置回Bitmap Bitmap grayBitmap Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888); grayBitmap.setPixels(pixels, 0, width, 0, 0, width, height); imageView.setImageBitmap(grayBitmap);8.5 性能对比与思考你可以尝试用纯Java实现同样的灰度化算法然后在不同尺寸的图片上对比执行时间。你会发现对于大图如2000x2000以上NDK版本通常会有显著的速度优势尤其是当算法更复杂时如高斯模糊、边缘检测。这个简单的例子涵盖了JNI数组操作、指针使用、基本算法和资源释放的完整流程是理解NDK工作流的绝佳起点。