鸿蒙云相册实践:用 ArkTS 实现 OBS 逐文件备份与签名

举报
yd_272594434 发表于 2026/11/14 12:51:15 2026/11/14
【摘要】 复现鸿蒙云相册案例后的实践笔记:从本地图库选择到 OBS Header 签名、逐文件上传、状态记录与云端预览,整理整体链路、并发与重试的取舍,以及 UTC 时间戳、分段上传、断点续传等容易踩的坑。

鸿蒙云相册实践:用 ArkTS 实现 OBS 逐文件备份与签名

在鸿蒙应用里做云相册,最容易被低估的不是界面,而是对象存储的鉴权。最近在鸿蒙开发实践中心复现了《用 OBS 打造个人云相册 app》这个案例,把关键点整理成一篇笔记,给同样在写备份功能的同学参考。

一、整体链路

本地图库选择 → 读取文件 → 计算 OBS Header 签名 → PUT 上传 → 记录备份状态 → 云端列表与预览。案例基于 ArkTS + ArkUI,适配 API 26。

二、为什么选 Header 签名

OBS 的 Header 签名本质是 HMAC-SHA1:先把请求方法、Content-MD5、Content-Type、Date 和规范化后的头、资源路径拼成 StringToSign,再用 SK 计算 HMAC-SHA1 并 Base64。核心逻辑大致是:

const stringToSign = method + "\n" + contentMd5 + "\n" + contentType + "\n" + date + "\n" + canonicalizedHeaders + canonicalizedResource;
const signature = base64(hmacSha1(secretKey, stringToSign));
Authorization: OBS AccessKey:signature

这样做的好处是不用把密钥放进每次请求体,也不依赖额外的服务端中转。

三、逐文件上传的取舍

相册场景文件多、体积大。逐文件上传可以为每个文件单独显示进度、支持取消,失败时只重传那一个;代价是请求数变多,需要用队列限制并发,否则弱网下很容易互相拖慢。另外 Content-Type 要按扩展名设置,不然云端预览会变成下载。

四、状态与记录

每张照片在本地存一条记录:对象 key、大小、状态、时间。状态建议用 pending / uploading / done / failed 四个值,应用重启时把残留的 uploading 重置为 failed,避免任务永远卡住。记录可以用 Preferences,也可以用关系型数据库,按数据量选择。

五、预览与懒加载

云端列表先只拉元数据,缩略图接近可视区域再请求;预览使用带签名的 GET 地址,不要为了省事把桶设成公有读。

六、几个坑

  1. 时间戳必须用 UTC,且与签名里的 Date 完全一致;
  2. 大文件走分段上传,别把上百 MB 的视频一次读进内存;
  3. 需要断点续传时保存 uploadId 和已完成的分段号;
  4. 网络切换时给上传加超时和重试上限,避免无限重试。

整体看,这套“选择—签名—逐个上传—记录状态”的骨架不只适用于相册,文档归档、行车记录备份等场景也能直接复用。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。