鸿蒙实践笔记:用 OBS 打造个人云相册 App 的体验与要点
一、案例概览
今天在鸿蒙开发实践中心浏览了“用OBS打造个人云相册app”这个鸿蒙实践案例。案例的目标是做一个基于 HarmonyOS 与华为云 OBS 的个人云相册应用:读取用户授权的本地照片和视频,逐文件上传到自己的 OBS 桶,并在云端查看对象列表、详情与预览。案例同时给出了快速体验和从空项目完整实践两条路径,适合愿意用 AI 编程工具辅助开发、又想核对构建和设备结果的开发者。
二、核心功能
- 本地图库:筛选照片和视频,支持选择文件或一键备份全部待备份项目,观察逐文件进度与结果。
- 备份记录:查看每次备份的结果;已完成的文件会依据目标隔离的本地记录、MD5 和云端 ETag 核验跳过,避免重复上传。
- 云端图库:刷新对象列表,支持列表与网格切换,照片和视频以缩略图展示,可以打开图片及视频预览。
- 设置页:保存 AK、SK、区域 Endpoint 和桶名,均为密码态输入。
三、关键技术点:OBS Header 签名
案例最值得学习的部分是 OBS Header 认证。应用通过 HTTP 直接调用 OBS REST API,需要按官方规范构造规范化资源与 x-obs 请求头,再用 SK 计算 HMAC-SHA1 并 Base64 编码,得到 Authorization 为 OBS AK:Signature 的形式。对象键由本地 URI、大小、修改时间与 MD5 等信息生成,使用 photo_backup/v2/ 前缀;上传时使用 x-obs-forbid-overwrite 做同名对象保护。
四、动手前的准备
- 在 OBS 控制台创建私有桶,区域与冗余策略要和已购资源包匹配,否则资源包无法抵扣相应费用。
- 在“我的凭证—访问密钥”中新增访问密钥,下载保存好 AK 与 SK,SK 此后无法再次查看。
- 准备支持 API 26 的开发环境:云端可用实践中心的云端工作区与云手机,本地可用 DevEco Studio 26.0.0 与模拟器或真机。
- 只用非敏感的测试照片做首次备份,验证通过后再扩大范围。
五、体验小结
这个案例把端侧开发(ArkTS、ArkUI、photoAccessHelper)、云侧存储(OBS REST API)与 AI 辅助开发串在了一起:先在 AI 开发者空间里用自然语言让 AI 检查工程、编译打包,再把 HAP 安装到云手机上验证备份与云端预览。过程中最容易踩的坑是配置项填错导致 403,遇到时应先核对 Endpoint、桶名、AK/SK、设备时间与权限,再按实际响应定位。
六、安全与清理提醒
AK 与 SK 只在应用设置中填写,不要提交到代码仓库,也不要发到聊天记录或截图中;密码态输入只隐藏显示,凭据仍以明文保存在应用沙箱中,仅用于教学调试。测试完成后,及时停止不再使用的云工作区和设备,删除测试对象与不再需要的桶,并轮换测试密钥,避免产生不必要的费用。
- 点赞
- 收藏
- 关注作者
评论(0)