!12919 新增删除废弃API9接口的changelog

Merge pull request !12919 from yangzk/master

zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.1/changelogs-ability.md

@@ -44,4 +44,97 @@ onWindowStageCreate() {
         console.error('Failed to start ability', err.code);
     })
 }
-```
\ No newline at end of file
+```
+
+
+
+## cl.ability.2 删除标记为废弃的API9接口
+
+[元能力异常处理整改](../OpenHarmony_3.2.8.3/changelogs-ability.md)将部分API9接口标记为了废弃，根据OpenHarmony接口规范，需要删除标记为废弃的API9接口。
+
+**变更影响**
+
+基于此前版本开发的应用，需要将被删除的接口替换为新接口，否则会影响应用编译。
+
+**关键接口/组件变更**
+
+接口文件被删除：
+
+| 被删除接口                                      | 新接口                                          |
+| ----------------------------------------------- | ----------------------------------------------- |
+| @ohos.application.Ability.d.ts                  | @ohos.app.ability.UIAbility.d.ts                |
+| @ohos.application.AbilityConstant.d.ts          | @ohos.app.ability.AbilityConstant.d.ts          |
+| @ohos.application.AbilityLifecycleCallback.d.ts | @ohos.app.ability.AbilityLifecycleCallback.d.ts |
+| @ohos.application.AbilityStage.d.ts             | @ohos.app.ability.AbilityStage.d.ts             |
+| @ohos.application.EnvironmentCallback.d.ts      | @ohos.app.ability.EnvironmentCallback.d.ts      |
+| @ohos.application.ExtensionAbility.d.ts         | @ohos.app.ability.ExtensionAbility.d.ts         |
+| @ohos.application.FormExtension.d.ts            | @ohos.app.form.FormExtensionAbility.d.ts        |
+| @ohos.application.ServiceExtensionAbility.d.ts  | @ohos.app.ability.ServiceExtensionAbility.d.ts  |
+| @ohos.application.StartOptions.d.ts             | @ohos.app.ability.StartOptions.d.ts             |
+| @ohos.application.context.d.ts                  | @ohos.app.ability.common.d.ts                   |
+| @ohos.application.errorManager.d.ts             | @ohos.app.ability.errorManager.d.ts             |
+
+接口、属性被删除：
+
+- @ohos.application.Configuration.d.ts
+  - Configuration 的 direction、screenDensity、displayId、hasPointerDevice 被删除。可以使用 @ohos.app.ability.Configuration.d.ts 的 Configuration替换。
+- @ohos.application.ConfigurationConstant.d.ts
+  - 枚举 Direction 和 ScreenDensity 被删除。可以使用 @ohos.app.ability.ConfigurationConstant.d.ts 的枚举 Direction 和 ScreenDensity 替换。
+- @ohos.application.abilityManager.d.ts
+  - 方法 getExtensionRunningInfos 和 getTopAbility 被删除。可以使用 @ohos.app.ability.abilityManager.d.ts 的同名方法替换。
+- @ohos.application.appManager.d.ts
+  - 枚举 ApplicationState 和 ProcessState 被删除。可以使用 @ohos.app.ability.appManager.d.ts 的枚举 ApplicationState 和 ProcessState 替换。
+  - 方法 registerApplicationStateObserver 和 getProcessRunningInformation被删除。可以使用 @ohos.app.ability.appManager.d.ts 的同名方法替换。
+- @ohos.application.formHost.d.ts
+  - 方法 shareForm 和 notifyFormsPrivacyProtected 被删除。可以使用 @ohos.app.form.formHost.d.ts 的同名方法替换。
+- @ohos.application.formInfo.d.ts
+  - 枚举 FormType 的 eTS 被删除，可以使用 @ohos.app.form.formInfo.d.ts 的 FormType 中的 eTS 替换。
+  - 枚举 FormParam 的 IDENTITY_KEY、BUNDLE_NAME_KEY、ABILITY_NAME_KEY、DEVICE_ID_KEY 被删除，可以使用  @ohos.app.form.formInfo.d.ts 的 FormParam 中的同名枚举替换。
+  - 接口 FormInfoFilter 被删除。可以使用 @ohos.app.form.formInfo.d.ts 的 FormInfoFilter 替换。
+  - 枚举 FormDimension 被删除。可以使用 @ohos.app.form.formInfo.d.ts 的 FormDimension 替换。
+  - 枚举 VisibilityType 被删除。可以使用 @ohos.app.form.formInfo.d.ts 的 VisibilityType 替换。
+- @ohos.wantAgent.d.ts
+  - 方法 trigger 和 getOperationType 被删除。可以使用 @ohos.app.ability.wantAgent.d.ts 的同名方法替换。
+- application/ApplicationContext.d.ts
+  - 方法 registerAbilityLifecycleCallback、unregisterAbilityLifecycleCallback、registerEnvironmentCallback、unregisterEnvironmentCallback 被删除。可以使用 on、off 替换。
+- application/ServiceExtensionContext.d.ts
+  - 方法 connectAbility、connectAbilityWithAccount、disconnectAbility 被删除。可以使用 connectServiceExtensionAbility、connectServiceExtensionAbilityWithAccount、disconnectServiceExtensionAbility 替换。
+- @ohos.application.ExtensionAbility.d.ts
+  - 生命周期onCreate、onCastToNormal、onUpdate、onVisibilityChange、onEvent、onDestroy、onAcquireFormState、onShare 被删除。可以使用@ohos.app.form.FormExtensionAbility.d.ts的onAddForm、onCastToNormalForm、onUpdateForm、onChangeFormVisibility、onFormEvent、onRemoveForm、onAcquireFormState、onShareForm
+- @ohos.application.abilityDelegatorRegistry.d.ts
+  - 导出类 AbilityDelegator、AbilityDelegatorArgs、AbilityMonitor、ShellCmdResult 被删除。可以使用@ohos.app.ability.abilityDelegatorRegistry.d.ts中的同名导出类替换。
+- @ohos.application.abilityManager.d.ts
+  - 导出类 AbilityRunningInfo、ExtensionRunningInfo 被删除。可以使用@ohos.app.ability.abilityManager.d.ts中的同名导出类替换。
+- @ohos.application.appManager.d.ts
+  - 导出类 AbilityStateData、AppStateData、ApplicationStateObserver、ProcessRunningInfo、ProcessRunningInformation 被删除。可以使用@ohos.app.ability.appManager.d.ts中的同名导出类替换。
+- @ohos.application.missionManager.d.ts
+  - 导出类 MissionInfo、MissionListener、MissionSnapshot 被删除。可以使用@ohos.app.ability.missionManager.d.ts中的同名导出类替换。
+- @ohos.wantAgent.d.ts
+  - 导出类 TriggerInfo、WantAgentInfo 被删除。可以使用@ohos.app.ability.wantAgent.d.ts中的同名导出类替换。
+
+
+
+
+
+**适配指导**
+
+如上所述，仅少数接口修改了接口名的如注册回调函数（registerAbilityLifecycleCallback、unregisterAbilityLifecycleCallback、registerEnvironmentCallback、unregisterEnvironmentCallback）和连接断开 ServiceExtensionAbility（connectAbility、connectAbilityWithAccount、disconnectAbility），卡片生命周期等需要替换成新的接口名。
+
+绝大多数接口平移到了新的namespace中，所以可以通过修改import来解决适配问题：
+
+如原先接口使用了@ohos.application.Ability
+
+```js
+import Ability from '@ohos.application.Ability';
+```
+
+可以通过直接修改import，来切换到新的namespace上：
+
+```js
+import Ability from '@ohos.app.ability.UIAbility';
+```
+
+此外还需要适配异常处理，具体参考新接口的接口文档。
+
+
+

zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.1/changelogs-notification.md

+# 事件通知子系统ChangeLog
+
+## cl.notification.1 删除标记为废弃的API9接口
+
+[事件通知异常处理整改](../OpenHarmony_3.2.8.3/changelogs-notification.md)将部分API9接口标记为了废弃，根据OpenHarmony接口规范，需要删除标记为废弃的API9接口。
+
+**变更影响**
+
+基于此前版本开发的应用，需要将被删除的接口替换为新接口，否则会影响应用编译。
+
+**关键接口/组件变更**
+
+原接口中标记为废弃的API9接口将被删除，可以使用新接口中的同名接口替换。
+
+| 原接口                  | 新接口                           |
+| ----------------------- | -------------------------------- |
+| @ohos.commonEvent.d.ts  | @ohos.commonEventManager.d.ts    |
+| @ohos.notification.d.ts | @ohos.notificationManager.d.ts   |
+| @ohos.notification.d.ts | @ohos.notificationSubscribe.d.ts |
+
+接口、属性被删除：
+
+- @ohos.notification.d.ts
+  - 接口 publishAsBundle、cancelAsBundle、isNotificationSlotEnabled、setSyncNotificationEnabledWithoutApp、getSyncNotificationEnabledWithoutApp 被删除。可以使用 api/@ohos.notificationManager.d.ts 的同名接口替换。
+  - 接口 enableNotificationSlot 被删除。可以使用 api/@ohos.notificationManager.d.ts 的接口 setNotificationEnableSlot 替换。
+  - 导出类 NotificationActionButton、NotificationBasicContent、NotificationContent、NotificationLongTextContent、NotificationMultiLineContent、NotificationPictureContent、NotificationFlags、NotificationFlagStatus、NotificationRequest、DistributedOptions、NotificationSlot、NotificationSorting、NotificationTemplate、NotificationUserInput 被删除。可以使用 api/@ohos.notificationManager.d.ts 的同名导出类替换。
+  - 导出类 NotificationSubscribeInfo、NotificationSubscriber、SubscribeCallbackData、EnabledNotificationCallbackData 被删除。可以使用 api/@ohos.notificationSubscribe.d.ts 的同名导出类替换。
+
+**适配指导**
+
+如上所述，仅将老接口平移到了新的namespace中，所以可以通过修改import来解决适配问题：
+
+如原先接口使用了@ohos.commonEvent
+
+```js
+import commonEvent from '@ohos.commonEvent';
+```
+
+可以通过直接修改import，来切换到新的namespace上：
+
+```js
+import commonEvent from '@ohos.commonEventManager';
+```
+
+@ohos.notification拆分成了两个namespace，需要根据接口情况选择需要的新namespace进行适配。
+
+此外还需要适配异常处理，具体参考新接口的接口文档。
+