鸿蒙相册云备份实践:用华为云 OBS 实现 Header 签名上传与云端预览
【摘要】 在鸿蒙端用华为云 OBS 给相册 App 做云备份:拆解 Header 签名(HMAC-SHA1 构造 Authorization)、逐文件上传与取消、备份记录与云端网格预览四步流程,附 ArkTS 签名代码示例,并总结密钥安全、分段上传与对象去重三个踩坑点。
为什么要给相册 App 做云备份
手机相册是最容易产生"数据焦虑"的场景:照片视频体积大、误删不可逆。在鸿蒙端做相册类应用时,把媒体备份到华为云 OBS(对象存储服务)是成本与可靠性的平衡点——按量付费、容量近乎无限,还能配合图片处理与 CDN 做云端预览加速。最近在鸿蒙开发实践中心体验了"用 OBS 打造个人云相册 App"案例,把端侧图库与 OBS 桶打通的完整链路整理成这篇笔记。
核心流程:从本地图库到 OBS 桶
整个备份链路可以拆成四步:
- 选择媒体:通过 photoAccessHelper 拉起系统图库选择器,筛选照片与视频,支持多选、全选待备份项,并把选择结果缓存成待备份列表。
- Header 签名:OBS 的每个请求都要携带 Authorization 头。做法是用 SK 对 StringToSign 做 HMAC-SHA1 摘要再 Base64,最后拼上 AK:OBS {sign}。StringToSign 由请求方法、Content-Type、Date 与 CanonicalizedResource 按固定顺序换行拼接,顺序错一个就 403。
- 逐文件上传:对每个文件构造 PUT 请求,读文件流写入请求体,逐个上传并回调进度,中途可取消;上传完成的对象把"对象 key + 大小 + 时间"写进本地备份记录。
- 备份记录与云端查看:云端用 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)