鸿蒙 NEXT + 华为云 OBS 个人云相册:架构拆解与接入实录
一、这是什么
一个基于华为云 OBS 与鸿蒙生态的个人云相册应用案例,主打“云上合集,分享美好”:在鸿蒙设备上查看云端照片、管理相册、看单张照片详情、收藏/分享照片或视频,还能配置 OBS 桶信息、查看上传/下载记录、做备份。
适合三类人:HarmonyOS 应用开发者、大前端开发者、云服务集成开发者。想快速掌握鸿蒙生态云端相册的架构设计与 OBS 接入方法,读这个案例的源码是最短的路。
二、架构:三层,数据流很干净
README 给的架构分层是这样的:
用户终端(鸿蒙设备)→ 端侧应用 → 云端服务
端侧应用分三层:
- 页面层:照片页面、相册页面、上传记录页面、视频页面、设置页面等
- 服务层:OBS 服务、上传服务、下载服务、备份服务、照片服务
- 数据层:本地数据存储
云端是华为云 OBS、云端对象存储、云端图片处理服务等。
数据流只有一条:端侧应用 → OBS SDK → 华为云 OBS。照片、视频、缩略图都以对象形式存在 OBS 桶里,端侧按需下载、本地缓存。这意味着端侧基本不存业务数据,只做展示和任务管理——换设备、清缓存都不丢东西,东西全在桶里。
各模块的分工也值得抄:照片模块管云端照片列表、预览、原图预览;相册模块管分类与管理;上传模块管图片上传、批量上传、断点续传;下载模块管下载、缓存与离线浏览;设置模块管 OBS 桶信息、网络配置与权限管理。
三、OBS 是怎么接的:SDK + V4 签名,不用自己写签名
这是整个案例最有价值的部分。
端侧通过华为云 OBS SDK 对接 OBS。OBS 服务层把 SDK 的配置、上传、下载、删除、列举对象等接口封装了一层,供上层页面调用。调用时要传四个东西:Access Key(AK)、Secret Key(SK)、Bucket(桶名)、Endpoint(节点地址)。
签名这块不用自己动手:OBS SDK 默认使用 V4 签名算法,端侧无需自行实现签名逻辑,只需要在 OBSConfig 中配置 AK/SK 与 Endpoint 即可。配置里还有 ServiceType.UNION/OBS、Region.CN_NORTH_4 这类选项。
配置入口在应用内的设置页(SettingsPage):填桶名、Endpoint、AK、SK、Region,保存后可以测试连接。也就是说,接入 OBS 的全部工作就是三步:控制台建桶拿 AK/SK → 设置页填好 → 测试连接。SDK 把签名、请求、重试这些脏活都包了。
四、功能点:一个相册该有的都有了
按 README 列的功能:
- 云端照片管理:上传、批量上传、断点续传、按时间排序、按相册分类查看
- 相册管理:创建、重命名、删除相册,相册内照片管理
- 预览与详情:单张预览、原图预览、缩放查看,详情里有拍摄时间、大小、格式
- 照片操作:收藏、分享、删除、批量删除、多选操作
- 视频管理:视频列表、预览、播放、上传/下载(端侧用了鸿蒙本地视频编码)
- 上传/下载记录:看任务状态,失败可以重试
- OBS 配置管理:设置页配桶名、Endpoint、AK、SK、Region,支持切换桶、测试连接
- 本地缓存与离线浏览:下过的照片本地缓存,离线也能看
- 搜索与筛选:按关键词搜,按时间/类型筛
页面也齐:首页、云端照片页、相册页、照片详情页、视频页、上传记录页、设置页。断点续传和失败重试这两个点很实在——传照片这种事,网络一抖就断,没有断点续传和重试就是半成品。
五、从零跑起来
前置条件:DevEco Studio NEXT 6.0.0.801+、HarmonyOS NEXT 5.0.1(API 14)+ 真机、华为云 OBS 控制台已创建桶、已获取 AK/SK、华为开发者账号/HMS SDK、DevEco Studio 用户登录。
步骤是:git clone https://gitcode.com/harmony-practice-center/HarmonyOS-APP-OBSCloudAlbum.git ,cd HarmonyOS-APP-OBSCloudAlbum,然后在 DevEco Studio 中打开项目。OBS 配置分五步:登录华为云控制台进 OBS 服务 → 创建桶(选区域、存储类别等)→ 在“我的凭证”中创建访问密钥拿 AK/SK → 在应用设置页填桶名、Endpoint、AK、SK、Region → 保存配置并测试连接。
编译运行:DevEco Studio > Build > Make Module… > 生成 HAP > Run > Run ‘entry’(Shift+F10)。前提是 OBS 桶和客户端配置都配好了,并且开放了相册权限。想先看效果也可以走 DevEco Studio 直接从 GitCode 导入项目,或者用页面上的“云体验”入口在线体验。
目录结构也值得看一眼:主模块在 entry/src/main/,下面是 ets(ArkTS 源码)、resources(资源)、module.json5(模块配置);cases/ 里是案例展示和实践资料(架构图、预览图、practice.html);AppScope 是应用级配置,hvigor 是构建工具配置,还有 tests 测试目录。
六、几个坑
只支持 HarmonyOS NEXT 真机,不支持 Android/iOS。这是 README 明确写的,别想着一套代码多端跑。
权限按需开。需要声明的权限包括 ohos.permission.INTERNET、READ_MEDIA、WRITE_MEDIA、CAMERA、OPERATE_PRIVACY、EDIT_MEDIA、WRITE_IMAGEVIDEO、GET_NETWORK_INFO、KEEP_BACKGROUND_RUNNING、MODIFY_AUDIO_SETTINGS 等,还有自定义权限 CUSTOM_SETTINGS 相关的。README 强调“权限按需开放”,别一股脑全开。
费用与密钥安全。OBS 按量计费,超出免费额度要自己承担费用。AK/SK 是敏感凭证,妥善保管,绝对不要提交到代码仓库。桶名、Endpoint 配错了,连接和上传都会失败,先核对配置再怀疑代码。
隐私合规。照片是敏感数据,读相册、上传云端都要用户授权和确认,须遵循鸿蒙统一隐私声明与相关隐私合规要求。
结尾
这个案例的价值不在“相册”本身,而在它把一条完整链路跑通了:ArkTS/ArkUI 端侧分层 → OBS SDK 封装 → V4 签名 → 桶里对象化存储 → 断点续传、缓存、离线浏览。想做鸿蒙端上云的应用,照着这个结构抄,比从零搭要快得多。源码在 GitCode 上是公开的(Apache-2.0 协议),直接拉下来读就行。
(正文结束。来源案例:GitCode harmony-practice-center/HarmonyOS-APP-OBSCloudAlbum,Apache-2.0 协议。)
- 点赞
- 收藏
- 关注作者
评论(0)