HarmonyOS Developer使用指南-功耗测试
1 范围
1.1 背景及目的
应用软件的功耗严重影响用户使用设备的整机续航体验,为构筑用户良好续航体验,须建立一套应用功耗质量管控体系。
本标准从影响终端设备续航的软硬件资源维度分别制定相应的测试规范,建立统一的应用功耗测试标准,提升应用发布后的体验质量。用于帮助HarmonyOS应用开发、测试人员在发布前开展测试。
1.2 适用范围/测试范围
本标准规定了HarmonyOS应用的功耗标准。
本标准适用于HarmonyOS应用软件的功耗设计、开发及测试。
本标准适用手机、手表、平板等有独立电池的设备。
2 规范性引用文件
无
3 术语、定义和缩略语
3.1 术语、定义
3.1.1 应用功耗
功耗,字面意义上即消耗的能量,对于应用来说,即应用工作时所消耗的电量。
应用工作时所消耗的电量,除了与应用对手机或其他移动设备(以下简称“设备”)上的器件占用情况相关外,还与设备上的器件自身功率相关。
由于设备的复杂性和多样性,以及考虑到设备更新速度,本标准不可能将所有设备一一列举,因此本标准将采取以下两种方式来对应用功耗进行衡量和判断:
- 设置标准设备与标准环境
- 功耗标准去特定设备化本标准将不描述某一应用在“设备”上的功耗衡量和判断标准。
本标准将通过应用对“设备上的器件”的占用频次和时长,来衡量和判断该应用的功耗。
3.1.2 前后台
用来表示应用是否处于设备屏幕的顶层。
- 前台表示应用处于设备屏幕的顶层,用户可以直接看到并进行操作。
- 后台表示应用未处于设备屏幕的顶层,用户无法直接看到,也无法直接操作。
3.1.3 长驻任务
根据后台管理机制,长驻任务是应用或业务模块处于后台(无可见界面)时的一种任务类型。如果是用户发起的可感知业务需要在退后台候继续运行的,如后台播放音乐、导航、上传下载、设备连接、VoIP等,则需使用长驻任务延迟进入挂起(Suspend)状态。
3.1.4 托管任务
托管任务是系统提供的一种后台代理机制。通过系统提供的代理API接口,用户可以把任务交由系统托管,如后台下载、定时提醒、后台非持续定位、后台任务刷新。
3.2 缩略语
无
4 功耗测试标准
4.1 后台任务申请测试标准
4.1.1 应用后台任务申请测试标准为避免不合理的申请后台任务,如一个音乐类应用申请后台导航类任务,此后台任务即为不合理任务。(API9适用)
标准编号 | 4.1.1.1 | 应用后台任务申请测试标准 |
标准描述 | 后台任务使用 ,App 只允许针对原定用途使用后台服务:音频播放、地理位置等 | |
预置条件 | 获取测试应用安装包以及清楚后台任务对应的功能 | |
测试用例 | 1. 自动化扫描上传的应用是否使用长时任务(使用长时任务需要在config.json中声明, config.json可直接扫描得到) 2. 对于使用长时任务应用,必须填写长时任务使用说明 | |
判定标准 | 1.、后台任务使用 App 只允许针对原定用途使用后台服务:音频播放、地理位置等 2、 后台任务可以让用户可以主动开始和停止 3、 后台任务执行期间用户可感知 4、 后台任务对应的功能需在应用市场中应用介绍中明确说明 | |
需考虑的特殊事项 | 无 |
4.1.2 应用后台长驻任务申请测试标准为避免不合理的申请后台长驻任务,如一个音乐类应用申请后台导航类长驻任务,此长驻任务即为不合理任务。
标准编号 | 4.1.2.1 | 应用后台长驻任务申请测试标准 |
标准描述 | 应用申请后台长驻任务模式与应用类型必须匹配 | |
预置条件 | 获取测试应用安装包以及应用对应应用市场的三级分类类型 | |
测试用例 |
| |
判定标准 | 符合匹配表对应关系的通过 | |
需考虑的特殊事项 | 无 |
4.1.3 应用后台托管任务申请测试标准
1、应用在后台执行“用户不可感知且不涉及用户隐私业务”,如后台下载,应用开发者可以通过相应API申请。运行时系统会根据用户场景、设备状态,对不同的任务进行相应的管控。避免影响功耗、性能、隐私。
2、应用在后台执行“用户可感知业务”,如后台非持续定位(non-sustained Location)、定时提醒(Reminder)等,应用开发者可以通过相应API申请。
除非应用申请了后台长驻任务Location模式,后台应用在任何其他情况下访问设备位置信息,都被系统认为使用后台非持续定位能力。如果后台应用需要高频及时获取位置信息,请使用后台长驻任务Location模式,否则使用后台非持续定位。
后台非持续定位限制:按照每30分钟一次的频率提供位置信息给后台应用。
标准编号 | 4.1.3.1 | 应用后台托管任务申请测试标准 |
标准描述 | 应用申请后台托管任务与应用类型必须匹配 | |
预置条件 | 获取测试应用安装包以及应用对应应用市场的三级分类类型 | |
测试用例 |
| |
判定标准 | 符合匹配表对应关系的通过 | |
需考虑的特殊事项 | 无 |
- 表1 申请匹配表
一级分类 | 二级分类 | 三级分类 | 后台长驻任务申请标准 | 后台托管任务申请标准 |
游戏 | 休闲益智 | 休闲 | 无 | 无 |
IO | ||||
益智 | ||||
消除 | ||||
音乐节奏 | ||||
解谜 | ||||
经营策略 | 塔防 | |||
古代谋略 | ||||
现代战略 | ||||
经营 | ||||
养成 | ||||
MOBA | ||||
体育竞技 | 赛车 | |||
篮球 | ||||
运动 | ||||
足球 | ||||
棋牌桌游 | 斗地主 | |||
麻将 | ||||
桌游与棋类 | ||||
纸牌 | ||||
捕鱼 | ||||
动作射击 | 射击 | |||
格斗 | ||||
跑酷 | ||||
打飞机 | ||||
角色扮演 | 多人在线 | |||
卡牌 | ||||
动作 | ||||
冒险 | ||||
回合制 | ||||
生存 | ||||
放置挂机 | ||||
仙侠 | ||||
武侠 | ||||
传奇 | ||||
魔幻 | ||||
应用 | 影音娱乐 | 电视 | audioPlayback |dataTransfer | 无 |
视频 | ||||
音乐 | audioPlayback |audioRecording| dataTransfer | |||
K歌 | ||||
直播 | audioPlayback |dataTransfer | |||
电台 | ||||
实用工具 | 浏览器 | audioPlayback |dataTransfer | 无 | |
输入法 | 无 | 无 | ||
闹钟 | Reminder | |||
工具 | 无 | |||
安全性能 | 无 | |||
WiFi | dataTransfer | 无 | ||
社交通讯 | 聊天 | voip | audioPlayback |dataTransfer | 无 | |
社区 | ||||
通讯 | ||||
婚恋 | ||||
教育 | 翻译 | audioPlayback | 无 | |
英文 | 无 | |||
学习 | Reminder | |||
备考 | Reminder | |||
新闻阅读 | 电子书 | audioPlayback | 无 | |
新闻 | ||||
杂志 | ||||
有声读物 | ||||
动漫 | ||||
幽默 | ||||
体育 | ||||
拍摄美化 | 拍照 | 无 | 无 | |
短视频 | audioPlayback | |||
图像美化 | 无 | |||
影音编辑 | ||||
相册图库 | ||||
美食 | 菜谱 | location| audioPlayback | non-sustained location | |
外卖 | ||||
餐饮 | ||||
生鲜 | ||||
出行导航 | 地图 | location|audioPlayback | non-sustained location Reminder | |
导航 | ||||
交通票务 | ||||
用车 | ||||
公交地铁 | ||||
旅游住宿 | 旅游 | location|audioPlayback | non-sustained location Reminder | |
住宿 | ||||
行程助手 | ||||
购物比价 | 商城 | 无 | Reminder | |
导购 | ||||
团购 | ||||
海淘 | ||||
快递 | ||||
优惠 | ||||
商务 | 办公软件 | 无 | 无 | |
效率 | 无 | Reminder | ||
笔记 | 无 | Reminder | ||
邮箱 | dataTransfer | 无 | ||
招聘 | 无 | 无 | ||
儿童 | 早教 | audioPlayback | 无 | |
儿歌 | 无 | |||
母婴 | Reminder | |||
金融理财 | 银行 | 无 | 无 | |
股票基金 | dataTransfer | Reminder | ||
理财 | Reminder | |||
记账 | 无 | 无 | ||
贷款 | 无 | Reminder | ||
运动健康 | 运动 | location| audioPlayback | non-sustained location Reminder | |
健康 | ||||
养生 | 无 | Reminder | ||
医疗 | ||||
便捷生活 | 家政 | 无 | 无 | |
本地生活 | ||||
租房买房 | ||||
家居装修 | ||||
电影票 | ||||
天气日历 | Reminder | |||
汽车 | 养车 | 无 | 无 | |
违章查询 | ||||
汽车资讯 | ||||
驾考 | ||||
主题个性 | 铃声 | 无 | 无 | |
锁屏 | ||||
壁纸 |
4.2 后台功耗消耗
4.2.1 应用使用后置后台功耗测试标准
标准编号 | 4.2.1.1 | 应用使用后置后台,不引起整机电流增加 |
标准描述 | 应用前台操作后退后台,禁止存在耗电行为 | |
预置条件 | 被测应用安装成功并能正常启动 | |
测试用例 | 测量5分钟灭屏静置耗电流I1,启动被测应用进行操作后退出到后台,再测试5分钟灭屏静置耗电流I2 | |
判定标准 | 1、I2-I1不能高于2mA 2、(I2-I1)/I1绝对值不高于5% | |
需考虑的特殊事项 | 以下类型应用除外: 应用二级分类为:影音娱乐、社交通讯、新闻阅读、美食、出行导航、旅游住宿、儿童 应用三级分类为:浏览器、短视频、邮箱、股票基金、理财、运动、健康、放置挂机 |
4.2.2 应用启动后置后台功耗测试标准
标准编号 | 4.2.2.1 | 应用启动后置后台,不引起整机电流增加 |
标准描述 | 应用启动到前后后直接退后台,禁止存在耗电行为 | |
预置条件 | 被测应用安装成功并能正常启动 | |
测试用例 | 测量5分钟灭屏静置耗电流I1,启动被测应用后直接退后台,再测试5分钟灭屏静置耗电流I2 | |
判定标准 | 1、I2-I1不能高于2mA 2、(I2-I1)/I1绝对值不高于5% | |
需考虑的特殊事项 | 无 |
4.3 资源占用测量标准
4.3.1 后台处理器占用测量标准
标准编号 | 4.3.1.1 | 后台处理器占用测量标准 |
标准描述 | 禁止应用在后台持有后台运行锁 | |
预置条件 | 被测应用安装成功并能正常启动 | |
测试用例 |
| |
判定标准 | 禁止应用在后台长时间持有后台运行锁(BACKGROUND) | |
需考虑的特殊事项 | 以下类型应用除外: 应用二级分类为:影音娱乐、社交通讯、新闻阅读、美食、出行导航、旅游住宿、儿童 应用三级分类为:浏览器、短视频、邮箱、股票基金、理财、运动、健康、放置挂机 |
4.3.2 后台屏幕占用测量标准
标准编号 | 4.3.2.1 | 后台屏幕占用测量标准 |
标准描述 | 禁止应用后台阻止屏幕自动变暗、关闭或在灭屏时点亮屏幕 | |
预置条件 | 被测应用安装成功并能正常启动 | |
测试用例 | 被测应用启动运行5分钟后,放至后台 | |
判定标准 |
| |
需考虑的特殊事项 | 以下类型应用除外: 应用三级分类为:闹钟、学习、备考、效率、笔记、运动、健康 应用二级分类为:购物比价 |
4.3.3 后台音频器件占用测量标准
标准编号 | 4.3.3.1 | 后台音频器件占用测量标准 |
标准描述 | 禁止应用后台使用麦克风或扬声器 | |
预置条件 | 被测应用安装成功并能正常启动 | |
测试用例 | 被测应用启动运行5分钟,放至后台 | |
判定标准 | 禁止此情况下应用使用麦克风或扬声器 | |
需考虑的特殊事项 | 以下类型应用除外: 应用二级分类为:影音娱乐、社交通讯、新闻阅读、美食、出行导航、旅游住宿、儿童、购物比价 应用三级分类为:浏览器、短视频、邮箱、股票基金、理财、运动健康、放置挂机、闹钟、效率、笔记 |
4.3.4 后台摄像头占用测量标准
标准编号 | 4.3.4.1 | 后台摄像头占用测量标准 |
标准描述 | 禁止应用后台使用摄像头或闪光灯 | |
预置条件 | 被测应用安装成功并能正常启动 | |
测试用例 | 被测应用启动运行5分钟,放至后台 | |
判定标准 | 禁止此情况下应用使用摄像头或闪光灯 | |
需考虑的特殊事项 | 无 |
4.3.5 后台定位传感器占用测量标准
标准编号 | 4.3.5.1 | 后台定位传感器占用测量标准 |
标准描述 | 禁止应用后台使用定位传感器 | |
预置条件 | 被测应用安装成功并能正常启动 | |
测试用例 | 被测应用启动运行5分钟,放至后台 | |
判定标准 | 禁止此情况下应用使用定位传感器 | |
需考虑的特殊事项 | 以下类型应用除外: 应用二级分类为:出行导航、旅游住宿、美食 应用三级分类为:运动、健康 |
4.3.6 后台动作传感器占用测量标准
标准编号 | 4.3.6.1 | 后台动作传感器占用测量标准 |
标准描述 | 禁止应用后台使用动作传感器 | |
预置条件 | 被测应用安装成功并能正常启动 | |
测试用例 | 被测应用启动运行5分钟,放至后台 | |
判定标准 | 禁止此情况下应用使用动作传感器 | |
需考虑的特殊事项 | 以下类型应用除外: 应用二级分类为:出行导航、旅游住宿、美食 应用三级分类为:运动、健康 |
4.3.7 分布式调度占用测量标准
标准编号 | 4.3.7.1 | 分布式调度占用测量标准 |
标准描述 | 应用作为发起方远程调用或者拉起其他设备上的应用次数不超过3次 | |
预置条件 | 被测应用安装成功并能正常启动 获取应用注册后台模式 | |
测试用例 | 被测应用启动运行5分钟,放至后台 | |
判定标准 | 远程调用或者拉起其他设备上的应用的次数每小时累计不超过3次 | |
需考虑的特殊事项 | 以下类型应用除外: 应用二级分类为:影音娱乐、实用工具、出行导航 后台模式:有注册后台长驻模式 |
4.3.8 分布式数据同步测量标准
标准编号 | 4.3.8.1 | 分布式数据同步占用测量标准 |
标准描述 | 应用作为发起方将分布式数据同步到远端其他设备次数不超过3次 | |
预置条件 | 被测应用安装成功并能正常启动 | |
测试用例 | 被测应用启动运行5分钟,放至后台 | |
判定标准 | 将分布式数据同步到远端其他设备的次数每小时累计不超过3次 | |
需考虑的特殊事项 | 以下类型应用除外: 应用二级分类为:影音娱乐、实用工具、出行导航 后台模式:有注册后台长驻模式 |
5 修订记录
日期 | 修订内容 |
2021年7月 | 第一次发布 |
2021年8月 | 表1中应用分类类型进行优化与维护 |
2023年3月 | 增加API9标准规则 |