拼棋派对开发实战系列封面

主App已经有24点、棋类和双人小游戏,再开发元服务时,最值得复用的是规则和经过验证的交互路径。《拼棋派对》先以手机24点建立元服务工程,再扩展双人玩法,处理API差异、包体积、胶囊空间和图标规范。

本篇梳理独立工程的迁移方法。元服务工程位于D盘独立目录,版本1.0.0、API26,仅声明phone;它与主App1.0.19是两套交付。效果采用此前元服务实操归档,本轮没有重新安装元服务或向AGC更新。

本文目录

明确可复用与需重做的边界

规则层的四则运算、象棋合法移动、拼图归位和翻牌比较可以先复用。页面层需要重新判断手机窗口、入口、退出和胶囊占用;桌面快捷键与其他设备专用布局不必原样带入。

层次迁移处理
纯规则和模型先复用,再通过构建与规则检查
手机触摸交互保留可用流程,按元服务空间调整
桌面快捷键本次手机目标不保留专用分支
音效与资源核对支持范围,调整API和编码
签名、图标、分发按独立元服务配置验证

复用不是整文件复制完就结束。主App中成立的导入、资源和系统能力,在新工程可能有不同限制;构建通过也不证明手机胶囊下面的按钮能完整显示。

配置手机元服务入口

AppScope声明bundleType为atomicService,模块设置installationFree,并限定phone。当前元服务配置节选如下:

"bundleType": "atomicService"
"deviceTypes": ["phone"],
"installationFree": true

这些字段说明应用类型和设备范围,不能单独证明云端免安装分发已经通过。独立入口Ability、页面注册、资源引用和签名材料仍需配套。主App的bundle标识和元服务的标识也不能混用。

工程由鸿蒙开发助手的“元服务生成”能力起步,后续已有玩法和基础功能继续复用。插件帮助建立工程和首个流程,迁移后的兼容、资源和UI问题仍需要实际处理,不能把所有代码都描述为插件自动完成。

迁移以后重新检查API

此前迁移中,原App的SoundPool和电脑键盘常量未通过元服务编译检查。手机触控玩法保留,桌面专用快捷键移除,音效改为支持当前元服务场景的AVPlayer方案。

处理API报错时,应先判断是否为该业务必需。删除不需要的桌面分支可以缩小范围;核心能力则需查支持的替代接口。不要通过忽略类型或吞掉异常,让“没有声音但没报错”冒充兼容完成。

资源播放器还要处理初始化、切页、暂停与释放,避免每次点击创建一个没有清理的对象。代表操作需要同时观察触摸、声音和生命周期,不能只检查编译日志。

处理体积和可用高度

此前构建报告入口模块约4056KB,超过当时工具要求的2048KB。项目保留主题和资源标识,按手机显示尺寸重新编码图片为WebP,并把WAV短音效转换为MP3,优化后签名构建通过。

这里的限制是当次工具诊断,不把它泛化为所有版本和所有元服务永久相同的包体规则。后续构建仍需以当前官方规范与实际工具报告为准。

UI问题来自胶囊占用。双人24点迁入后,A区底部按钮被截断;修复时重新计算可用高度,在必要时把四张牌排成一行,保留上下座位和48vp操作按钮。成语页也调整了棋盘与底部工具区,避免最后一排重叠。

与第20篇主App双屏问题相同,这类缺口应优先调整区域预算,不以缩小全部文字解决。元服务的手机布局也不能直接复用电脑窗口参数。

平台工具生成规范图标

元服务图标必须使用平台提供的Image Asset元服务图标生成工具。工程图标按512×512生成,AGC上传图采用工具对应输出,不能把216×216上传素材直接当作工程入口图标。

AppScope的icon、module中Ability的icon和startWindowIcon需要指向规范工程资源。尺寸正确仍不够,外圈和内部图形也要满足平台规范;只把旧图缩放到512并不等于通过工具生成。

此前已经遇到平台反馈图标尺寸和环形样式不符合要求,随后重新使用Image Asset生成、替换引用、构建验签并在手机模拟器确认菜单效果。这个经历说明图标需要检查最近任务、入口和启动画面,而不只看桌面预览。

效果与交付范围

下面是已归档的手机元服务双人24点操作,包含合并、得到24、提交计分和换题:

历史手机元服务双人24点计算、提交与自动换题

扩展版还保留多种双人玩法,双人象棋已有选兵、落子、换手和悔棋记录。它不是只有24点,但每个入口的可用性仍需按元服务目标分别验证,不能用一个代表玩法证明所有模式都通过。

当前归档说明覆盖手机模拟器页面与代表玩法、签名APP和独立HAP,以及Image Asset工程图标核验。云端免安装分发与实体手机体验属于后续发布验收范围。本轮文章复用这些已有证据,没有执行新一轮元服务上架。

源码入口是独立元服务工程的AppScope、module、Ability和玩法组件;主App规则作为复用来源。参考元服务图标生成指南与鸿蒙开发助手指南。最后一篇把构建、包核验和设备证据连成完整交付检查。

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐