• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 事件通知子系统ChangeLog
2
3## cl.notification.1 API异常处理方式变更
4
5事件通知部分接口使用业务逻辑返回值表示错误信息,不符合OpenHarmony接口错误码规范。
6
7**变更影响**
8
9基于此前版本开发的应用,需适配变更接口的错误信息返回方式,否则会影响原有业务逻辑。
10
11**关键接口/组件变更**
12
13为适配统一的API异常处理方式,对事件通知相关接口进行废弃(下表中 原接口 列内容),并新增对应接口(下表中 新接口 列内容)。新增接口支持统一的错误码异常处理规范,功能上与原接口保持一致。
14
15| 原接口                  | 新接口                           |
16| ----------------------- | -------------------------------- |
17| @ohos.commonEvent.d.ts  | @ohos.commonEventManager.d.ts    |
18| @ohos.notification.d.ts | @ohos.notificationManager.d.ts   |
19| @ohos.notification.d.ts | @ohos.notificationSubscribe.d.ts |
20
21**适配指导**
22
23如上所述,仅将老接口平移到了新的namespace中,所以可以通过修改import来解决适配问题:
24
25如原先接口使用了@ohos.commonEvent
26
27```js
28import commonEvent from '@ohos.commonEvent';
29```
30
31可以通过直接修改import,来切换到新的namespace上:
32
33```js
34import commonEvent from '@ohos.commonEventManager';
35```
36
37@ohos.notification拆分成了两个namespace,需要根据接口情况选择需要的新namespace进行适配。
38
39此外还需要适配异常处理,具体参考新接口的接口文档。
40
41## cl.notification.2 接口变更
42
43对事件通知部分接口名进行了变更。
44
45**关键的接口/组件变更**
46
47| 模块名                    | 类名                | 方法/属性/枚举/常量                                          | 变更类型 |
48| ------------------------- | ------------------- | ------------------------------------------------------------ | -------- |
49| @ohos.notification        | notification        | **function** enableNotification(bundle: BundleOption, enable: boolean, callback: AsyncCallback<**void**>): **void**; | 废弃     |
50| @ohos.notification        | notification        | **function** enableNotification(bundle: BundleOption, enable: boolean): Promise<**void**>; | 废弃     |
51| @ohos.notificationManager | notificationManager | **function** setNotificationEnable(bundle: BundleOption, enable: boolean, callback: AsyncCallback<**void**>): **void**; | 新增     |
52| @ohos.notificationManager | notificationManager | **function** setNotificationEnable(bundle: BundleOption, enable: boolean): Promise<**void**>; | 新增     |
53| @ohos.notification        | notification        | **function** enableNotificationSlot(bundle: BundleOption, **type**: SlotType, enable: boolean, callback: AsyncCallback<**void**>): **void**; | 废弃     |
54| @ohos.notification        | notification        | **function** enableNotificationSlot(bundle: BundleOption, **type**: SlotType, enable: boolean): Promise<**void**>; | 废弃     |
55| @ohos.notificationManager | notificationManager | **function** setNotificationEnableSlot(bundle: BundleOption, **type**: SlotType, enable: boolean, callback: AsyncCallback<**void**>): **void**; | 新增     |
56| @ohos.notificationManager | notificationManager | **function** setNotificationEnableSlot(bundle: BundleOption, **type**: SlotType, enable: boolean): Promise<**void**>; | 新增     |
57| @ohos.notification        | notification        | **function** enableDistributed(enable: boolean, callback: AsyncCallback<**void**>): **void**; | 废弃     |
58| @ohos.notification        | notification        | **function** enableDistributed(enable: boolean, callback: AsyncCallback<**void**>): **void**; | 废弃     |
59| @ohos.notificationManager | notificationManager | **function** setDistributedEnable(enable: boolean, callback: AsyncCallback<**void**>): **void**; | 新增     |
60| @ohos.notificationManager | notificationManager | **function** setDistributedEnable(enable: boolean): Promise<**void**>; | 新增     |
61| @ohos.notification        | notification        | **function** enableDistributedByBundle(bundle: BundleOption, enable: boolean, callback: AsyncCallback<**void**>): **void**; | 废弃     |
62| @ohos.notification        | notification        | **function** enableDistributedByBundle(bundle: BundleOption, enable: boolean): Promise<**void**>; | 废弃     |
63| @ohos.notificationManager | notificationManager | **function** setDistributedEnableByBundle(bundle: BundleOption, enable: boolean, callback: AsyncCallback<**void**>): **void**; | 新增     |
64| @ohos.notificationManager | notificationManager | **function** setDistributedEnableByBundle(bundle: BundleOption, enable: boolean): Promise<**void**>; | 新增     |