鸿蒙开发实践:用 OBS 打造个人云相册 App 的关键技术与避坑指南
引言
手机里的照片越来越多,换手机、清理空间、找一张几年前的旧照片,都成了让人头疼的小事。把照片和视频备份到自己的云存储里,听起来并不新鲜,真正动手做一遍,才会发现里面的细节远比想象中多:相册怎么读、上传怎么鉴权、失败了怎么重试、云端怎么看、流量和费用怎么控制。
本文结合一次鸿蒙开发实践,记录用 HarmonyOS 与华为云对象存储服务 OBS 打造个人云相册 App 的过程。目标不是堆功能,而是把一条最小可用的链路跑通:从本地图库选文件,逐个备份到自己的私有桶,再在云端列表和网格里查看、预览。文章会讲清楚架构怎么分层、签名为什么总出错、备份去重怎么做,以及实践中最容易踩的几个坑。
一、整体架构:先画一张清晰的图再写代码
动手写代码之前,先把职责分清楚,是这个案例最值得借鉴的一点。一个云相册 App 大致可以分成四层:界面层、备份服务层、存储客户端层和本地状态层。
界面层用 ArkUI 实现本地图库、备份记录、云端列表和设置四个页面,负责展示和交互,不直接碰网络。备份服务层负责编排一次备份任务:扫描待备份文件、判断是否已经备份、逐个上传、记录进度和结果。存储客户端层只做一件事,就是和 OBS 打交道:构造签名请求、上传对象、列举对象、拉取预览。本地状态层把配置和备份记录保存在应用沙箱里,例如桶名、区域 Endpoint,以及每个文件对应的目标对象和内容摘要。
分层的好处在排障时最明显。上传失败,先看是签名问题还是网络问题;列表刷不出来,先看列举接口返回了什么;备份重复,先看记录里的摘要是否一致。每一层只对自己的输入和输出负责,出了问题不用满工程翻代码。
二、关键技术一:OBS Header 签名不能含糊
这是整个实践里最容易卡住的地方,也是最能体现基本功的地方。OBS 的 Header 签名方式要求客户端自己构造一个规范化的签名字符串,再用 Secret Access Key 计算 HMAC-SHA1,最后生成形如 OBS AK:Signature 的 Authorization 请求头。
签名字符串由请求方法、内容头、规范化的 OBS 请求头和规范化资源组成。任何一个细节对不上,服务端算出的签名就和客户端不一致,结果就是常见的签名不匹配错误。实践中我总结了三条检查顺序:先核对 AK、SK、桶名和 Endpoint 是否填错,再核对请求头和资源路径的规范化写法,最后核对设备时间是否准确。很多看似玄学的失败,最后都是时间偏差或者把桶访问域名写成了对象地址。
还有一个原则要提前定下来:密钥只在 App 的设置页里填写,不放进源码,不写进日志,不出现在截图和公开提问里。测试用的密钥应当使用最小权限,例如只给测试桶的对象读写和列举权限,用完及时轮换。安全不是收尾时才想的事,而是从第一行配置代码就要遵守的习惯。
三、关键技术二:逐文件备份与去重
个人云相册的备份策略,适合逐文件上传,而不是把整个图库打包成一个大文件。这样做的好处是进度清晰、失败可重试、单个文件出问题不影响其他文件。流程大致是:先用系统相册读取能力筛选出照片和视频,再按目标对象和内容摘要判断是否已经备份过,最后逐个上传并更新备份记录。
去重的关键是内容摘要。只按文件名判断并不可靠,同名文件可能内容不同;只按时间判断也不可靠,修改后时间会变。比较稳妥的做法是为每个文件计算内容摘要,并结合目标对象做隔离:同一个目标位置下,摘要相同就跳过,摘要不同再上传。备份记录要保存足够的信息,至少包括源文件标识、目标对象、摘要和备份时间,方便事后核对。
上传过程还要考虑可取消和可观察。用户点开始备份后,应当能看到当前传到第几个文件、总体进度是多少;点取消后,正在传的文件要能停下来,已经传完的文件要有明确记录。单文件上传和预览建议设置合理的上限,例如单个文件不超过 64 MiB,超过的大视频应当走分段上传,而不是强行放进内存。
四、关键技术三:云端列表、网格与预览要克制
备份上去只是第一步,能方便地找回来才算完成。云端查看通常包括对象列表、网格切换、对象详情和图片视频预览。列举对象时按需分页,不要一次拉取全部对象;缩略图要限制数量和缓存大小,例如缩略图最多保留几十张、磁盘缓存设置一个明确上限,避免预览几张大图就把空间占满。
预览也要区分对待。图片可以直接通过认证请求获取并展示,视频则要考虑流量和大小,优先展示缩略图和基本信息,用户确认后再加载原文件。需要提醒的是,读取原对象会产生相应的请求和流量费用,预览逻辑越克制,账单越可控。界面上可以明确标注对象的大小和备份时间,让用户在点开之前就有预期。
五、实践中的五个避坑点
第一个坑是 Endpoint 照抄示例。不同地域的 Endpoint 不同,必须从自己桶的概览页复制对应值,不能把示例里的域名直接拿来用,也不要写成桶名加 Endpoint 的形式。
第二个坑是资源包与桶不匹配。存储包只按适用条件抵扣存储费用,区域和单、多可用区策略必须与桶一致,否则可能按需计费。购买资源包不会自动创建桶,建桶、选区域、选冗余策略都要再核对一遍。
第三个坑是权限给得太大。测试阶段就用最小权限的专用凭证,只给测试桶必要的权限,范围以实际测试桶为限。生产环境更应当使用临时授权等更稳妥的方案,而不是长期有效的密钥。
第四个坑是拿真实照片做测试。测试一律使用非敏感的测试照片和视频,避免把私人照片传到测试桶里,测试完成后及时清理测试对象和不再需要的桶。
第五个坑是做完不清理。云端实践结束之后,停止不再使用的工作区和云手机,删除测试对象,撤销或轮换测试密钥。如果桶开启了版本管理,删除当前对象不一定删除历史版本,要按控制台实际版本清理并确认费用。
六、从能跑到好用:三条进阶路线
基础链路跑通之后,可以沿着三个方向继续打磨。第一条是分段上传大文件,把超过 64 MiB 的视频切分成多段上传再合并,失败或取消时要有明确的中止或可恢复状态,完整性校验不能把分段标识当成整文件摘要。
第二条是云相册时间轴,按 OBS 对象的备份或上传时间分组展示,明确标注时区,不要把对象时间说成拍摄时间。日期筛选要有空态,原来的详情、网格切换和预览功能要保持可用。
第三条是文档选择备份,通过系统文件选择器备份指定类型的文件,例如 PDF 和 TXT,复用目标隔离和摘要核验,不支持的类型要明确拒绝,授权失效时要给出提示。这三条路线都不需要推倒重做,都是在已有分层上加能力。
小结
用 OBS 打造个人云相册 App,真正的难点不在界面,而在签名、备份、去重、预览和清理这条链路是否完整、是否可验证。先分层、再跑通最小链路、再用真实设备和测试文件验证每一步,比一开始就追求功能齐全更有效。
如果你也在做类似的鸿蒙实践,建议按这个顺序走:准备好私有桶和四项配置,跑通一次小文件的备份和云端预览,再去做分段上传、时间轴和文档备份。把每一步的实际结果记录下来,遇到失败先看日志和响应,再回头核对配置,多数问题都能定位到具体的一层。希望这篇实践记录,能帮你少走一些弯路。
- 点赞
- 收藏
- 关注作者
评论(0)