鸿蒙实践笔记:用 OBS 打造个人云相册 App 的端云备份思路

举报
yd_236998400 发表于 2026/11/14 09:09:39 2026/11/14
【摘要】 记录在鸿蒙开发实践中心体验「用OBS打造个人云相册app」案例的学习笔记:端侧 photoAccessHelper 选图、OBS Header 签名上传、基于 MD5 与 ETag 的去重备份,以及配置与排障要点。

今天在鸿蒙开发实践中心体验了「用 OBS 打造个人云相册 app」案例(GitCode 仓库:harmony-practice-center/HarmonyOS-APP-OBSCloudAlbum),把端侧相册与华为云 OBS 打通,做了一次完整的云备份实践,记录核心思路和需要注意的要点。

一、这个 App 做什么

App 读取用户授权的本地照片和视频,逐文件上传到自己名下的 OBS 私有桶,并提供备份记录、云端对象列表与预览。主要能力:

  • 在本地图库筛选照片或视频,单选或一键备份全部待备份项目,逐文件显示进度与结果
  • 在备份记录中查看结果;已完成的文件按目标隔离的本地记录、MD5 和云端 ETag 核验后跳过,重复备份不重复传
  • 在云端刷新对象列表,列表/网格切换,照片和视频以缩略图展示,可打开图片与视频预览

二、技术方案一览

层级 技术 作用
端侧 ArkTS、ArkUI、photoAccessHelper 媒体选择与交互
云侧 华为云 OBS REST API 上传、列举及读取对象
认证 OBS Header 签名 规范化请求,用 SK 计算 HMAC-SHA1 并 Base64,Authorization 为 OBS AK:Signature
数据 preferences、应用缓存 保存配置与备份记录,缓存云端预览

对象键由本地 URI、大小、修改时间与 MD5 等信息生成,统一使用 photo_backup/v2/ 前缀;记录按 Endpoint 和桶隔离。当前不支持后台定时备份与字节级断点续传。单文件上传与预览上限 64 MiB,云预览磁盘缓存上限 128 MiB。

三、开始之前:准备四项配置

先在控制台创建私有桶,取得 AK、SK、区域 Endpoint 和桶名。需要注意的点:

  • 推荐使用已开启“编程访问”的专用 IAM 用户,只授予该桶的 obs:bucket:ListBucket 和桶内对象的 obs:object:PutObject、obs:object:GetObject,走最小权限
  • Endpoint 是区域域名,例如 obs.cn-north-4.myhuaweicloud.com,不含桶名、对象路径或端口;不要照抄默认配置,也不要填“桶名.Endpoint”形式的桶访问域名
  • AK/SK 只在 App 设置页填写;密码态输入只是隐藏显示,凭据仍以明文保存在应用沙箱 preferences 中,仅用于教学调试,不要提交或分享凭据
  • 桶的区域、单/多 AZ 策略与资源包必须匹配,资源包只按适用条件抵扣存储费;40 GB 存储包是存储容量额度,不是整年费用封顶,公网下载流量与请求仍可能计费

四、备份流程与去重逻辑

  1. 首次进入图库按提示授权相册,在设置中填入 AK、SK、Endpoint、桶名并保存
  2. 选择测试文件或全部待备份项目开始备份;取消后可再次发起,已完成的文件依据记录、MD5 和云端 ETag 核验跳过,取消的当前文件需整文件重新上传
  3. 刷新云端列表核对刚上传的对象,切换列表与网格,查看缩略图与预览
  4. 同名对象保护使用 x-obs-forbid-overwrite;桶启用版本管理时,删除当前对象不一定删除历史版本,按控制台实际版本清理

五、排障要点

  • 签名不匹配或 403:先核对四项配置、设备时间、桶访问权限与规范化资源
  • 相册为空:确认设备中有测试媒体且已授予照片和视频读取权限
  • 备份后再次备份:检查同一目标下的记录和 MD5;清除应用数据会影响本地记录
  • 云端预览失败:检查对象读取权限、网络、文件大小及格式;GET 读取原对象会产生相应请求和流量

六、体验小结

鸿蒙开发实践中心把案例、云端作业中心与 AI 开发者空间串成了一条线:从案例详情页可以直接进入云端工作区,也可以只先用 AI DevSpace 体验版快速验证想法,体验版免费且不消耗任何额度,比较适合先做一次最小验证再决定是否深入。

下一步我打算沿着案例的进阶任务继续做两件事:大于 64 MiB 视频的分段上传,以及按 OBS lastModified 分组的时间轴视图。

案例来源:鸿蒙开发实践中心「用 OBS 打造个人云相册 app」,文档 v1.1.3,工程 1.1.1。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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