Android NDK:C层复用Java Bitmap缓冲区填充数据的性能优化方法
最优实现方案
核心是彻底跳过原有流程里的jbyteArray中转、ByteBuffer包装、copyPixelsFromBuffer拷贝这几层多余开销,直接通过Android NDK官方提供的Bitmap操作接口,把C层处理好的像素直接写入Java侧预分配的Bitmap内存,全程无额外临时内存分配、无大块像素拷贝,从根源解决GC和性能瓶颈。
具体实现步骤
- 首先替换Java侧的方法定义:删除原有方法里返回
byte[]的逻辑,直接将预分配的Bitmap对象作为参数传入native层,方法无返回值:public static native void fillNativeBitmap(String src, Bitmap preAllocatedBitmap); - Native层引入官方头文件
android/bitmap.h,这是Android系统提供的跨层操作Bitmap的稳定接口,所有正式发布的Android版本都兼容。 - 整个native流程的操作链路:
- 调用
AndroidBitmap_getInfo获取传入Bitmap的宽高、像素格式、内存大小,提前校验格式是否为ARGB_8888,避免后续写入错位。 - 调用
AndroidBitmap_lockPixels直接获取这块预分配Bitmap的原生像素缓冲区指针——这个指针直接指向Java层Bitmap本身的像素内存,不是拷贝生成的副本,锁定期内GC不会移动、回收这块内存,完全不存在JNI数组接口里的isCopy拷贝歧义。 - 原有的图像解码、像素处理逻辑保持不变,只是把原来输出到静态
mptr缓冲区的结果,直接写入上一步拿到的目标像素指针上。 - 处理完成后先释放解码过程中申请的临时内存、JNI字符串引用,再调用
AndroidBitmap_unlockPixels解除锁,通知系统这块内存的内容已经更新,可以直接用于UI渲染。
- 调用
性能收益对比
对比原有实现,新方案可以完全省掉以下不必要的开销:
- 省掉JNI层
NewByteArray的堆内存分配,消除这类临时对象带来的GC压力 - 省掉将C层静态缓冲区数据拷贝到新生成
jbyteArray的内存拷贝步骤 - 省掉Java层
ByteBuffer.wrap的对象分配,以及bmp.copyPixelsFromBuffer中再次将字节数组数据拷贝到Bitmap内存的大块拷贝操作 - 可以直接删除原有代码里的静态
mptr缓冲区,省掉这块固定内存的常驻占用
对于高分辨率图像场景,原有流程需要完成2次全尺寸像素拷贝,新方案的拷贝次数为0,性能提升非常明显。
关键注意事项
- 不推荐使用
GetByteArrayElements类的JNI数组操作接口实现该需求:这类接口仍然需要在Java层先把Bitmap的像素拷贝到字节数组传入,处理完成后还要把数组数据回拷到Bitmap,本质上绕不开两次全尺寸拷贝,反而引入了更多临时对象,完全达不到优化目标。 - 像素锁的持有时间要尽可能短:拿到像素指针后尽快完成写入操作、调用解锁,不要在锁定期内执行其他耗时逻辑,避免阻塞UI线程对Bitmap的正常访问。
- 锁像素前一定要校验Bitmap的格式:如果预分配的Bitmap使用了
HARDWARE等硬件加速格式,AndroidBitmap_lockPixels会调用失败,只有ARGB_8888这类软件像素格式才能拿到可直接写入的指针。
完整Native实现示例
#include <jni.h> #include <android/bitmap.h> // 引入原有图像解码、处理的相关头文件 JNIEXPORT void JNICALL com_your_package_ImageUtils_fillNativeBitmap(JNIEnv *env, jclass clazz, jstring srcPathStr, jobject preAllocatedBmp) { // 校验Bitmap信息 AndroidBitmapInfo bmpInfo; if (AndroidBitmap_getInfo(env, preAllocatedBmp, &bmpInfo) != ANDROID_BITMAP_RESULT_SUCCESS) { return; } if (bmpInfo.format != ANDROID_BITMAP_FORMAT_RGBA_8888) { return; } // 获取Bitmap原生像素指针 void* targetPixelBuf = NULL; if (AndroidBitmap_lockPixels(env, preAllocatedBmp, &targetPixelBuf) != ANDROID_BITMAP_RESULT_SUCCESS) { return; } // 原有解码逻辑 const char* srcPath = (*env)->GetStringUTFChars(env, srcPathStr, NULL); unsigned char* decodedData = NULL; decodeOneStep(srcPath, &decodedData); // 像素处理直接写入目标缓冲区 doStuffWithImage(decodedData, targetPixelBuf, bmpInfo.width, bmpInfo.height); // 资源清理 (*env)->ReleaseStringUTFChars(env, srcPathStr, srcPath); free(decodedData); // 解锁Bitmap AndroidBitmap_unlockPixels(env, preAllocatedBmp); }
内容的提问来源于stack exchange,提问作者PawelD
相关产品推荐
相关产品推荐

