1# 元能力子系统JS API变更Changelog
2
3OpenHarmony 3.2.10.1(Mr)版本相较于OpenHarmony 3.2.beta4版本，元能力子系统的API变更如下
4
5## cl.ability.1 接口迁移
6ability子系统UIAbilityContext的接口requestPermissionsFromUser迁移到security子系统：
7
8之前权限弹窗应用是基于UIAbility实现的，需要借助于UIAbilityContext的startAbilityForResult接口把授权结果带回给调用方，故把requestPermissionsFromUser接口暂时放在UIAbilityContext中。现在权限弹窗应用切换为基于ServiceExtensionAbility实现，不再需要借助UIAbilityContext的startAbilityForResult接口，因此把requestPermissionsFromUser接口迁移到security子系统。
9
10开发者需要根据以下说明对应用进行适配。
11
12 **变更影响**
13
14影响API9版本的JS接口，应用需要进行适配才可以在新版本SDK环境正常实现功能。
15
16**关键的接口/组件变更**
17
18| 模块名                    | 类名                | 方法/属性/枚举/常量                                          | 变更类型 |
19| ------------------------- | ------------------- | ------------------------------------------------------------ | -------- |
20| application/UIAbilityContext        | UIAbilityContext        | requestPermissionsFromUser(permissions: Array<string>, requestCallback: AsyncCallback<PermissionRequestResult>): void; | 删除     |
21| application/UIAbilityContext        | UIAbilityContext        | requestPermissionsFromUser(permissions: Array<string>): Promise<PermissionRequestResult>; | 删除     |
22| @ohos.abilityAccessCtrl        | AtManager         | requestPermissionsFromUser(context: Context, permissions: Array<Permissions>, requestCallback: AsyncCallback<PermissionRequestResult>) : void; | 新增     |
23| @ohos.abilityAccessCtrl        | AtManager         | requestPermissionsFromUser(context: Context, permissions: Array<Permissions>) : Promise<PermissionRequestResult>; | 新增     |
24
25
26**适配指导**
27
28应用中调用requestPermissionsFromUser拉起权限弹窗应用可参考下列代码
29
30Stage模型下的示例：
31
32```ts
33import abilityAccessCtrl from '@ohos.abilityAccessCtrl.d.ts';
34//UIAbility的onWindowStageCreate生命周期
35onWindowStageCreate() {
36    let AtManager = abilityAccessCtrl.createAtManager();
37    //requestPermissionsFromUser会判断权限的授权状态来决定是否唤起弹窗
38    AtManager.requestPermissionsFromUser(this.context, ["ohos.permission.MANAGE_DISPOSED_APP_STATUS"]).then((data) => {
39        console.log("data type:" + typeof(data));
40        console.log("data:" + data);
41        console.log("data permissions:" + data.permissions);
42        console.log("data result:" + data.authResults);
43    }).catch((err) => {
44        console.error('Failed to start ability', err.code);
45    })
46}
47```
48
49
50
51## cl.ability.2 删除标记为废弃的API9接口
52
53[元能力异常处理整改](../OpenHarmony_3.2.8.3/changelogs-ability.md)将部分API9接口标记为了废弃，根据OpenHarmony接口规范，需要删除标记为废弃的API9接口。
54
55**变更影响**
56
57基于此前版本开发的应用，需要将被删除的接口替换为新接口，否则会影响应用编译。
58
59**关键接口/组件变更**
60
61接口文件被删除：
62
63| 被删除接口                                      | 新接口                                          |
64| ----------------------------------------------- | ----------------------------------------------- |
65| @ohos.application.Ability.d.ts                  | @ohos.app.ability.UIAbility.d.ts                |
66| @ohos.application.AbilityConstant.d.ts          | @ohos.app.ability.AbilityConstant.d.ts          |
67| @ohos.application.AbilityLifecycleCallback.d.ts | @ohos.app.ability.AbilityLifecycleCallback.d.ts |
68| @ohos.application.AbilityStage.d.ts             | @ohos.app.ability.AbilityStage.d.ts             |
69| @ohos.application.EnvironmentCallback.d.ts      | @ohos.app.ability.EnvironmentCallback.d.ts      |
70| @ohos.application.ExtensionAbility.d.ts         | @ohos.app.ability.ExtensionAbility.d.ts         |
71| @ohos.application.FormExtension.d.ts            | @ohos.app.form.FormExtensionAbility.d.ts        |
72| @ohos.application.ServiceExtensionAbility.d.ts  | @ohos.app.ability.ServiceExtensionAbility.d.ts  |
73| @ohos.application.StartOptions.d.ts             | @ohos.app.ability.StartOptions.d.ts             |
74| @ohos.application.context.d.ts                  | @ohos.app.ability.common.d.ts                   |
75| @ohos.application.errorManager.d.ts             | @ohos.app.ability.errorManager.d.ts             |
76
77接口、属性被删除：
78
79- @ohos.application.Configuration.d.ts
80  - Configuration 的 direction、screenDensity、displayId、hasPointerDevice 被删除。可以使用 @ohos.app.ability.Configuration.d.ts 的 Configuration替换。
81- @ohos.application.ConfigurationConstant.d.ts
82  - 枚举 Direction 和 ScreenDensity 被删除。可以使用 @ohos.app.ability.ConfigurationConstant.d.ts 的枚举 Direction 和 ScreenDensity 替换。
83- @ohos.application.abilityManager.d.ts
84  - 方法 getExtensionRunningInfos 和 getTopAbility 被删除。可以使用 @ohos.app.ability.abilityManager.d.ts 的同名方法替换。
85- @ohos.application.appManager.d.ts
86  - 枚举 ApplicationState 和 ProcessState 被删除。可以使用 @ohos.app.ability.appManager.d.ts 的枚举 ApplicationState 和 ProcessState 替换。
87  - 方法 registerApplicationStateObserver 和 getProcessRunningInformation被删除。可以使用 @ohos.app.ability.appManager.d.ts 的同名方法替换。
88- @ohos.application.formHost.d.ts
89  - 方法 shareForm 和 notifyFormsPrivacyProtected 被删除。可以使用 @ohos.app.form.formHost.d.ts 的同名方法替换。
90- @ohos.application.formInfo.d.ts
91  - 枚举 FormType 的 eTS 被删除，可以使用 @ohos.app.form.formInfo.d.ts 的 FormType 中的 eTS 替换。
92  - 枚举 FormParam 的 IDENTITY_KEY、BUNDLE_NAME_KEY、ABILITY_NAME_KEY、DEVICE_ID_KEY 被删除，可以使用  @ohos.app.form.formInfo.d.ts 的 FormParam 中的同名枚举替换。
93  - 接口 FormInfoFilter 被删除。可以使用 @ohos.app.form.formInfo.d.ts 的 FormInfoFilter 替换。
94  - 枚举 FormDimension 被删除。可以使用 @ohos.app.form.formInfo.d.ts 的 FormDimension 替换。
95  - 枚举 VisibilityType 被删除。可以使用 @ohos.app.form.formInfo.d.ts 的 VisibilityType 替换。
96- @ohos.wantAgent.d.ts
97  - 方法 trigger 和 getOperationType 被删除。可以使用 @ohos.app.ability.wantAgent.d.ts 的同名方法替换。
98- application/ApplicationContext.d.ts
99  - 方法 registerAbilityLifecycleCallback、unregisterAbilityLifecycleCallback、registerEnvironmentCallback、unregisterEnvironmentCallback 被删除。可以使用 on、off 替换。
100- application/ServiceExtensionContext.d.ts
101  - 方法 connectAbility、connectAbilityWithAccount、disconnectAbility 被删除。可以使用 connectServiceExtensionAbility、connectServiceExtensionAbilityWithAccount、disconnectServiceExtensionAbility 替换。
102- @ohos.application.FormExtension.d.ts
103  - 生命周期onCreate、onCastToNormal、onUpdate、onVisibilityChange、onEvent、onDestroy、onAcquireFormState、onShare 被删除。可以使用@ohos.app.form.FormExtensionAbility.d.ts的onAddForm、onCastToNormalForm、onUpdateForm、onChangeFormVisibility、onFormEvent、onRemoveForm、onAcquireFormState、onShareForm
104- @ohos.application.abilityDelegatorRegistry.d.ts
105  - 导出类 AbilityDelegator、AbilityDelegatorArgs、AbilityMonitor、ShellCmdResult 被删除。可以使用@ohos.app.ability.abilityDelegatorRegistry.d.ts中的同名导出类替换。
106- @ohos.application.abilityManager.d.ts
107  - 导出类 AbilityRunningInfo、ExtensionRunningInfo 被删除。可以使用@ohos.app.ability.abilityManager.d.ts中的同名导出类替换。
108- @ohos.application.appManager.d.ts
109  - 导出类 AbilityStateData、AppStateData、ApplicationStateObserver、ProcessRunningInfo、ProcessRunningInformation 被删除。可以使用@ohos.app.ability.appManager.d.ts中的同名导出类替换。
110- @ohos.application.missionManager.d.ts
111  - 导出类 MissionInfo、MissionListener、MissionSnapshot 被删除。可以使用@ohos.app.ability.missionManager.d.ts中的同名导出类替换。
112- @ohos.wantAgent.d.ts
113  - 导出类 TriggerInfo、WantAgentInfo 被删除。可以使用@ohos.app.ability.wantAgent.d.ts中的同名导出类替换。
114
115
116
117
118
119**适配指导**
120
121如上所述，仅少数接口修改了接口名的如注册回调函数（registerAbilityLifecycleCallback、unregisterAbilityLifecycleCallback、registerEnvironmentCallback、unregisterEnvironmentCallback）和连接断开 ServiceExtensionAbility（connectAbility、connectAbilityWithAccount、disconnectAbility），卡片生命周期等需要替换成新的接口名。
122
123绝大多数接口平移到了新的namespace中，所以可以通过修改import来解决适配问题：
124
125如原先接口使用了@ohos.application.Ability
126
127```js
128import Ability from '@ohos.application.Ability';
129```
130
131可以通过直接修改import，来切换到新的namespace上：
132
133```js
134import Ability from '@ohos.app.ability.UIAbility';
135```
136
137此外还需要适配异常处理，具体参考新接口的接口文档。
138
139
140
141