鸿蒙应用上云实战:用 OBS 打造个人云相册的完整实践
引言
手机里的照片越来越多,换机、清理空间、误删恢复,几乎每个用手机拍照的人都遇到过这些烦恼。把照片备份到云端,是最直接的解法,但“备份”本身也可以是一次很好的练手项目:它同时涉及端侧的媒体读取与界面、云侧的对象存储与鉴权,以及两者之间的网络请求。最近,我结合鸿蒙开发实践中心的一个案例,完整走了一遍“用 OBS 打造个人云相册 App”的流程,从准备云资源、实现上传与去重,到在云端浏览照片,收获不少。这里把实践过程和踩过的坑记录下来,供同样想动手的朋友参考。
一、这个云相册要解决什么问题
案例要做的是一款基于 HarmonyOS 与华为云 OBS 的个人云相册应用,核心能力可以概括为三点:第一,从本地图库筛选照片和视频,逐文件上传到属于自己的 OBS 桶;第二,在备份记录里查看每一次备份的结果,支持重复备份时跳过已完成的文件;第三,在云端刷新对象列表,以网格或列表查看云端图片和视频,并打开预览。
之所以说它适合练手,是因为功能边界很清晰:不追求面面俱到,但每个环节都真实可用。做完之后,你会对“端侧应用如何与对象存储打交道”有一个完整的体感。
二、动手之前:先把云资源准备好
1. 创建 OBS 桶与访问密钥
在华为云控制台搜索并打开对象存储服务 OBS,先创建一个私有桶。桶名全局唯一,建议用小写字母、数字和连字符组合;区域要按实际使用选择,存储类别选标准存储。随后在“我的凭证—访问密钥”中新增访问密钥,得到 AK、SK,并记下桶所在区域的 Endpoint 和桶名,这四项信息后面要在 App 的设置页里填写。
2. 权限与安全要先想清楚
教学演示里常把 AK、SK 直接填在 App 设置中,但有两点必须注意:一是尽量使用专门创建的 IAM 用户并只授予最小权限,例如该桶的对象上传、读取与列举权限;二是 AK、SK 虽然在设置页以密码态输入,但仍以明文保存在应用沙箱的 preferences 中,仅适合教学调试,生产应用应当采用临时授权等更安全的方案。凭据不要提交到代码仓库,也不要发到聊天记录或截图里。
3. 开发环境两种选择
本地开发需要 DevEco Studio 与 HarmonyOS SDK,工程的编译、兼容与目标版本均为 26.0.0。另一种方式是使用云端工作区与云手机,在鸿蒙开发实践中心的作业中心创建项目,把案例仓库地址填入“案例仓地址”即可。两种路径的产物一致,可以按自己的设备情况选择。
三、核心实现:签名、去重与云端浏览
1. OBS Header 签名是关键一步
OBS 的 REST API 要求请求携带签名,基本思路是:按规范构造规范化资源与请求头,用 SK 计算 HMAC-SHA1 并做 Base64 编码,放到 Authorization 请求头中,格式为 OBS AK:签名。实现时要格外注意字符串拼接的细节,例如资源路径、请求头排序和时间格式,任何一处偏差都会导致签名不匹配。
2. 逐文件备份与去重
应用通过 photoAccessHelper 读取用户授权的本地照片和视频,用户选择文件或一键备份全部待备份项目后,逐文件上传并显示进度。对象键由本地 URI、大小、修改时间与 MD5 等信息生成,并使用 photo_backup/v2/ 前缀。备份记录按 Endpoint 和桶隔离,已完成的文件会依据本地记录、MD5 和云端 ETag 核验后跳过;取消的当前文件则需要整文件重新上传。当前实现不支持后台定时备份和字节级断点续传,单文件上传与预览上限为 64 MiB。
3. 云端浏览与预览
备份完成后,在云端页面刷新对象列表,可以查看对象详情,也可以在列表与网格之间切换,照片和视频以缩略图展示,点击即可打开图片或视频预览。预览通过认证 GET 读取原对象,云预览磁盘缓存上限 128 MiB,缩略图最多缓存 64 张。需要注意,公网读取原对象可能产生流出流量,使用时要留意用量。
四、体验路径:先跑通,再自己造
案例给出了两条清晰的路线。快速体验是把现有工程跑起来:创建项目并导入案例,让 AI 检查 API 26 SDK、依赖与构建工具并编译 entry HAP,再创建并连接支持 API 26 的云手机,把 HAP 安装到设备上打开,最后填入 OBS 配置、选一张非敏感测试照片发起备份,看到备份结果与云端对象即算跑通。
完整实践则是从空项目开始:只下载统一的视觉参考图片到 reference 目录,不复制案例业务代码,自己实现本地图库、备份记录、云端与设置页面,再实现 OBS 认证与备份、云端预览等能力。先跑通再自己造,遇到问题时有参照可对照,学习曲线会平缓很多。
五、排障清单:先核对这几项
实践中最常见的报错是签名不匹配或 403。遇到时可以按顺序核对:Endpoint 与桶名是否与所选区域一致、AK 与 SK 是否正确、设备时间是否准确、权限声明是否完整、规范化资源是否符合规范。相册为空时,先确认设备中有测试媒体且已授予照片与视频读取权限;备份后再次备份无变化时,检查同一目标下的记录与 MD5。费用方面,存储包只按适用条件抵扣存储费用,公网下载流量、读写请求以及超出额度或有效期的用量仍可能产生费用,资源包、桶的区域与冗余策略必须匹配才能抵扣。
小结
做完这个云相册,我最大的体会是:一个看似简单的“备份照片”功能,串起了端侧开发、云服务鉴权与对象存储三块知识。先把云资源和最小权限准备好,再实现签名、逐文件备份与云端浏览,最后按验收标志逐项验证,是比较稳妥的实践顺序。如果你也想找一个能落地的鸿蒙练手项目,不妨从这个云相册开始:先用快速体验跑通全链路,再按完整实践从空项目自己实现一遍,遇到 403 或签名问题时对照排障清单逐项核对,基本都能顺利解决。
- 点赞
- 收藏
- 关注作者
评论(0)