从图库分享照片到灯牌应用接收了 URI还没得到一张可长期编辑的图片朋友在图库里选了一张应援照片点系统分享并选择灯牌应用。应用成功打开修图页预览也显示了照片隔天再次进入草稿图片却变成灰框。常见原因是应用只记住了外部分享 URI没在有效授权期间把文件复制进自己的受控存储。接收分享是一条“解析请求—临时读取—验证内容—导入草稿”的链不是把传来的字符串当本地路径。华为系统分享 FAQ说明接收方在module.json5声明可处理的数据类型并在onCreate或onNewWant中读取 Want长期编辑时需复制进应用沙箱Image Kit 图片处理入口用于理解解码与资源边界。本文以跨平台应援灯牌控制应用为场景参考 Flutter OpenHarmony API 20 工程尚未验证 Share Kit 接收链配置与代码须在实际目标 SDK 和设备上复核。1. 分享入口应说明能接收什么若应用只支持静态照片就别在接收声明里把任意文件、视频和远端链接都列进去。过宽的声明会让用户在系统面板看到灯牌应用点击后却被告知“不支持此类型”。先定义接收矩阵单张 JPEG/PNG 可导入超大图要缩放或拒绝动态照片/HEIF 按目标设备能力决定远端网址不等于本地图片文件。来源入口策略后续处理图库本地 JPEG/PNG接收拷贝、解码、创建草稿多张图片初版可限制数量显示选择而非静默丢掉网络图片 URL单独产品功能合法下载后再导入视频文件不作为修图入口另走视频编辑流程分享目标出现与否还依赖系统对 UTD 和接收能力的匹配。别拿发起方“看不到我们应用”一律归咎于发起方先核对自己的声明。2. Ability 入口不能只处理冷启动应用未运行时分享请求可能进入onCreate应用已在前台时可能进入onNewWant。只在启动页onCreate处理会造成“第一次能导入第二次分享没反应”。两个入口应汇入同一个业务处理函数但要用请求 ID 去重防止生命周期重入导致同一图片导入两次。interfaceIncomingShareRequest{requestId:string;receivedAt:number;records:Array{utd:string;uri?:string};}classShareInbox{privateseen:SetstringnewSet();take(request:IncomingShareRequest):boolean{if(this.seen.has(request.requestId))returnfalse;this.seen.add(request.requestId);returntrue;}}requestId可以由入口层为一次 Want 生成不应把外部 URI 本身当唯一键用户可能确实想把同一张照片导入两份不同草稿。实际系统入口可参考官方getSharedData(want)而业务去重由自己的导入会话控制。3. 先把分享数据当不可信输入外部应用提供的 UTD、标题、URI 和描述都不能直接写进草稿。先限制记录数量、数据类型和 URI 长度再根据系统授权打开数据。官方 FAQ 还提到getSharedData在记录数超限时可能报错特定情形需要依据 Want 中的 URI 处理不能把这种错误当成“用户未分享图片”。typeImageRecord{utd:string;uri:string};functionpickImageRecords(records:Array{utd:string;uri?:string}):ImageRecord[]{if(records.length10)thrownewError(too_many_records);returnrecords.filter((item)item.utd.startsWith(general.image)typeofitem.uristringitem.uri.length2048).map((item)({utd:item.utd,uri:item.uri!}));}UTD 匹配方式应以实际系统返回的精确类型层级调整上面只展示边界思想。更严谨的实现要用系统类型判断 API而不是只靠字符串前缀拿到 URI 后还要验证文件内容真实格式不能因为声明是图片就跳过解码。4. 在授权窗口内复制到自己的存储跨应用沙箱隔离意味着外部 URI 的读取权限可能只在本次分享流程内有效。导入动作应尽快完成流式复制并写到应用自己的草稿资源目录。先写临时文件完成大小和摘要检查后原子更名失败时删除临时文件不留下一个可见却不可用的草稿。interfaceImportedAsset{assetId:string;localPath:string;byteSize:number;sha256:string;}asyncfunctionimportSharedImage(sourceUri:string,copyToTemp:(uri:string)PromiseImportedAsset,commit:(asset:ImportedAsset)Promisevoid):PromiseImportedAsset{constassetawaitcopyToTemp(sourceUri);if(asset.byteSize0||asset.byteSize30*1024*1024){thrownewError(invalid_asset_size);}awaitcommit(asset);returnasset;}具体流复制要用目标版本的 Core File Kit API并在成功或失败时关闭文件描述符。30MB 是示例产品上限不是平台规则。若导入过程中应用被杀启动时应清理过期临时文件不能把外部 URI 作为“下次继续复制”的唯一凭据。5. 文件扩展名不是图片真实性证明外部应用可以把非图片文件命名为.jpg也可能分享一张解码后占用数百 MB 内存的超大图片。解码前读取文件头与尺寸元数据按编辑画布所需分辨率生成工作副本保留原件与否由产品策略和空间预算决定。修图页面不应直接把原图全尺寸像素同时复制到多个撤销层。interfaceImageProbe{mime:string;width:number;height:number;encodedBytes:number;}functioncheckImageBudget(probe:ImageProbe):string|undefined{if(![image/jpeg,image/png].includes(probe.mime)){returnunsupported_format;}if(probe.width0||probe.height0||probe.width*probe.height24_000_000){returntoo_many_pixels;}if(probe.encodedBytes30*1024*1024)returntoo_large;returnundefined;}格式和像素上限只是入门策略。图片色彩空间、EXIF 方向与透明通道还需在编辑预览和导出中分别保留或转换第47篇会继续处理。真正解码失败应给出“文件无法读取”而非让页面空白。6. 分享来的图片不应自动发布作品用户把照片分享进应用只表示想导入编辑不代表同意上传云端或公开生成分享码。导入成功后创建本地临时草稿并把图片作为待确认资源显示用户保存时再进入持久草稿。若用户返回则按产品策略询问保留或删除不要留下一个陌生图片出现在最近作品列表。typeImportSession|{kind:copying;requestId:string}|{kind:review;assetId:string;tempDraftId:string}|{kind:saved;draftId:string}|{kind:abandoned};functioncanPublish(session:ImportSession):boolean{returnsession.kindsaved;}即使进入saved公开分享仍需第二次单独确认代码中的canPublish仅表示达到后续流程前提不表示自动发布。接收方还应提示原照片的隐私元数据可能随导出保留产品若会去除 EXIF需要在界面说清楚。7. 错误提示要指出在哪一段失败收到 Want 失败、SharedData 解析失败、URI 打不开、复制中断、格式不支持、解码内存不足会在用户眼里呈现相似的“图片没进来”。排查时先定位阶段避免靠反复授予相册权限解决完全无关的 URI 生命周期问题。分享面板无目标应用 → 查接收声明和 UTD 点击目标应用后没跳页 → 查 onCreate/onNewWant 路由 页面有缩略图隔天变灰 → 查是否复制进自身沙箱 导入大图闪退 → 查解码像素预算和工作副本 分享远端网址失败 → 查是否把 URL 当文件 URI错误日志记录请求 ID、阶段、字节数、解码结果即可不应记录外部 URI 全文URI 里可能包含路径或授权信息。8. 用冷启动、热启动和次日恢复验收在图库中分别分享 JPEG、PNG、超大图和不支持的文件。应用冷启动和已在前台时都应进入同一个导入预览取消导入不产生已保存草稿保存后强制结束应用再打开草稿图片仍可用。撤掉来源应用或清理原图库项目后已完成导入的草稿仍应正确显示才说明真正复制了资源。用例期望应用已运行时再次分享新请求进入预览不被忽略URI 授权失效前未复制完明确失败不保存灰框草稿同一 Want 生命周期重入只创建一次导入会话原图库图片被删除已保存草稿仍能显示本地副本超大图拒绝或生成受控工作副本不直接崩溃系统分享带来的只是临时访问入口可长期编辑的图片必须进入自己的资源管理链路。本文描述的是可验证的接收设计尚不能代替参考工程里的原生配置、Flutter 桥接、设备实测与隐私验收。