用 OBS 打造个人云相册 App —— HarmonyOS + 华为云实践入门

举报
ioiy 发表于 2026/11/11 14:23:54 2026/11/11
【摘要】 这个案例在做什么一句话:读取本地相册 → 逐文件上传到 OBS 桶 → 本地记录备份结果 → 云端列表与预览。它不是那种"跑个 Demo 截个图"的玩具——你会真正接触 OBS 的 Header 签名机制、逐文件上传与进度取消、基于 MD5 + ETag 的去重跳过,以及通过认证 GET 拉取云端对象做缩略图和预览。技术方案速览层级技术干什么端侧ArkTS、ArkUI、photoAccess...

这个案例在做什么

一句话:读取本地相册 → 逐文件上传到 OBS 桶 → 本地记录备份结果 → 云端列表与预览。

它不是那种"跑个 Demo 截个图"的玩具——你会真正接触 OBS 的 Header 签名机制、逐文件上传与进度取消、基于 MD5 + ETag 的去重跳过,以及通过认证 GET 拉取云端对象做缩略图和预览。

技术方案速览


层级 技术 干什么
端侧 ArkTS、ArkUI、photoAccessHelper 媒体选择与界面交互
云侧 华为云 OBS REST API 上传、列举、读取对象
数据 preferences + 应用缓存 保存配置与备份记录,缓存预览
工具 DevEco Studio + HarmonyOS SDK(API 26) 构建与设备运行

数据流很简单:

本地相册 → 媒体扫描与备份 → OBS Header 签名与 HTTP → 华为云 OBS
                                    ↓
                              本地备份记录(按 Endpoint + 桶隔离)
                                    ↓
                              对象列表与认证预览

三个核心功能

1. 本地图库与备份

进入图库后授权相册访问,筛选照片或视频,可以选择单个文件,也可以"一键备份全部待备份项目"。上传过程逐文件显示进度,支持取消。

2. 备份记录与去重

对象键由本地 URI、文件大小、修改时间和 MD5 共同生成,前缀 photo_backup/v2/。记录按 Endpoint 和桶隔离。重复备份时,已完成的文件会根据本地记录、MD5 和云端 ETag 自动跳过——取消的当前文件需要整文件重新上传。

3. 云端浏览与预览

刷新云端对象列表,支持列表 / 网格双视图切换,照片和视频以缩略图展示,点击可打开图片或视频预览。预览通过认证 GET 读取原对象,磁盘缓存上限 128 MiB,缩略图最多 64 张。

最值得学的部分:OBS Header 签名

这个案例的技术核心不在 UI,而在如何用纯 HTTP 调 OBS——不依赖任何 SDK,手写签名。

OBS 的认证方式是:用 SK 对规范化后的请求做 HMAC-SHA1,Base64 编码后拼成 Authorization: OBS {AK}:{Signature}。你需要正确构造规范化资源、x-obs-* 请求头、计算 Content-MD5,然后走 HTTPS 完成对象列举和 PUT 上传。

这一步踩坑最多的是签名不匹配(403),常见原因:Endpoint 填错(照抄了别的区域的)、桶名拼到了 Endpoint 里、设备时间偏差过大、规范化资源构造不规范。案例的排障表里都列了。

准备工作

实践前需要四样东西:

  1. DevEco Studio + API 26 SDK(也可以用鸿蒙开发实践中心的云端工作区 + 云手机)
  2. 华为云 OBS 私有桶——控制台创建,存储类别选标准存储,访问权限选私有
  3. AK / SK——建议用最小权限的 IAM 用户,只授予目标桶的 ListBucket + PutObject + GetObject
  4. 四项配置:AK、SK、区域 Endpoint(如 obs.cn-north-4.myhuaweicloud.com)、桶名——App 设置页填入后保存

⚠️ AK/SK 在应用中以明文存在 preferences 沙箱中,仅用于教学调试。不要提交到代码仓库或分享给他人。

两条实践路线

案例提供了两种走法:

  • 快速体验(~30 min):直接导入案例仓库,让 AI 编译打包 → 连云手机 → 安装 → 填配置 → 体验功能。适合想先看效果的人。
  • 完整实践(~120 min):从空项目开始,只下载七张参考截图作为设计素材,不复制案例业务代码。让 AI 逐步帮你建工程、实现签名认证、实现备份、实现云端预览。适合想真正掌握的人。

进阶扩展(选做)

案例还给了四个独立改造方向,每个都附了设计 → 实现 → 验证的完整引导:


场景 任务
家庭视频备份(>64 MiB) 分段上传大文件
旅行素材整理 云相册时间轴(按 OBS lastModified 分组)
文档资料归档 文档选择备份(系统选择器 + PDF/TXT)
跨设备相册恢复 云端下载恢复到系统相册

一点感受

这个案例好在不回避真实问题:签名怎么算、去重怎么做、取消后怎么处理、大文件怎么办、预览缓存上限是多少——都写得很明确。它不是"调个 SDK 一行搞定"的教程,而是让你理解 OBS REST API 的认证和操作到底在发生什么。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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