harmony 鸿蒙电源子系统ChangeLog

2022-12-22
浏览 (916)

电源子系统ChangeLog

cl.powermgr.1 API错误信息返回方式变更

下列API使用业务逻辑返回值表示错误信息，不符合OpenHarmony接口错误码规范。从API9进行变更。

耗电统计：@ohos.batteryStatistics
- 屏幕亮度：@ohos.brightness
- 系统电源管理：@ohos.power
- Runninglock锁：@ohos.runningLock
- 热管理：@ohos.thermal

异步接口：通过AsyncCallback或Promise的error对象返回错误信息。

同步接口：通过抛出异常的方式返回错误信息。

变更影响

基于此前版本开发的应用，需适配接口的错误信息返回方式，否则会影响原有业务逻辑。

关键的接口/组件变更

在以下接口增加错误码处理： - getBatteryStats(callback: AsyncCallback): void - getAppPowerValue(uid: number): number - getAppPowerPercent(uid: number): number - getHardwareUnitPowerValue(type: ConsumptionType): number - getHardwareUnitPowerPercent(type: ConsumptionType): number - setValue(value: number): void - shutdown(reason: string): void; - isActive(): boolean - wakeup(detail: string): void - suspend(): void - getPowerMode(): DevicePowerMode - setPowerMode(mode: DevicePowerMode, callback: AsyncCallback<void>): void - setPowerMode(mode: DevicePowerMode): Promise<void> - hold(timeout: number): void - isHolding(): boolean - unhold(): void - isSupported(type: RunningLockType): boolean - isSupported(type: RunningLockType): boolean - create(name: string, type: RunningLockType, callback: AsyncCallback<RunningLock>): void - create(name: string, type: RunningLockType): Promise<RunningLock> - registerThermalLevelCallback(callback: Callback<ThermalLevel>): void - unregisterThermalLevelCallback(callback?: Callback<void>): void - getLevel(): ThermalLevel

适配指导

请参考各接口的API参考。

cl.powermgr.2 系统接口变更

变更影响

基于此前版本开发的应用，需适配新接口名和错误信息返回方式，否则会影响原有业务逻辑。

关键的接口/组件变更

包名	旧接口	新接口
@ohos.power	shutdownDevice(reason: string): void	shutdown(reason: string): void
@ohos.power	rebootDevice(reason: string): void	reboot(reason: string): void
@ohos.power	wakeupDevice(detail: string): void	wakeup(detail: string): void
@ohos.power	suspendDevice(): void	suspend(): void