用OBS打造个人云相册App:鸿蒙案例浏览与实践要点
今天在鸿蒙开发实践中心浏览了“用OBS打造个人云相册App”这个鸿蒙实践案例,把它的思路和关键步骤整理成这篇笔记,方便自己以后照着做,也给想做云相册的开发者参考。
一、这个案例是做什么的
案例要做的是一个基于HarmonyOS与华为云OBS的个人云相册App。应用读取用户授权的本地照片和视频,逐文件上传到自己的OBS桶,并在云端提供对象列表、详情和云图库预览。备份记录会按目标隔离保存,重复备份时依据本地记录、MD5和云端ETag核验跳过已完成的文件,取消的当前文件需要整文件重新上传。
二、开始之前要准备什么
案例文档把准备工作分得很清楚。开发环境方面,云端使用支持API 26的在线工具链和云手机,本地使用DevEco Studio和HarmonyOS SDK,工程的compile、compatible、target均为26.0.0。设备方面,云端用支持API 26的云手机,本地用相应模拟器或真机,真机需要自己的有效调试签名。权限方面,需要读取照片和视频的权限以及网络访问权限。
三、OBS的四项关键配置
要把照片真正备份到云端,需要先在华为云控制台准备好四项信息:AK、SK、区域Endpoint和桶名。流程是先在对象存储服务OBS中创建私有桶,桶名全局唯一,只能用小写字母、数字和连字符,区域和单、多AZ冗余策略要与已购资源包匹配;然后在“我的凭证-访问密钥”中新增访问密钥,下载保存密钥文件,SK之后不能重新查看,遗失时需要新建并替换;Endpoint要去桶概览里复制所属区域的区域域名,不要填“桶名.Endpoint”形式的地址。App设置页保存这四项后,刷新云端列表,选择一张非敏感测试照片发起备份,看到备份结果和云端对象,就说明链路通了。如果返回403,先核对四项配置、设备时间和桶访问权限,再看签名和规范化资源是否正确。
四、快速体验的路径
案例给出了云端和本地两条快速体验路径。云端路径是在鸿蒙开发实践中心作业中心创建项目,把案例仓地址填入案例仓地址,确认工作区显示工程文件,然后让AI检查API 26 SDK、依赖和构建工具并编译entry HAP,创建并连接云手机,再把HAP安装并打开。本地路径类似,先装好DevEco Studio和API 26 SDK,把案例代码获取到本地工作区,编译打包,再用模拟器或真机运行。两种路径最后都要在设置里填好OBS四项配置,体验选择文件或全部待备份项目、查看备份记录、刷新云端列表、切换列表和网格、查看照片视频缩略图这些主要功能。
五、需要注意的限制和费用
有几处限制值得记下来:应用单文件上传和预览上限为64MiB,云预览磁盘缓存上限128MiB;AK和SK虽然在设置页是密码态输入,但仍以明文保存在应用沙箱preferences中,仅用于教学调试,不要提交或分享凭据,生产应用应采用适当的临时授权方案;存储包只按适用条件抵扣存储费,公网下载流量、读写请求及超出额度或有效期的用量仍可能产生费用;测试结束后要停止不再使用的云工作区和设备,核对后删除测试对象及不再需要的桶,撤销或轮换测试密钥。
六、小结
这个案例的价值不在于代码量,而在于把“端侧相册读取、OBS Header签名上传、云端列表预览”这一整条链路讲清楚了。按文档顺序做准备,先把OBS桶和四项配置备齐,再走快速体验,最后按功能检查清单逐项验证,遇到问题按文档的排障思路定位,比直接跳过准备步骤要省时间。后续我打算按案例第4章的思路,从空项目开始自己构建一遍,再回头对照这篇笔记检查遗漏。
- 点赞
- 收藏
- 关注作者
评论(0)