鸿蒙云相册实践笔记:用 OBS 对象键与 MD5 去重做增量备份

举报
yd_226837683 发表于 2026/11/08 09:37:13 2026/11/08
【摘要】 引子今天在鸿蒙开发实践中心看了两个端云一体案例:用 Agent 生成的员工签到 App,和用 OBS 打造的个人云相册 App。签到 App 端侧只留一个网关地址,业务逻辑全在云端;云相册则是端侧直接和 OBS 打交道,靠对象键组织照片。随后我又打开云相册的代码仓(harmony-practice-center/HarmonyOS-APP-OBSCloudAlbum),对照 README ...

引子

今天在鸿蒙开发实践中心看了两个端云一体案例:用 Agent 生成的员工签到 App,和用 OBS 打造的个人云相册 App。签到 App 端侧只留一个网关地址,业务逻辑全在云端;云相册则是端侧直接和 OBS 打交道,靠对象键组织照片。随后我又打开云相册的代码仓(harmony-practice-center/HarmonyOS-APP-OBSCloudAlbum),对照 README 把目录结构读了一遍,还 Star 了它。这篇笔记记下这次阅读里印象最深的几个点。

案例概览:云相册要解决什么问题

案例的定位很清楚:做一个基于鸿蒙生态与华为云 OBS 的个人云相册。手机照片越来越多,存在本地怕丢,存在网盘又怕不好找,它的做法是把照片备份到 OBS 对象存储桶里,同时在端侧保留元数据缓存,断网也能浏览已经同步过的照片。

案例页介绍,它支持一键备份、续传和断点续传,能按日期分相册、按名称或日期搜索照片、删除不需要的照片;端侧缓存元数据,离线也能查看。整个应用可以用 CodeArts IDE for HarmonyOS,借助提示词生成和调试功能完成开发,适合从零开始学习鸿蒙开发的读者。标签是鸿蒙、ArkTS、DevEco Studio、对象存储服务 OBS、端云一体,难度一星。

关键实现要点

1. 对象键就是目录结构

README 里最让我眼前一亮的是对象键设计:照片在 OBS 里的对象键统一用 photo_backup/v2/ 做前缀,再按拍摄日期分目录,例如 2024/10/15/图片名这样的形式。

好处是“结构即索引”:端侧按日期分组展示相册,云端按对象键前缀列举对象,两边天然对得上,不用再维护一张额外的目录映射表。对象存储本来就没有真正的文件夹,所谓“按日期分相册”,本质上就是对对象键前缀做一次分组。

2. 用 MD5 与 ETag 做去重,避免重复上传

备份不是简单地把文件一个个传上去。README 提到,备份服务会用 MD5 值结合 ETag 做“秒传”判断:文件已经在云端存在时就不再重复上传。

对个人相册很实用:同一张照片可能出现多次,或者备份中断后重新触发,靠内容摘要去重,就能保证“只传增量”。再配合分段上传和断点续传,网络抖动时也不用从头再来。

3. 端侧结构分工明确

从代码仓的目录结构看,端侧分工很干净:ObsClient.ets 负责 OBS 请求签名,以及 PutObject、GetObject、ListObjectsV2、DeleteObject 这些对象操作,签名用 AK/SK 加 HMAC-SHA256;BackupService.ets 负责备份、去重、断点续传,以及文件扫描和备份规则;CloudPreviewStore.ets 负责预览、缓存和下载;Index.ets 是主页、配置、备份、预览的入口。需要哪部分能力就去哪个文件找,这种按“云能力”切分模块的方式,读起来很顺。

4. 凭据只能放教学演示,不能照搬到正式项目

案例页和 README 都在配置环节给了明确提醒:AK/SK、Endpoint 和桶名要在 Index.ets 里做三段式配置;AK/SK 存在端侧 preferences 里仅用于教学演示,正式项目应走后端签名或 STS 临时凭证。

这一点值得单独记下来:很多初学者第一次接对象存储,图省事就把长期密钥写进客户端代码。案例把“能跑”和“能用在生产上”区分得很清楚。README 还提到,配置时可以关闭“元数据返回”以减少响应体;上传时还会带上 x-obs-forbid-overwrite 请求头,防止同名对象被覆盖。

5. 一些写在明处的边界

README 也写了这个案例不做什么:不做后台定时备份、不做字节级断点续传、不做缩略图压缩服务,还给出了几个上限——单文件备份上限 64 MiB、预览缓存上限 128 MiB、缩略图最多缓存 64 张。权限方面,module.json5 里声明了读取图片视频、访问网络和获取网络信息三项权限,目标 API 是 26。这种“把边界写出来”的做法本身就值得学习:说清楚覆盖到哪里、哪里留给读者扩展,反而更容易上手。

和签到案例对照着看:两种端云分工

同一天看的签到 App 走的是另一条路线:端侧只留一个网关地址,签到规则、人员名单、签到记录的读写都在云端函数和云数据库里;云端改规则、改名单,不用重新发布端侧应用。

对照下来,两种分工各有适用场景:签到这类“规则经常变、数据要集中管”的业务,适合把逻辑收进云端;云相册这类“数据量大、按固定结构存取”的场景,适合端侧直连对象存储、靠对象键和元数据缓存扛住大部分能力。共同点是端侧都尽量轻:不该端侧管的,就不要塞进端侧。

当天收获

  • 对象键可以当目录用:按日期组织对象键前缀,端侧分组和云端列举就能一一对应。
  • 增量备份的关键不在“传得快”,而在“不重复传”:MD5 与 ETag 的去重判断,加上断点续传,才是备份体验的底子。
  • 凭据安全是端云一体开发的第一课:教学演示可以把 AK/SK 放在端侧配置里,正式项目一定要走后端签名或 STS 临时凭证。
  • 读案例要读它的边界:知道一个案例不做什么,和知道它能做什么一样重要。

小结

两个案例看下来,我对“端云一体”多了一层具体的理解:它不是“端上什么都干”或“云上什么都干”,而是按数据的特点分工——经常变、要集中管的放云端;量大、结构固定的,用对象存储和端侧缓存解决。云相册案例把这种分工落到了对象键、去重、缓存这些具体设计上,值得照着它的步骤在 DevEco 里实际跑一遍备份流程,再验证一次断点续传的效果。

参考:鸿蒙开发实践中心案例《用 OBS 打造个人云相册 app》,代码仓 harmony-practice-center/HarmonyOS-APP-OBSCloudAlbum;以及同一天浏览的案例《使用 Agent 生成鸿蒙端云一体员工签到 App》。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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