鸿蒙相册云备份实践:用华为云 OBS 实现 Header 签名上传与云端预览

举报
yd_252962369 发表于 2026/11/18 07:14:23 2026/11/18
【摘要】 在鸿蒙端用华为云 OBS 给相册 App 做云备份:拆解 Header 签名(HMAC-SHA1 构造 Authorization)、逐文件上传与取消、备份记录与云端网格预览四步流程,附 ArkTS 签名代码示例,并总结密钥安全、分段上传与对象去重三个踩坑点。

为什么要给相册 App 做云备份

手机相册是最容易产生"数据焦虑"的场景:照片视频体积大、误删不可逆。在鸿蒙端做相册类应用时,把媒体备份到华为云 OBS(对象存储服务)是成本与可靠性的平衡点——按量付费、容量近乎无限,还能配合图片处理与 CDN 做云端预览加速。最近在鸿蒙开发实践中心体验了"用 OBS 打造个人云相册 App"案例,把端侧图库与 OBS 桶打通的完整链路整理成这篇笔记。

核心流程:从本地图库到 OBS 桶

整个备份链路可以拆成四步:

  1. 选择媒体:通过 photoAccessHelper 拉起系统图库选择器,筛选照片与视频,支持多选、全选待备份项,并把选择结果缓存成待备份列表。
  2. Header 签名:OBS 的每个请求都要携带 Authorization 头。做法是用 SK 对 StringToSign 做 HMAC-SHA1 摘要再 Base64,最后拼上 AK:OBS ak:{ak}:{sign}。StringToSign 由请求方法、Content-Type、Date 与 CanonicalizedResource 按固定顺序换行拼接,顺序错一个就 403。
  3. 逐文件上传:对每个文件构造 PUT 请求,读文件流写入请求体,逐个上传并回调进度,中途可取消;上传完成的对象把"对象 key + 大小 + 时间"写进本地备份记录。
  4. 备份记录与云端查看:云端用 GET bucket 列举对象,按备份时间排序,支持列表/网格两种视图切换;预览时用认证 GET 生成带签名的临时 URL,加载缩略图与视频封面。

签名代码示例(ArkTS)

// StringToSign = VERB\nContent-Type\nDate\nCanonicalizedHeaders + CanonicalizedResource
function buildAuthHeader(verb: string, contentType: string, date: string,
  canonicalResource: string, ak: string, sk: string): string {
  const stringToSign = verb + '\n' + contentType + '\n' + date + '\n' + canonicalResource;
  const sign = hmacSha1Base64(sk, stringToSign); // cryptoFramework Mac("SHA1")
  return 'OBS ' + ak + ':' + sign;
}

hmacSha1Base64 可用 @ohos.security.cryptoFramework 的 Mac 能力实现:createMac(“SHA1”) → init(SymKeyGenerator 传入 SK 字节流)→ update / doFinal 拿摘要,再转 Base64。

三个容易踩的坑

  • 密钥不能硬编码在端侧。SK 泄露等于把整个桶交出去。正式产品建议把签名放到自己的云函数/代理服务端完成,端侧只拿短时效签名 URL;体验阶段也要用子账号的最小权限 AK/SK,用完及时禁用。
  • 大文件走分段上传。超过 64 MiB 的视频建议用 OBS 分段上传(UploadPart),逐段上传后 CompleteMultipartUpload 合并,失败段单独重传,避免整文件重来。
  • 对象 key 设计与去重。相册同名文件很多,用"相册路径 + 文件名 + 修改时间戳"拼 key 避免互相覆盖;上传前对比本地备份记录或对象元数据,跳过已备份文件。

体验小结

这个案例最大的价值是把"端云打通"里最容易被黑盒化的两件事拆开讲清楚:签名不是魔法,就是一次固定格式的 HMAC;预览也不是魔法,就是带签名的 GET。跑通之后再往家庭视频备份、旅行素材整理、跨设备相册恢复等场景扩展,思路完全通用。建议结合案例公仓 HarmonyOS-APP-OBSCloudAlbum 对照调试,遇到 401/403 优先核对时间戳偏移与 StringToSign 的换行顺序。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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