读鸿蒙案例笔记:用 OBS 打造个人云相册 app
前几天写像素画板、数独和端云一体待办清单的时候,我一直在想一个问题:手机里的照片越来越多,到底怎样才算把它们真正存好了?这几天读到的这个鸿蒙案例给了我一个很实在的答案:用华为云对象存储 OBS,给自己做一个个人云相册 app。它不是把照片交给某个现成的相册软件,而是自己搭一条从手机相册到云端桶的备份链路,照片存在自己的桶里,备份记录和云端浏览都由自己控制。案例发布于 2026 年 11 月 13 日,定位是进阶,官方给出的完成时间大约 120 分钟,运行环境要求 API 26,代码仓在 GitCode 的 harmony-practice-center 组织下,名字是 HarmonyOS-APP-OBSCloudAlbum。读完案例页和仓库 README 之后,我把自己当成一个刚接触鸿蒙和云存储的新手,把理解、疑问和动手顺序都记了下来。
一、这个案例到底做了什么
先说结论,这个 app 要解决的是很具体的一件事:把手机本地相册里的照片和视频,备份到属于自己的 OBS 桶里,之后还能在 app 里直接查看云端已经备份了哪些内容。案例介绍里把它拆成两条线。第一条线是备份:app 会读取本地相册,做内容筛选,支持多选或者一键全选,备份时能看到进度,也可以中途取消。第二条线是云端查看:备份完成后,app 可以列出桶里的对象,用网格展示缩略图,点开某个对象能看详情和预览。整个过程不依赖第三方相册服务,照片的落点就是自己创建的桶。
对我这样的新手来说,这个划分很有帮助。很多教程一上来就讲接口和参数,读完还是不知道 app 应该长什么样。而这个案例先把用户看得见的两件事讲清楚:备份和查看。之后再去看签名、上传这些实现细节,就知道它们是为哪一步服务的。案例还给出了完成之后可以交付的成果:一款支持 API 26 的应用,能用 OBS Header 签名方式逐个上传文件,备份记录可以保存下来,云端对象可以浏览和预览。读到这里,我心里就有了一张图:本地相册是起点,OBS 桶是终点,中间是签名、上传、记录和展示这几步。
二、读之前先弄懂的三个概念
如果直接跳进代码,我最容易卡住的地方其实是云存储的几个基本概念。案例和 README 把它们讲得很克制,我按自己的理解再梳理一遍。
第一个是 OBS 桶。可以把它理解成云端的一个大文件夹,自己创建、自己命名,照片和视频就以对象的形式存在里面。案例里要求创建一个私有桶,存储类别选标准存储。私有这个设定很重要,它意味着不是谁拿到链接就能看,而是要经过签名认证才能访问。
第二个是 AK 和 SK,也就是访问密钥。AK 像是账号名,SK 像是密码,app 拿着它们才能向 OBS 证明自己的身份。案例里需要配置四个参数:AK、SK、Endpoint 和桶名。Endpoint 是 OBS 服务的访问地址,案例里给的例子是 ,也就是华北四区域的地址。自己的桶在哪个区域,就要填对应区域的地址,填错了区域,请求就找不到正确的服务。
第三个是 Header 签名。app 不是把 AK 和 SK 直接发给服务端就完事,而是用 HMAC-SHA1 算法,把请求方法、时间、对象路径等信息算出一个签名,放到 Authorization 请求头里,格式是 OBS 加上 AK 和签名。服务端收到请求后会用同样的方法重新算一遍,对得上才放行。这个设计的好处是,SK 本身不直接出现在请求里,签名只对当次请求有效。新手第一次接触可能会觉得麻烦,但理解之后就会明白:签名就是一次性的通行证,而不是把钥匙到处递。
三、跟着案例走一遍:准备、配置、备份、查看
案例把上手过程分成了三步,我觉得这个顺序很适合新手照着做。
第一步是准备账号和桶。需要有一个华为云账号,开通 OBS 服务,然后创建一个私有桶。案例里还提到一个可选的成本参考:OBS 存储包 40GB 一年大约 9 元,适合想先低成本试试的人。我的理解是,正式动手之前,先把这笔小账算清楚,再决定要不要开通,心里会踏实一些。
第二步是配置四个参数。AK、SK、Endpoint、桶名这四项缺一不可。案例特别提醒,SK 属于敏感信息,不要写在对话记录、代码或者截图里。app 里的配置页面有一个密码状态,也就是输入框会把密钥隐藏起来,只在设置页填写。这一点我一开始没太在意,读到后面的安全说明才明白,隐藏输入只是不让旁人一眼看到,不等于密钥被加密保存了。
第三步就是真正的备份和查看。在 app 里选好照片和视频,点备份,进度条会告诉你传到哪了,传完之后到云端页看一看,对象列表里有没有刚传的文件,缩略图能不能正常显示,点开预览能不能打开。如果这三步都通了,整个链路就算跑通了。案例里还给了一个很实用的建议:第一次先用少量照片试跑,确认没问题再批量备份。这个习惯对新手特别重要,出了问题也容易定位。
四、代码分工、容易踩的坑与安全边界
仓库的文件划分对新手很友好:页面入口是 Index.ets,备份核心在 BackupService.ets,扫描本地相册靠 MediaScanner.ets,和 OBS 打交道的是 ObsClient.ets,备份规则在 BackupRules.ets,数据模型在 BackupModels.ets,云端预览状态由 CloudPreviewStore.ets 维护。按这个顺序读,先看界面,再看扫描和签名,最后看预览,就不会迷路。还有两个小细节值得记:x-obs-forbid-overwrite 是同名保护,防止覆盖云端已有的文件;按 MD5 去重和目标隔离,则避免重复上传。
案例列出的问题清单也很实用。最常见的是签名报错 SignatureDoesNotMatch,要检查密钥、请求路径和请求头,还要确认手机时间是否准确,因为签名里带了时间信息。相册为空先检查相册权限;预览打不开要看权限、网络、大小和格式,单个文件上限 64MiB,预览磁盘缓存上限 128MiB,缩略图最多 64 个,超过上限的大视频需要走分片上传。
安全这一节我单独记下来:app 里密码状态只是隐藏输入,并没有对沙箱里的 AK 和 SK 做加密,生产环境应该用临时授权。IAM 授权也要最小化,只给 ListBucket、PutObject 和 GetObject 这几项,做完实验记得清理测试对象和桶、定期轮换密钥。这个案例是学习用的,不是直接上线的产品形态,这一点要分清楚。
五、还能怎么玩和小结
案例给了四条扩展方向:超过 64MiB 的家庭视频用分片上传;按拍摄时间做旅行时间线,但要注意文件修改时间不等于拍摄时间,要读 EXIF;把备份扩展到 PDF 和 TXT 文档归档;以及换手机后从云端下载恢复。我的动手顺序是:先用一两张小照片跑通备份和查看,再读 ObsClient 的签名逻辑,最后试时间线这个扩展。
回过头看,这个案例最打动我的地方,是把一件日常的事讲清楚了:照片存在哪里、怎么证明身份、怎么传上去、怎么再找回来。OBS 是存储,Header 签名是通行证,AK 和 SK 是身份,桶是自己的一块云端空间。案例基本信息:标题是用 OBS 打造个人云相册 app,发布于 2026 年 11 月 13 日,难度进阶,预计约 120 分钟,运行环境 API 26,语言 ArkTS 和 ArkUI。
- 点赞
- 收藏
- 关注作者
评论(0)