【三方库】ImageKnife v3.2.9 鸿蒙平台稳定性与质量提升

鸿蒙开源三方库

191人浏览 · 2026-07-16 21:38:40

鸿蒙开源三方库 · 2026-07-16 21:38:40 发布

📢 【三方库】ImageKnife v3.2.9 鸿蒙平台稳定性与质量提升

ImageKnife v3.2.9 已发布。本次升级聚焦该库质量提升，将 JPEG 图片解码像素格式由 RGBA 切换为 YUV（NV12），并新增全局解码优化开关，在无图形变换场景下显著降低解码后的图片内存占用，兼容升级，开发者无需修改现有代码即可享受本次改进。推荐所有该库用户升级至本版本。

版本概览

类型	内容
质量提升	JPEG 解码由 RGBA 优化为 YUV（NV12）格式解码，降低解码后图片内存占用（4d594c1，源自 3.2.9-rc.0）

质量提升

JPEG 解码由 RGBA 优化为 YUV（NV12）格式，降低解码后图片内存占用

背景：此前 JPEG 图片解码统一使用 RGBA 像素格式，每个像素占用 4 字节。对于 JPEG 这类以 YUV 色彩空间压缩的图像，解码到 RGBA 会引入额外的内存与转换开销。本次优化在保持解码结果可正常渲染的前提下，将无图形变换的 JPEG 图片解码为目标像素格式切换为 YUV 4:2:0（NV12），从而降低解码后 PixelMap 的内存占用。

实现细节（基于提交 4d594c1，13 个文件、+335/-12 行）：

新增全局开关字段与方法 —— library/src/main/ets/ImageKnife.ets（+22 行）

在 ImageKnife 单例中新增私有字段与配套的读写接口，默认关闭：

// JPEG优化解码开关，启用后使用YUV格式解码以减少内存占用
private enableJpegOptimizeDecoding: boolean = false;

setJpegOptimizeDecoding(enable: boolean): void {
  this.enableJpegOptimizeDecoding = enable;
}

getJpegOptimizeDecoding(): boolean {
  return this.enableJpegOptimizeDecoding;
}

setJpegOptimizeDecoding 用于全局开启/关闭优化解码，未调用时默认不启用。

请求结构体传递开关 —— library/src/main/ets/model/ImageKnifeData.ets（+1 行）

在 RequestJobRequest 接口中新增可选字段 jpegOptimizeDecoding?: boolean，使解码策略可在子线程请求任务中获取该配置（同时修正了 dynamicRangeMode 字段末尾缺失的逗号）。
分发阶段读取全局配置 —— library/src/main/ets/ImageKnifeDispatcher.ets（+1 行）

在构造 RequestJobRequest 时，通过 ImageKnife.getInstance().getJpegOptimizeDecoding() 读取全局开关并写入请求：
```
dynamicRangeMode: currentRequest.imageKnifeOption.dynamicRangeMode,
jpegOptimizeDecoding: ImageKnife.getInstance().getJpegOptimizeDecoding()
```
核心解码逻辑切换像素格式 —— library/src/main/ets/parseStrategy/ParseStaticImage.ets（+8 行）

在获取 decodingOptions 之后、实际解码之前，新增条件判断：仅当开启优化、未配置 transformation（图形变换）且图片类型为 jpg 时，将 desiredPixelFormat 设为 image.PixelMapFormat.NV12：
```
// 如果开启jpeg解码优化、类型是jpeg/jpg且没有图形变换后处理(配置transformation)，设置YUV格式解码
if (request.jpegOptimizeDecoding && !request.transformation && typeValue === 'jpg') {
  decodingOptions.desiredPixelFormat = image.PixelMapFormat.NV12;
  LogUtil.log(`decodingOptions.desiredPixelFormat is image.PixelMapFormat.NV12 : ${ request.componentId },srcType:${request.requestSource}, ${request.componentVersion}`)
}
```
由于图形变换需要逐像素读写 RGBA 数据，当请求配置了 transformation 时会跳过该优化，回退到默认解码方式，保证变换功能正常。
文档与示例 —— README.md / README_zh.md（+3 行）

在接口表中新增 setJpegOptimizeDecoding (3.2.9+) 与 getJpegOptimizeDecoding (3.2.9+) 两项说明，注明启用后 getCacheImage 接口可能返回非 RGBA 像素格式的 PixelMap。
新增对比测试页 —— entry/src/main/ets/pages/TestJpegDecode.ets（+145 行）、CompareJpegDecode.ets（+114 行）

新增 JPEG 解码优化测试页，提供「开启/关闭 Jpeg 解码优化」「添加/移除图形变换」「更换图片」等按钮，并实时展示内存缓存使用量与图片宽高，便于直观对比优化前后的内存差异。

提交信息：4d594c1 · Author: zhuchengcheng · AuthorDate: 2026-01-30，首次发布于 3.2.9-rc.0，累积进入 3.2.9 正式版。

兼容性说明

无 Breaking Changes，原有 API 接口保持不变。
优化解码默认关闭，未调用 setJpegOptimizeDecoding(true) 时行为与 v3.2.8 完全一致，现有代码无需修改。
仅当开发者显式启用、且 JPEG 图片未配置图形变换时才会应用 YUV（NV12）解码；配置了 transformation 的图片仍使用默认 RGBA 解码。
启用后，getCacheImage 接口可能返回非 RGBA 像素格式的 PixelMap，依赖特定像素格式的业务需注意。
从 v3.2.8 起升级至 v3.2.9 均为兼容性升级。