鸿蒙应用与元服务上架质量测试白皮书V1.0-华为

微信扫码，打开到小程序

第 0 页 共 51 页 版权所有 © 华为终端有限公司 2025。 保留一切权利。 本材料所载内容受著作权法的保护，著作权由华为公司或其许可人拥有，但注明引用其他方 的内容除外。未经华为公司或其许可人事先书面许可，任何人不得将本材料中的任何内容以 任何方式进行复制、经销、翻印、播放、以超级链路连接或传送、存储于信息检索系统或者 其他任何商业目的的使用。 商标声明 以上为华为公司的商标（非详尽清单），未经华为公司书面事先明示许可，任何第三方不得 以任何形式使用。 注意 华为会不定期对本文档的内容进行更新。 本文档仅作为使用指导，文档中的所有陈述、信息和建议不构成任何明示或暗示的担保。 华为终端有限公司 广东省东莞市松山湖园区新城路 2 号 https://consumer.huawei.com 目录 1 前言 .......................................................................................... - 1 - 2 鸿蒙应用上架质量审核流程 ........................................................ - 2 - 3 鸿蒙应用上架质量测试标准 ........................................................ - 3 - 3.1 功能质量测试 ...................................................................... - 3 - 3.1.1 功能完备度测试 .......................................................... - 3 - 3.1.2 功能体验测试.............................................................- 4 - 3.1.3 应用全场景测试 ......................................................... - 5 - 3.2 体验专项质量测试 ............................................................... - 6 - 3.2.1 兼容性体验 ................................................................ - 6 - 3.2.2 UX 体验 ....................................................................- 8 - 3.2.3 稳定性体验 ............................................................. - 11 - 3.2.4 功耗体验 ................................................................. - 11 - 3.2.5 性能体验 ................................................................. - 12 - 3.2.6 安全体验 ................................................................. - 13 - 3.3 鸿蒙特性质量测试 ............................................................. - 17 - 3.3.1 鸿蒙生态规则测试 .................................................... - 17 - 3.3.2 鸿蒙创新特性测试 ................................................... - 18 - 4 鸿蒙应用上架质量测试能力介绍 .............................................. - 23 - 4.1 开发者自测试能力介绍 ...................................................... - 23 - 4.1.1 单元测试能力介绍 ................................................... - 23 - 4.1.2 集成测试能力介绍 .................................................... - 27 - 4.1.3 众测能力介绍 ......................................................... - 30 - 4.2 应用上架预检能力介绍 ..................................................... - 33 - 4.3 应用上架测试报告说明 ..................................................... - 39 - 4.3.1 应用上架测试报告 ................................................... - 39 - 4.3.2 应用上架测试 FAQ .................................................. - 41 - 附录： ....................................................................................... - 47 - - 1 - 1 前言 在万物互联的智能化浪潮中，鸿蒙操作系统正在以其独特的分布式架构、 无缝协同体验和全场景智慧能力，构建一个连接万物、智能协同的生态体系。 鸿蒙应用,元服务作为用户与鸿蒙生态设备交互的载体，其质量与体验效 果直接影响用户对鸿蒙生态的态度进而影响开发者在鸿蒙生态的长期发展。 从生态视角看，功能完整、运行流畅、安全可靠的应用能够增强用户粘性， 提升生态整体价值；反之，质量低下、体验不佳的应用会损害用户信任，引发 用户流失，最终阻碍生态的健康发展。 从开发者视角看，投身鸿蒙生态意味着拥抱新的机遇与广阔的用户市场， 而应用质量是实现这一目标的重要基础。如果应用在功能、性能或体验上未 达到用户预期，可能导致用户反馈不佳、留存率下降，进而影响开发者在生态 中的长期发展与品牌积累。 因此，保障应用质量不仅是生态健康发展的共同责任，也是每一位开发者 在鸿蒙生态中实现价值、赢得用户信任的坚实基础。 应用上架是开发者将应用交付给用户的关键，应用上架前的质量测试就承 担着守护应用最终品质的重要职责，需要制定清晰的技术标准，以满足合规 要求和牵引生态导向，并建设对应的高效测试工程与工具系统，进而提供测 试能力给开发者，以提升其测试效率，最终提升应用质量。 - 2 - 发布《鸿蒙应用与元服务上架质量测试白皮书》目的： 1、阐述 HarmonyOS 生态全生命周期的测试流程与测试工程能力，伙伴 可在应用各个研发阶段选用不同的测试工具和能力，提早发现问题，降低应 用研发成本。 2、系统性说明鸿蒙应用上架测试的标准体系、测试点、测试方法等，提 供客观、一致的测试标准，维护生态的规范性与一致性。 3、通过持续分析应用上架测试与用户声音，为伙伴提供常见问题分析与 解决方案，与伙伴携手共建高质量的鸿蒙应用生态，为用户提供卓越的智慧 体验，推动鸿蒙生态持续健康发展。 2 鸿蒙应用上架质量审核流程 当前鸿蒙生态发展迅速，鸿蒙生态上架应用的用户体验尤为重要。需要 构建一套鸿蒙应用上架前质量保障的流程，协助开发者改善其应用质量，牵 引开发者打造极致的用户体验。 在鸿蒙生态中，需要对应用进行质量测试以供 AppGallery 上架参考。 - 3 - 3 鸿蒙应用上架质量测试标准 鸿蒙应用上架质量测试标准的制定，是基于鸿蒙系统六大核心用户体验： 精致、易用、流畅、协同、安全、智能，突出功能质量，体验专项质量，鸿蒙 特性质量三个方面，旨在帮助开发者打造出，不仅能满足功能需求，更能超越 用户期待，真正融入鸿蒙万物互联世界的精品应用。 3.1 功能质量测试 3.1.1 功能完备度测试 大量应用都是多 OS 系统（鸿蒙，安卓，iOS）齐发，如果不同系统上的 同一个应用功能存在缺失，会对用户的日常使用带来困扰和不便。对于这类 应用需要采用功能完备度来度量应用功能在鸿蒙系统上开发的完备程度，并 帮助开发者发现适配问题，协助开发者提升应用质量，促进鸿蒙生态高质量 发展，改善用户体验。 - 4 - 当前功能完备度优先参考同一应用的安卓版本（安卓版本不支持的应用 参考 iOS 版本）输出对应功能清单，并基于功能清单对鸿蒙应用进行功能 比对： 1) 功能清单输出： 根据非鸿蒙系统版本的应用页面展示，按照一级、 二级、三级......遍历应 用各层页面以及对应的功能点，输出对应的功能清单。 2) 鸿蒙应用功能清单对比测试： 依据应用功能完备度清单，逐个对比鸿蒙版本应用功能点，按完备度清单 的模块路径在应用上找到对应的功能点验证功能，并输出测试结果。 3.1.2 功能体验测试 3.1.2.1 垂域应用功能体验测试 截止 2025 年鸿蒙应用有 26 个应用垂域，基于垂域分别输出其 KEP(Key Experience Path/关键体验路径)&KEI(Key Experience Index/关键体验 指标)，用于指导同品类应用的功能体验测试。 3.1.2.2 数据继承测试 对于鸿蒙应用升级后，应用在老版本内产生的数据需要在新版本应用内继 承，具体数据范围包含以下： 1、云端数据：用户的收藏、发布、关注、购物车、订单、会员权益、数 - 5 - 字资产、订阅信息等云端数据。 2、本地数据：聊天信息、剪辑作品及草稿、输入法词库、离线地图和导 航包等。 3.1.3 应用全场景测试 随着终端设备形态日益多样化，分布式技术逐渐打破单一硬件边界，一个 应用或元服务可以在不同的硬件设备之间方便流转、互助共享，让用户享受 无缝的全场景体验。而作为应用开发者，广泛的设备类型也能为应用带来广 大的潜在用户群体。但是如果一个应用需要在多个设备上提供同样的内容， 则需要适配不同的屏幕尺寸和硬件，开发成本较高。HarmonyOS 系统面向 多终端提供了“一次开发，多端部署”的能力，让开发者可以基于一种设计， 高效构建多端可运行的应用。因此在鸿蒙应用的质量体验不仅涉及全场景中 独有产品形态应用，还需要覆盖“一多”的应用。 质量标准库基于通用质量和设备形态专项质量分别组建，根据开发者对应 用支持产品形态的设计，关联对应的测试质量标准项，用于指导应用质量测 试活动的开展。 - 6 - 3.2 体验专项质量测试 为确保鸿蒙应用在全场景、多设备环境下能够持续提供高品质的一致体验， 围绕兼容性、UX 体验、稳定性、功耗、性能及安全六大核心维度，构建了专 项测试标准。致力在应用上架前全面识别并帮助开发者，发现关键质量风险， 协助开发者进行应用体验优化，从而提升产品竞争力与用户满意度。其中， “必须”是应用上架要求的遵从项，“推荐”是应用上架要求的建议项。 3.2.1 兼容性体验 应用的基础功能兼容性，一般是指某个应用能稳定地工作在操作系统之上， 而不会出现意外退出等问题。鸿蒙应用需要兼容不同 OS 版本、不同设备形 态，以及保证应用升级场景工作正常。除此之外，应用基础功能包括通用的应 用规格、配置文件、卡片信息等基础包体结构要求。 领域 场景与分类 说明 规则 应用形态 基础兼容 性 OS 兼容 应用安装无兼容性问题 必须 鸿蒙应用, 鸿蒙元服务 应用启动无兼容性问题 必须 鸿蒙应用, 鸿蒙元服务 - 7 - 应用运行无兼容性问题 必须 鸿蒙应用, 鸿蒙元服务 应用卸载无残留 必须 鸿蒙应用, 鸿蒙元服务 应用的卡片运行无兼容性问题 推荐 鸿蒙应用, 鸿蒙元服务 升级兼容 应用升级后类型不可变更 必须 鸿蒙应用, 鸿蒙元服务 应用升级后历史数据要继承 推荐 鸿蒙应用, 鸿蒙元服务 应用升级无兼容性问题 必须 鸿蒙应用, 鸿蒙元服务 应用升级后原有卡片无兼容性问题 必须 鸿蒙应用, 鸿蒙元服务 设备兼容 应用在设备多窗口模式下无兼容性问题 推荐 鸿蒙应用, 鸿蒙元服务 应用在折叠屏状态切换时无兼容性问题 必须 鸿蒙应用, 鸿蒙元服务 应用在折叠屏横竖屏切换时无兼容性问题 必须 鸿蒙应用, 鸿蒙元服务 应用在折叠屏支架态切换时无兼容性问题 必须 鸿蒙应用, 鸿蒙元服务 应用中键盘快捷键操作应满足标准定义且不与 系统定义冲突 必须 鸿蒙应用, 鸿蒙元服务 应用中鼠标操作对应功能能正常响应 必须 鸿蒙应用, 鸿蒙元服务 应用中的走焦事件能够响应 Tab 键或方向键 切换 必须 鸿蒙应用, 鸿蒙元服务 应用在不同窗口布局变化下功能能正常响应 必须 鸿蒙应用, 鸿蒙元服务 系统特性 与功能 通用规格 应用包结构应符合规范 必须 鸿蒙应用, 鸿蒙元服务 应用所有 Hap 配置文件中 bundleName、 versionCode 一致 必须 鸿蒙应用, 鸿蒙元服务 应用需配置其支持运行的系统版本信息 必须 鸿蒙应用, 鸿蒙元服务 应用 bundleName 不可缺省 必须 鸿蒙应用, 鸿蒙元服务 应用权限清单必须指定 必须 鸿蒙应用, 鸿蒙元服务 - 8 - 应用明确支持设备类型 必须 鸿蒙应用, 鸿蒙元服务 应用必须有图标 必须 鸿蒙应用, 鸿蒙元服务 应用要支持 64 位 so 文件 必须 鸿蒙应用 元服务不使用 so 文件 推荐 鸿蒙元服务 应用的显示名称有意义 推荐 鸿蒙应用, 鸿蒙元服务 应用规格 应用仅支持非免安装 必须 鸿蒙应用 元服务规格 元服务仅支持免安装 必须 鸿蒙元服务 元服务预加载对应模块类型不能为 entry 必须 鸿蒙元服务 元服务无诱导跳转或支付 推荐 鸿蒙元服务 卡片规格 卡片配置应符合规范 必须 鸿蒙应用, 鸿蒙元服务 卡片支持尺寸规格应符合规范 必须 鸿蒙应用, 鸿蒙元服务 卡片默认尺寸规格应符合规范 必须 鸿蒙应用, 鸿蒙元服务 卡片 isDefault 字段不可缺省 必须 鸿蒙应用, 鸿蒙元服务 卡片刷新方式应符合规范 必须 鸿蒙应用, 鸿蒙元服务 卡片描述以索引展现 推荐 鸿蒙应用, 鸿蒙元服务 应用升级后所带卡片名称不建议更改 推荐 鸿蒙应用, 鸿蒙元服务 应用升级后所带卡片尺寸不建议更改 推荐 鸿蒙应用, 鸿蒙元服务 功能体验规 格 应用应保证功能完整性，并且与上架功能描述 一致 推荐 鸿蒙应用, 鸿蒙元服务 音频规格 应用静音播放场景体验规范 必须 鸿蒙应用, 鸿蒙元服务 应用短音、瞬态音播放场景体验规范 必须 鸿蒙应用, 鸿蒙元服务 3.2.2 UX 体验 UX 基础体验建议从影响用户体验的各个维度定义了相应的 UX 质量要 求，以保证应用良好的交互体验。 - 9 - 领域 场景与分类 说明 规则 应用形态 通用应用 UX 体验 标准 基础体验 所有界面响应系统返回操作，全屏界面提供返 回/关闭/取消按钮 推荐 鸿蒙应用, 鸿蒙元服务 应用支持在不同屏幕尺寸的设备上良好显示 必须 鸿蒙应用, 鸿蒙元服务 界面布局适配摄像头的挖孔区域 必须 鸿蒙应用, 鸿蒙元服务 元素排布对齐 推荐 鸿蒙应用, 鸿蒙元服务 中西文排版对齐 推荐 鸿蒙应用, 鸿蒙元服务 卡片/控件背景明度层级合理 推荐 鸿蒙应用, 鸿蒙元服务 平面层级合理 推荐 鸿蒙应用, 鸿蒙元服务 应用自定义手势与系统手势无冲突 必须 鸿蒙应用, 鸿蒙元服务 应用使用的典型手势时长合理 推荐 鸿蒙应用, 鸿蒙元服务 点击热区不得小于 40vp×40vp 必须 鸿蒙应用, 鸿蒙元服务 应用使用的色彩满足最小对比度要求 必须 鸿蒙应用, 鸿蒙元服务 应用的文字大小满足最小字号要求 必须 鸿蒙应用, 鸿蒙元服务 应用图标具备前景图层和背景图层，图标尺寸 与可见区域尺寸满足要求 必须 鸿蒙应用 应用的界面图标大小满足最小尺寸要求 必须 鸿蒙应用, 鸿蒙元服务 应用的图标满足清晰度要求 必须 鸿蒙应用, 鸿蒙元服务 文字满足粗细要求 推荐 鸿蒙应用, 鸿蒙元服务 控件内层级数-文字&图标大小数量合理 推荐 鸿蒙应用, 鸿蒙元服务 手机、平板（非 PC 模式）类设备层级页面间 切换应使用左右平移转场动效 推荐 鸿蒙应用, 鸿蒙元服务 存在转场动效过渡检查 推荐 鸿蒙应用, 鸿蒙元服务 全屏页面的转场动效时长满足要求 推荐 鸿蒙应用, 鸿蒙元服务 - 10 - 应用启动页填充满足要求 推荐 鸿蒙应用 应用启动页动效时长满足要求 推荐 鸿蒙应用 界面滑动到边界位置存在反馈动效 推荐 鸿蒙应用, 鸿蒙元服务 离手减速动效一致性检查 推荐 鸿蒙应用, 鸿蒙元服务 光标清晰 推荐 鸿蒙应用, 鸿蒙元服务 系统特性 界面布局适配底部导航条 必须 鸿蒙应用, 鸿蒙元服务 应用通知设计需遵循通知规范 推荐 鸿蒙应用, 鸿蒙元服务 应用适配深色模式显示，深色模式下显示正常 必须 鸿蒙应用, 鸿蒙元服务 应用需要对状态栏进行