企业官网建设流程全解析

DNG 能打开不等于 RAW 能随便常驻：HarmonyOS ImageRawData 怎么控制像素位数和内存预算

先把现象说清楚

照片编辑器能成功创建 ImageSource，于是一次性把十张 DNG 都转为 RAW 常驻内存，页面很快被系统终止。RAW 数据保留传感器信息且没有普通图片压缩带来的体积优势，不能按缩略图思路管理。官方说明从 API 24 起可把符合格式的 DNG 解码为 ImageRawData，其中包含图像缓冲区和像素位数；当前支持格式明确为 DNG。

写代码前先核对官方边界

问题为什么会发生

内存失控来自两个误判：把压缩文件大小当作解码后内存，或者只限制任务数却不限制总像素与位深。预算应根据 RAW 描述计算，并把正在解码、正在处理和待写出三个阶段分别记账。取消任务时等待正在访问缓冲区的步骤退出，再释放对象。

下面的纯 TypeScript 代码是应用侧决策模型，用来验证分支和状态，不是对平台 Native API 的替代：

type RawPlan={width:number;height:number;bits:number;copies:number}; function bytes(v:RawPlan){return Math.ceil(v.width*v.height*v.bits/8)*v.copies;} function admit(v:RawPlan,budget:number){return bytes(v)<=budget;} if(admit({width:8000,height:6000,bits:14,copies:2},64*1024*1024))throw new Error('超预算 RAW 被放行');

案例一：单张专业编辑采用串行管线

打开一张 DNG 后读取 RAW 描述，先验证预算，再进入去噪或色彩算法。算法产出预览后释放原始缓冲区，只保留低分辨率预览和可重放参数。用户切换图片时取消旧任务，generation 不一致的结果直接丢弃并释放。

案例二：批量导入只读取基础信息

相册批量导入时不创建全部 ImageRawData，只读取文件和基础图像信息生成任务清单。真正处理按设备预算串行或小并发执行。遇到非 DNG 文件直接走普通图片路径，不用异常重试消耗时间。

平台接入骨架

下面代码只保留与本文问题直接相关的调用顺序。实际工程要按当前官方头文件、错误码和设备能力补齐，不把示意函数当成已经在本机 API 26 编译通过的产物。

import { image } from '@kit.ImageKit'; async function withRaw(source:image.ImageSource){ const raw = await source.createImageRawData(); try { // 读取 RAW 缓冲区和像素位数，交给受预算控制的算法层。 } finally { // 确认异步处理结束后释放 raw/source 对应资源。 } }

为什么选择这套方案

RAW 常驻适合确实需要传感器数据的算法，不适合列表预览。批量任务先建立清单、单张任务再申请大内存，比“限制同时十个任务”更可预测，因为不同 DNG 的尺寸和位深差异很大。

验证矩阵

• 非 DNG：不进入 RAW 解码
• 大尺寸高位深：预算不足提前拒绝
• 取消处理中任务：资源只释放一次
• 连续切图：旧 generation 不覆盖新预览
• 批量导入：峰值内存与单任务预算一致

以后如何避免同类问题

以后所有大图任务先计算解码后预算，再申请资源；任务对象持有明确的释放责任，页面只拿预览结果，不持有 RAW 句柄。

验证范围与证据边界

本文先以华为开发者官网当前文档确认能力范围、起始版本、设备差异和资源释放要求，再用纯 TypeScript 状态模型验证参数、状态转移和失败回退。状态模型能证明应用侧分支是否自洽，不能替代 HarmonyOS 7 / API 26 编译、设备能力查询、Native 链路运行或双真机协同。

当前本机 SDK 为 API 24，且没有已连接的 HDC 设备。因此文中的 API 26 平台代码属于按官方接口整理的接入骨架，不写成“本地已编译”或“真机已经跑通”。真正验收时需要记录 DevEco Studio 与 SDK 版本、设备型号、系统版本、输入文件或网络条件、接口返回值、关键日志、前后台切换、异常注入、资源释放和结果截图。涉及画质、帧率、时延、功耗或跨设备连接的结论，还要在支持该能力的设备上重复测量。

示例不会把预期结果冒充观测结果。宿主断言、API 26 编译、模拟器、云真机和实体设备分别记录；其中任一层没有证据，就明确保留为待验证项。

可复用的工程边界

页面只提交业务意图，不直接维护 Native 句柄、编码器、ImageSource、相机会话、跨设备 sessionId 或 ArkWeb 性能采样器。能力适配层负责系统接口和错误码，编排层维护状态机、超时、取消、资源预算与降级，页面订阅只读状态。这样做的价值不是多包一层，而是让重复点击、页面销毁、设备能力不同和半途失败都能回到同一套收口逻辑。

所有日志只记录阶段、配置摘要、耗时和错误码，不记录原始图片、视频帧、跨设备消息正文或用户页面内容。生产环境还需要采样、脱敏和容量限制。

上线前检查表

• 先确认官方文档更新时间、起始 API、设备类型和系统能力，不用接口存在代替运行支持。
• 两个案例必须覆盖不同失败机制，一个验证主链路，一个验证资源、并发、生命周期或设备差异。
• 每个异步阶段都能取消，页面退出后不会继续回调旧页面，资源释放顺序可重复执行。
• 失败时保留阶段和错误码，增强能力失败能回到可用基础路径，不让页面卡死或黑屏。
• 文章中的代码、图和结论使用同一组状态名，避免示意图与实现逻辑相互矛盾。
• 真机验收记录输入、操作、观测和环境，不用“看起来正常”作为唯一结果。

参考资料

1. ImageSource 获取 RAW 数据

2. 2026 年 9 月开发者月刊