用 OBS 打造个人云相册 App 实操手记:签名与备份避坑
今天浏览的案例是「用 OBS 打造个人云相册 app」(ArkTS、ArkUI,进阶,预计 120 分钟)。目标是做一个支持 API 26 的相册云备份应用:从本地图库选照片和视频,经 OBS Header 签名逐文件备份到自己的 OBS 桶,再在云端查看缩略图和预览。难点不在界面,而在签名、权限与费用这三处细节上。
先说明:本文是我阅读该案例后的手记,只记录案例的设计与注意事项,我今天只做了案例阅读,没有实际部署。
一、案例是做什么的
应用要做的事分三步:备份、云端查看、签名。备份支持筛选、多选或一键备份全部待备份文件,过程显示进度、可中途取消;云端查看可以列举桶中对象,在列表和网格间切换,查看缩略图与详情,并通过带认证的 GET 请求预览;签名是前两步能跑通的前提,所有访问 OBS 的请求都要经过 OBS Header 签名认证。
二、三个核心技术点
案例的「核心知识」一共三条。第一是 OBS Header 签名(HMAC-SHA1):根据请求方法、内容头、规范化 OBS 请求头和资源拼出签名字符串,再用 SK 计算 HMAC-SHA1,生成 OBS AK:Signature 认证头,拼错任一字段都会直接返回 403。第二是相册读取:通过 photoAccessHelper 请求照片和视频读取权限,按类型、时间筛选本地媒体;首次进入图库要按提示授权,否则图库为空。第三是逐文件备份:按目标对象逐文件计算 MD5,重复备份时跳过已备份文件;目标隔离和单文件上传限制避免互相覆盖与内存超限。单文件上传与预览上限 64 MiB,云预览缓存上限 128 MiB,缩略图最多 64 张。配置与备份记录保存在应用沙箱 preferences 里。
三、关键实现思路
动手前要准备:API 26 构建工具链与支持 API 26 的云手机(或本地模拟器、已授权真机);一个私有 OBS 桶(标准存储、私有访问);以及四项配置——AK、SK、Endpoint、桶名。Endpoint 以华北-北京四为例是 obs.cn-north-4.myhuaweicloud.com,不含桶名、对象路径和端口;桶名如 album-demo-7m3x9,须全局唯一,由小写字母、数字和连字符组成。
流程大致是:创建项目并填入案例仓地址,让 AI 检查 SDK 与构建工具,编译 entry HAP;创建并连接云手机,让 AI 安装并打开 HAP;首次进入图库时授权相册,在「设置」里填入四项配置并保存;选择测试文件或全部待备份项目开始备份;最后查看记录,刷新云端列表查看缩略图及预览。
四、新手最容易踩的坑
费用先算清楚。买存储资源包不会自动建桶,桶要另外创建;40 GB 是存储容量额度,不是下载流量,也不是整年费用封顶,存储包只按适用条件抵扣存储费,公网下载流量、读写请求及超额用量仍可能产生费用。资源包、桶区域与单 / 多 AZ 策略、存储类别须匹配才能抵扣;桶名、区域及策略建好后不能直接改,提交前核对。
Endpoint 别照抄。不要照抄 App 默认值,也不要填「桶名.Endpoint」形式的桶访问域名或完整对象 URL;桶名避免使用英文句点。
AK/SK 要当回事。SK 新建后不能重新查看,遗失只能新建并替换;AK/SK 只在 App 设置里填写,不要发到聊天记录、源码或截图里。密码态只是隐藏显示,并没有加密沙箱里的 AK/SK,生产应用应采用临时授权方案。案例推荐用已开启「编程访问」的专用 IAM 用户,只授予该桶的 obs:bucket:ListBucket 和桶内对象的 obs:object:PutObject、obs:object:GetObject 权限。
签名 403 先查四项配置。遇到 SignatureDoesNotMatch 或 403,先核对 Endpoint、桶名、AK/SK、设备时间与权限;设备时间不对也会导致签名失效,很容易被忽略。
功能层面的坑也不少:图库为空先确认设备里有测试媒体且已授权;云端预览失败检查对象读取权限、网络、文件大小和格式;再次备份要检查同一目标下的记录和 MD5,清除应用数据会影响本地记录;上传用 x-obs-forbid-overwrite 做同名保护。还有两点:lastModified 是 OBS 对象时间,不是 EXIF 拍摄时间,不要标为拍摄时间,显示时须明确时区;分段上传不要简单移除内存上限,也不要把分段 ETag 当整文件 MD5。
最后是清理:测试用最小权限凭据和非敏感媒体;保存需要的工程和数据后,停止不再使用的云工作区和设备;删除测试对象及不再需要的桶,撤销或轮换测试密钥。桶启用版本管理时,删除当前对象不一定删除历史版本,要按控制台实际版本清理。
五、小结
这个案例把「个人云相册」拆得很实在:签名解决身份问题,photoAccessHelper 解决本地媒体读取,MD5 和目标隔离解决重复备份与覆盖问题。成本在前置准备和细节上:四项配置要填对、桶和资源包的区域与策略要匹配、AK/SK 要用最小权限、费用先算清再动手。遇到问题先对照排障清单查四项配置和权限,大部分坑都能绕过去。
- 点赞
- 收藏
- 关注作者
评论(0)