《HarmonyOS技术精讲-Basic Services Kit》电源管理：获取设备状态与省电策略
前言
HarmonyOS NEXT 开发里，powerManager这个 API 经常被误用。很多人第一次接触电源管理能力时，会发现官方示例能运行，但实际项目里并不稳定。核心问题不在于 API 调用本身，而在于监听取消时机、运行锁释放、状态刷新三个环节的配合。
这篇文章只解决一个具体问题：实现一个电池状态组件，能实时显示电量百分比，监听充电状态变化，并提供屏幕常亮申请开关。不带任何花哨的动画或复杂交互，但每个细节都会说明为什么这样处理。
它解决什么问题
电源管理能力主要解决三类场景：
- 显示电池状态：电量百分比、是否在充电、充电类型
- 控制屏幕状态：常亮申请、唤醒锁管理
- 功耗优化：根据电量状态调整应用行为
这些能力都集中在@ohos.powerset.d.ts和@ohos.powerset.battery.d.ts两个模块里。
同类方案对比：
| 能力 | powerManager | 直接查系统属性 | 推荐原因 |
|---|---|---|---|
| 电池信息 | 提供完整 API | 不支持实时监听 | 带事件回调 |
| 运行锁 | 标准接口 | 无 | 统一管理 |
| 状态监听 | 支持 | 需要轮询 | 节省资源 |
适用场景：视频播放器、地图导航、游戏引擎、K线图监控等需要常亮或关注电量的应用。
不适用场景：纯文本阅读器、不需要特殊电源处理的简单工具类应用。
环境说明
DevEco Studio 版本：DevEco Studio 6.1.0 及以上 HarmonyOS SDK 版本：HarmonyOS 6.1.0(23) 及以上 目标设备：手机/平板核心实现
第一步：权限声明
在module.json5中添加以下权限：
{"module":{"requestPermissions":[{"name":"ohos.permission.POWER_MANAGER","reason":"用于获取设备电源状态"},{"name":"ohos.permission.KEEP_BACKGROUND_RUNNING","reason":"用于保持屏幕常亮"}]}}这里需要说明：POWER_MANAGER权限属于 system_grant，应用安装时自动授予。但KEEP_BACKGROUND_RUNNING属于 user_grant，需要用户手动授权。如果只获取电量信息，不需要申请后台常亮权限。
第二步：实现电池状态组件
创建BatteryStatusView.ets文件：
import{power}from'@kit.BasicServicesKit';import{RunningLock,runningLockasrunningLockManager}from'@kit.BasicServicesKit';@Entry@Componentstruct BatteryStatusView{@StatebatteryLevel:number=0;@StateisCharging:boolean=false;@StatekeepScreenOn:boolean=false;privatebatterySub:number=-1;privaterunningLock:RunningLock|null=null;aboutToAppear(){this.initBatteryInfo();this.registerBatteryEvent();}aboutToDisappear(){this.unregisterBatteryEvent();this.releaseRunningLock();}asyncinitBatteryInfo(){try{// 获取当前电池信息constbatteryInfo=power.getBatteryInfoSync();this.batteryLevel=batteryInfo.batteryLevel;this.isCharging=batteryInfo.isCharging;console.info(`Battery Status: level=${this.batteryLevel}, charging=${this.isCharging}`);}catch(err){console.error(`Failed to get battery info:${JSON.stringify(err)}`);}}registerBatteryEvent(){try{// 注册电池状态变化监听this.batterySub=power.on('batteryStatusChange',(data:power.BatteryInfo)=>{this.batteryLevel=data.batteryLevel;this.isCharging=data.isCharging;console.info(`Battery status changed: level=${this.batteryLevel}, charging=${this.isCharging}`);});}catch(err){console.error(`Failed to register battery event:${JSON.stringify(err)}`);}}unregisterBatteryEvent(){if(this.batterySub!==-1){try{power.off('batteryStatusChange',this.batterySub);this.batterySub=-1;}catch(err){console.error(`Failed to unregister battery event:${JSON.stringify(err)}`);}}}asyncrequestRunningLock(){if(this.runningLock){return;// 已持有锁}try{this.runningLock=awaitrunningLockManager.createRunningLock('ScreenOnLock',runningLockManager.RunningLockType.SCREEN_ON);this.runningLock.hold(3600000);// 最多锁定1小时console.info('Running lock acquired');}catch(err){console.error(`Failed to request running lock:${JSON.stringify(err)}`);}}releaseRunningLock(){if(this.runningLock){try{this.runningLock.unhold();this.runningLock=null;console.info('Running lock released');}catch(err){console.error(`Failed to release running lock:${JSON.stringify(err)}`);}}}toggleScreenOn(){this.keepScreenOn=!this.keepScreenOn;if(this.keepScreenOn){this.requestRunningLock();}else{this.releaseRunningLock();}}build(){Column({space:16}){Text('电池状态').fontSize(20).fontWeight(FontWeight.Bold).margin({bottom:10})// 电量显示Row(){Text('电量：').fontSize(16)Text(`${this.batteryLevel}%`).fontSize(24).fontWeight(FontWeight.Medium).fontColor(this.batteryLevel>20?Color.Green:Color.Red)}// 充电状态Row(){Text('充电状态：').fontSize(16)Text(this.isCharging?'充电中':'未充电').fontSize(16).fontColor(this.isCharging?Color.Green:Color.Gray)}Divider()// 常亮开关Row(){Text('屏幕常亮').fontSize(16)Toggle({type:ToggleType.Switch,isOn:this.keepScreenOn}).onChange((isOn:boolean)=>{this.toggleScreenOn();}).width(50)}Text('注意：开启常亮会显著增加功耗').fontSize(12).fontColor(Color.Gray).width('100%').textAlign(TextAlign.Start)}.width('100%').padding(16).backgroundColor(Color.White).borderRadius(8)}}这段代码的核心逻辑：
- aboutToAppear中初始化电池信息并注册监听
- aboutToDisappear中必须取消监听和释放运行锁
- getBatteryInfoSync是同步方法，直接返回当前状态
- power.on注册的回调在电池状态变化时触发，自动更新 UI
- runningLock的持有时长设置建议不超过1小时，避免系统强行回收
这里的一个设计选择：使用getBatteryInfoSync而非异步版本。实际使用中发现同步方法在主线程调用没有问题，因为 ArkUI 已经做了线程隔离，同步方法返回速度极快（毫秒级）。而异步版本反而需要额外的 then 处理，代码复杂度增加。
第三步：使用组件
在主页中引入：
@Entry@Componentstruct Index{build(){Column(){BatteryStatusView()}.width('100%').height('100%').justifyContent(FlexAlign.Center)}}常见问题
问题1：页面返回后监听仍然存在
现象：离开页面再次进入，电池状态不再更新。
原因：在aboutToDisappear中调用了power.off，但传入的回调引用不一致。power.on注册时使用的匿名函数与power.off时传入的 ID 不对应。
解决方案：使用返回的订阅 ID 取消监听，如上述代码所示。另外需要确保每次离开页面都正确取消。
问题2：运行锁申请后无效
现象：调用了runningLock.hold，但屏幕仍然休眠。
原因：SCREEN_ON类型的运行锁只能延缓休眠，不能完全阻止。设备在长时间无操作后，系统仍有可能进入休眠状态。另外，如果 had 时长设置过大（如 9999999），系统会直接返回错误。
解决方案：设置合理时长，不要超过RunningLock.MAX_HOLD_DURATION的限制。同时考虑使用BRIGHT_ON类型获得更好的效果。
问题3：电量监听在模拟器不触发
现象：真机测试正常，模拟器上batteryStatusChange事件不触发。
原因：模拟器对电源设备模拟不完整，部分硬件事件无法传递。特别是充电器热插拔事件。
解决方案：在模拟器上通过 DevEco Studio 的调试面板手动模拟电池状态变化。正式测试必须使用真机。
最佳实践
不要在 build() 中频繁调用 getBatteryInfoSync。虽然该方法执行很快，但每次构建都会创建新对象，增加 ArkUI 的脏标记检测负担。推荐在 aboutToAppear 中一次获取，后续通过监听更新。
取消监听必须在 aboutToDisappear 中做。很多开发者只注册不取消，导致页面销毁后仍有回调执行，引发“组件已销毁但状态还在更新”的警告。这个警告在 Release 模式下虽然不会崩溃，但会导致内存泄漏。
runningLock 释放后必须置 null。如果不置 null，再次申请时会因为对象引用还在而绕过创建逻辑，导致无法重新获取锁。
异步回调里不要直接修改 UI。
power.on的回调本身就在主线程，所以直接修改@State没有问题。但如果回调来自其他线程，需要使用runOnMainThread或通过 EventHub 桥接。
Demo 入口
// AppScope/entry/src/main/ets/pages/Index.ets@Entry@Componentstruct Index{build(){Column(){BatteryStatusView()}.width('100%').height('100%')}}FAQ
Q：为什么真机正常，模拟器不生效？
A：模拟器对电源设备模拟不完整，batteryStatusChange事件无法通过模拟器触发。建议使用真机开发测试。
Q：为什么页面返回后状态丢失？
A：检查aboutToDisappear中是否调用了power.off。如果使用过程中手动移动了监听代码，可能导致订阅 ID 与取消 ID 不对应。
Q：为什么第一次授权成功，第二次又要求授权？
A：KEEP_BACKGROUND_RUNNING权限在应用卸载重装后需要重新授权。建议在aboutToAppear中检查权限状态。
Q：runningLock 申请失败怎么办？
A：检查是否在回调中申请锁。createRunningLock是异步方法，必须在 Promise 回调中处理。同时确认设备电源管理服务是否正常。
