鸿蒙云相册实践:用 ArkTS 实现 OBS 逐文件备份与签名
鸿蒙云相册实践:用 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 地址,不要为了省事把桶设成公有读。
六、几个坑
- 时间戳必须用 UTC,且与签名里的 Date 完全一致;
- 大文件走分段上传,别把上百 MB 的视频一次读进内存;
- 需要断点续传时保存 uploadId 和已完成的分段号;
- 网络切换时给上传加超时和重试上限,避免无限重试。
整体看,这套“选择—签名—逐个上传—记录状态”的骨架不只适用于相册,文档归档、行车记录备份等场景也能直接复用。
- 点赞
- 收藏
- 关注作者
评论(0)