给鸿蒙相册加一朵"云":用 OBS Header 签名与逐文件备份做一个云相册 App

举报
yd_297372729 发表于 2026/11/14 23:47:58 2026/11/14
【摘要】 本地相册总怕手机丢失,把照片视频备份到自己的 OBS 桶是最直接的路。本文基于鸿蒙开发实践中心的云相册案例,拆解三个关键点:HMAC-SHA1 构造 OBS 认证头、photoAccessHelper 逐文件备份与进度控制、云端列举与认证预览,并给出从桶配置到 AK/SK 四项参数的完整上手路径。

手机相册大概是我们最不忍心丢的数据。网盘要会员、三方同步怕隐私,而开发者手上其实一直有一把现成的钥匙——华为云对象存储服务 OBS:建一个私有桶,写一个鸿蒙 App,把照片视频按自己的规则备份上去,云端还能直接预览。鸿蒙开发实践中心的《用 OBS 打造个人云相册 app》案例(公仓 harmony-practice-center/HarmonyOS-APP-OBSCloudAlbum)正好把这条路完整走了一遍。本文拆解它的三个关键点,并给出上手路径。

一、OBS Header 签名:HMAC-SHA1 是一切的门票

OBS 的 REST API 不接受"裸请求",每个请求都要带一个 Authorization 认证头。案例的做法是标准的 OBS Header 签名流程:

  1. 构造签名串。把请求方法(GET/PUT)、Content-Type、Content-MD5 等内容头、规范化的 OBS 自定义请求头(以 x-obs- 开头、全部小写并按字典序排列)、以及资源路径(桶名 + 对象键)按固定顺序拼接成一段字符串。
  2. 用 SK 计算 HMAC-SHA1。签名串和访问密钥中的 SK 一起送入 HMAC-SHA1,得到摘要后做 Base64 编码。
  3. 拼出认证头。最终请求头形如 Authorization: OBS AK:Signature,其中 AK 是访问密钥的公钥部分,Signature 是上一步的结果。

这一步的坑通常不在算法而在"规范化":自定义头的排序、大小写、多余空格,任何一个不一致都会得到 Signature Mismatch。理解了这个流程,其实就掌握了华为云 OBS REST API 身份认证的通用模式——不止这一个 App,任何需要直连 OBS 的端侧工具都能复用。

二、相册读取与逐文件备份:权限、进度、目标隔离

备份的主体流程围绕 photoAccessHelper 展开:先申请相册读取权限,再筛选出照片与视频。案例把备份交互做得很克制——支持筛选、多选和"备份全部",上传过程有进度显示,并且随时可以取消。两个工程细节值得注意:

  • 逐文件上传。每个媒体文件独立构造 PUT 请求,单个文件上传与预览的上限是 64 MiB。更大的视频需要走分段上传(案例的拓展实践里专门留了这个任务),小文件逐个传则换来了清晰的进度粒度和可中断性。
  • MD5 与目标隔离。备份记录会落到本地,配合 MD5 做内容校验,备份目标则严格隔离在用户自己的桶内。云端"只增不改",避免误覆盖云端已有对象——备份类应用最重要的就是永远不破坏源数据和已有备份。

三、云端查看:列举、网格与认证预览

备份上去只是第一步,能方便地看回去才有"云相册"的感觉。案例的云端侧做了三件事:列举桶内对象生成列表;支持列表与网格两种视图切换,网格模式直接看缩略图(缩略图最多缓存 64 张,云预览磁盘缓存上限 128 MiB);点开单张照片或视频可以查看对象详情并预览——预览走的是带签名的认证 GET,而不是公开读 URL,这与"私有桶"的定位一致,数据不暴露公网链接。

上手路径:四项配置就够了

案例提供云端实践和本地开发两条路线,差异只在开发环境,OBS 侧的配置完全一致:

  1. (可选)在 OBS 控制台"资源包管理"买存储包,40GB/1 年活动价 9 元,单 AZ 与多 AZ 二选一;不买也可按需付费使用。
  2. 创建私有桶:标准存储、私有访问。注意买了资源包的话,桶的地域与冗余策略要和资源包匹配,买包不会自动建桶。
  3. 取出 App 需要的四项配置:桶名、区域 Endpoint(桶概览页)、AK/SK("我的凭证 → 访问密钥")。AK/SK 只在 App 设置里填写,等价于把这把钥匙锁在应用配置里,不要硬编码进仓库。
  4. 在设备相册准备少量测试照片视频,云端实践路线点"开始云端实践"即可在浏览器里完成全部开发与运行,API 26 的工具链由平台工作区提供。

结语与扩展

做完基础案例,还有四个方向可以把这个 App 长成真正的生活工具:家庭视频备份(分段上传 64 MiB 以上的大视频)、旅行素材整理(按备份时间分组浏览)、文档资料归档(通过系统文件选择器备份 PDF/TXT)、跨设备相册恢复(从 OBS 拉回另一台设备的相册)。这四个拓展实践在案例页上都写明了验收标准,比如"重名不覆盖、取消无半成品、权限拒绝有提示"——这些细节恰恰是备份类应用从"能跑"到"敢用"的分界线。

如果你的鸿蒙学习路线还停留在单机 Demo,这个案例是一个很好的台阶:一次实践同时覆盖端侧权限模型、签名认证、云存储操作和 UI 状态管理。相册的"云",其实离你只有四项配置的距离。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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