用OBS打造个人云相册App:一次鸿蒙端云协同实践记录
前言
手机里的照片和视频越来越多,本地存满了、换手机又怕丢。我最近在华为云鸿蒙开发实践中心实践了一个案例:用 OBS 打造个人云相册 App,把照片和视频备份到自己的华为云 OBS 桶里,还能在云端查看和预览。这篇文章记录这次实践的完整过程和踩过的坑。
这个 App 要做什么
案例的目标很清晰,一个 App 完成四件事:
- 在本地图库里筛选照片和视频,选择文件或一键备份全部待备份项目;
- 逐文件上传到 OBS,实时看到每个文件的备份进度和结果;
- 在备份记录里查看结果,支持取消和再次发起备份;
- 在云端刷新对象列表,切换列表和网格视图,打开图片和视频预览。
技术上分两层:端侧用 ArkTS、ArkUI 和 photoAccessHelper 做相册读取与界面;云侧用 OBS REST API 做上传、列举和读取,认证方式是 OBS Header 签名。
第一步:先把云端准备好
动手写代码之前,先把 OBS 的四项配置准备好:AK、SK、区域 Endpoint 和桶名。
- 在 OBS 控制台创建私有桶,区域按实际使用选择,存储类别选标准存储;
- 在“我的凭证-访问密钥”里新增访问密钥,下载保存好密钥文件,SK 之后无法再次查看;
- 在桶概览里确认所属区域的 Endpoint,请以控制台显示的为准,不要照抄示例,也不要填“桶名.Endpoint”这种形式;
- 在 App 的设置页里填入这四项并保存。
两个提醒:第一,如果买了存储资源包,桶的区域和单/多 AZ 冗余策略必须和资源包匹配,否则抵扣不上,会按需计费;第二,建议用专门的 IAM 用户并只授予这个桶的最小权限,AK 和 SK 不要提交到代码或发到聊天记录里。
第二步:用 AI DevSpace 搭环境、编译打包
这次我用的是华为云 AI 开发者空间体验版。在鸿蒙开发实践中心的作业中心创建项目,把案例仓地址填入“案例仓地址”,工作区里能看到 build-profile.json5 和 entry 模块就算导入成功。
然后让 AI 帮我检查当前工程的 API 26 SDK、依赖和构建工具,编译 entry HAP。构建成功后创建并连接支持 API 26 的云手机,再让 AI 把刚构建的 HAP 安装并打开。云手机上显示应用的本地图库,这一步就通了。
第三步:备份的核心逻辑
备份流程是这个案例最值得琢磨的部分:
- 首次进入图库时按提示授予照片和视频读取权限;
- 选择测试文件或全部待备份项目后开始备份,逐文件上传并显示进度;
- 对象键由本地 URI、大小、修改时间与 MD5 等信息生成,使用 photo_backup/v2/ 前缀;
- 备份记录按 Endpoint 和桶隔离,已完成的文件依据本地记录、MD5 和云端 ETag 核验跳过,避免重复上传;
- 取消的当前文件需要整文件重新上传,当前不支持后台定时备份和字节级断点续传。
上传使用 x-obs-forbid-overwrite 做同名对象保护。需要注意的是,如果桶启用了版本管理,删除当前对象不一定删除历史版本,清理时要按控制台的实际版本处理。
第四步:云端预览与排障
备份完成后,刷新云端列表就能看到刚上传的对象,照片和视频以缩略图展示,可以打开图片和视频预览。预览通过认证 GET 读取原对象,单个文件上限 64 MiB,磁盘缓存上限 128 MiB,缩略图最多 64 张。
实践中遇到 403 或签名不匹配,别急着改代码,先按顺序核对:Endpoint、桶名、AK/SK、设备时间、权限与规范化资源。我的经验是,大多数 403 都是四项配置里某一项填错了,尤其是 Endpoint 复制成了带桶名的形式。
实践中踩过的几个坑
- 资源包与桶不匹配:40 GB 存储包只按适用条件抵扣存储费,公网下载流量、读写请求以及超出额度或有效期的用量仍可能产生费用,下单前先确认区域和 AZ 策略;
- 配置安全:AK/SK 在 App 里虽然是密码态输入,但仍以明文保存在应用沙箱的 preferences 中,仅用于教学调试,生产应用要采用适当的临时授权方案;
- 测试数据:只用非敏感的测试照片和视频做备份,测完及时删除测试对象、撤销或轮换测试密钥,停止不再使用的云工作区和设备。
小结
这次实践下来,我最大的感受是:鸿蒙端云协同的开发范式已经很完整了——端侧负责体验,云侧负责存储,AI 开发者空间负责把环境和构建这些脏活累活接过去。对开发者来说,真正要花心思的还是备份规则、签名认证和配置安全这三件事。下一步,我打算按案例里的选做任务,试试超过 64 MiB 的大视频分段上传,以及按 OBS 备份时间分组的云相册时间轴。
- 点赞
- 收藏
- 关注作者
评论(0)