用 OBS 打造个人云相册 App —— HarmonyOS + 华为云实践入门
这个案例在做什么
一句话:读取本地相册 → 逐文件上传到 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 里、设备时间偏差过大、规范化资源构造不规范。案例的排障表里都列了。
准备工作
实践前需要四样东西:
- DevEco Studio + API 26 SDK(也可以用鸿蒙开发实践中心的云端工作区 + 云手机)
- 华为云 OBS 私有桶——控制台创建,存储类别选标准存储,访问权限选私有
- AK / SK——建议用最小权限的 IAM 用户,只授予目标桶的
ListBucket+PutObject+GetObject - 四项配置: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 的认证和操作到底在发生什么。
- 点赞
- 收藏
- 关注作者
评论(0)