鸿蒙云相册实践手记:用OBS Header签名把照片备份到云端
今天在鸿蒙开发实践中心做了一个案例:用 OBS 打造个人云相册 App。把过程里最值得记的几件事整理下来:整体怎么做、签名为什么是关键、备份去重怎么做,以及容易踩的坑。
一、要解决的问题
手机里的照片越来越多,换机、丢失、误删都可能让回忆丢了。把照片备份到对象存储是最直接的办法:按量使用、不用自己搭服务器、手机端随时能取回。对象存储服务 OBS 提供 REST API,App 不需要后端中转,直接和 OBS 对话。
二、整体结构
端侧用 ArkTS 与 ArkUI 写界面,photoAccessHelper 负责读取系统相册、让用户挑选照片和视频;云侧就是 OBS;本地用 preferences 保存备份记录。一次备份的链路是:选图、生成对象键、计算文件 MD5、用签名后的 PUT 请求上传、把结果写进本地记录;查看时再用带签名的 GET 请求拉取对象列表和缩略图。
三、最关键的一步:OBS Header 签名
OBS 不认“谁在调用”,只认请求里的签名。做法是把请求方法、日期、规范化后的资源路径和 x-obs 开头的请求头拼成待签字符串,用 SK 做 HMAC-SHA1 再做 Base64 编码,放到 Authorization 头里,格式是 OBS AK:签名。
AK、SK 在控制台“我的凭证、访问密钥”里创建,创建时只显示一次 SK,要立刻保存好。给这对密钥的权限要收紧:只给目标桶的列举、上传和读取权限,测试结束就轮换或删除。密钥只填在 App 的设置页里,不要写进代码、不要发到聊天记录和公开仓库。设置页的密码框只是不回显,数据本身仍以明文存在应用沙箱里。
四、备份去重:MD5 与 ETag 说了算
对象键按 photo_backup/v2/ 加文件特征生成,特征来自本地 URI、大小、修改时间和 MD5。上传前先查本地记录:同一目标下,MD5 和云端 ETag 能对上就跳过,不重复传;取消后,当前文件要整文件重新上传;记录也按 Endpoint 和桶隔离,换桶、换区域不会串。单文件上传和预览的上限是 64 MiB,超过这个大小要走分段上传,本文不展开。
五、云端怎么看
备份完成后,在云端列表里刷新对象,照片和视频以缩略图展示,可以切换列表和网格视图、打开详情和预览。预览用的是带签名的 GET 请求直接读原对象,公网读取会产生流量费用,缩略图建议做磁盘缓存并设上限,例如 128 MiB、最多 64 张,不要无限制拉原图。
六、实践路径与排障
建议先走快速体验:在鸿蒙开发实践中心的作业中心创建项目,填入案例仓地址,用 AI DevSpace 的云端工作区编译打包,再连云手机安装体验;跑通之后再从空项目按步骤自己实现一遍,印象更深。
常见问题:
- 返回 403:先核对四项配置,AK、SK、区域 Endpoint、桶名,再核对设备时间;签名对时间敏感,时间偏差大会直接失败。
- 桶建好了却扣按需费用:核对资源包的区域和单 AZ、多 AZ 策略是否与桶一致,不一致抵扣不上;桶名、区域、冗余策略建好后不能直接改,创建前就要想清楚。
- 相册为空:确认设备里有测试媒体,并且授予了照片和视频读取权限。
七、收尾与清理
测试用最小权限的专用密钥和非敏感照片。做完后停止不再用的云工作区和云手机,删掉测试对象和不再用的桶,撤销或轮换测试密钥。需要长期用的,再按生产要求做临时授权,不要把长效密钥留在客户端里。
小结
这个案例的骨架很清晰:端侧负责选图和展示,OBS 负责存和取,签名负责证明身份,MD5 与 ETag 负责别重复传。把签名和去重这两件事做对,一个能用的个人云相册就跑起来了。下一步我打算试试超过 64 MiB 的大视频分段上传。
参考:鸿蒙实践案例中心案例仓库 HarmonyOS-APP-OBSCloudAlbum,以及 OBS Header 签名与 OBS API 参考文档。
- 点赞
- 收藏
- 关注作者
评论(0)