1# 元能力子系统ChangeLog
2
3## cl.ability.1 SystemAPI使用规则变更
4
5目前元能力提供的system-api在调用时未做系统应用校验，三方应用使用Full版本的SDK就可以使用这些system-api，存在安全隐患，因此在OpenHarmony 4.0.2.1版本开始增加应用身份校验。
6
7**变更影响**
8
9只有系统应用允许使用system-api，三方应用使用system-api将返回202错误，返回202错误的方式有两种：1.抛异常；2.异步回调
10
11**关键接口/组件变更**
12
13system-api列表如下所示。
14
15| 模块名                                     | 方法                                                                               |  返回错误码方式 |
16| ------------------------------------------ | --------------------------------------------------------------------------------- | -------------- |
17| @ohos.app.ability.abilityManager.d.ts      | updateConfiguration(config: Configuration, callback: AsyncCallback<void>): void   | 异步回调        |
18| @ohos.app.ability.abilityManager.d.ts      | updateConfiguration(config: Configuration): Promise<void>                         | 异步回调        |
19| @ohos.app.ability.abilityManager.d.ts      | getAbilityRunningInfos(): Promise<Array<AbilityRunningInfo>>                      | 异步回调        |
20| @ohos.app.ability.abilityManager.d.ts      | getAbilityRunningInfos(callback: AsyncCallback<Array<AbilityRunningInfo>>): void  | 异步回调        |
21| @ohos.app.ability.abilityManager.d.ts      | getExtensionRunningInfos(upperLimit: number): Promise<Array<ExtensionRunningInfo>>  | 异步回调        |
22| @ohos.app.ability.abilityManager.d.ts      | getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback<Array<ExtensionRunningInfo>>): void  | 异步回调 |
23| @ohos.app.ability.abilityManager.d.ts      | getTopAbility(): Promise<ElementName>                                             | 抛异常        |
24| @ohos.app.ability.abilityManager.d.ts      | getTopAbility(callback: AsyncCallback<ElementName>): void                         | 抛异常        |
25| @ohos.app.ability.appManager.d.ts          | on(type: "applicationState", observer: ApplicationStateObserver): number          | 异步回调        |
26| @ohos.app.ability.appManager.d.ts          | on(type: "applicationState", observer: ApplicationStateObserver, bundleNameList: Array<string>): number   | 异步回调 |
27| @ohos.app.ability.appManager.d.ts          | off(type: "applicationState", observerId: number, callback: AsyncCallback<void>): void   | 异步回调 |
28| @ohos.app.ability.appManager.d.ts          | off(type: "applicationState", observerId: number): Promise<void>   | 异步回调 |
29| @ohos.app.ability.appManager.d.ts          | getForegroundApplications(callback: AsyncCallback<Array<AppStateData>>): void   | 异步回调 |
30| @ohos.app.ability.appManager.d.ts          | getForegroundApplications(): Promise<Array<AppStateData>>   | 异步回调 |
31| @ohos.app.ability.appManager.d.ts          | killProcessWithAccount(bundleName: string, accountId: number): Promise<void>   | 异步回调 |
32| @ohos.app.ability.appManager.d.ts          | killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCallback<void>): void   | 异步回调 |
33| @ohos.app.ability.appManager.d.ts          | killProcessesByBundleName(bundleName: string): Promise<void>   | 异步回调 |
34| @ohos.app.ability.appManager.d.ts          | killProcessesByBundleName(bundleName: string, callback: AsyncCallback<void>)   | 异步回调 |
35| @ohos.app.ability.appManager.d.ts          | clearUpApplicationData(bundleName: string): Promise<void>   | 异步回调 |
36| @ohos.app.ability.appManager.d.ts          | clearUpApplicationData(bundleName: string, callback: AsyncCallback<void>)   | 异步回调 |
37| @ohos.app.ability.missionManager.d.ts      | on(type: "mission", listener: MissionListener): number   | 异步回调 |
38| @ohos.app.ability.missionManager.d.ts      | off(type: "mission", listenerId: number, callback: AsyncCallback<void>): void   | 异步回调 |
39| @ohos.app.ability.missionManager.d.ts      | off(type: "mission", listenerId: number): Promise<void>   | 异步回调 |
40| @ohos.app.ability.missionManager.d.ts      | getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback<MissionInfo>): void   | 异步回调 |
41| @ohos.app.ability.missionManager.d.ts      | getMissionInfo(deviceId: string, missionId: number): Promise<MissionInfo>   | 异步回调 |
42| @ohos.app.ability.missionManager.d.ts      | getMissionInfos(deviceId: string, numMax: number, callback: AsyncCallback<Array<MissionInfo>>): void   | 异步回调 |
43| @ohos.app.ability.missionManager.d.ts      | getMissionInfos(deviceId: string, numMax: number): Promise<Array<MissionInfo>>   | 异步回调 |
44| @ohos.app.ability.missionManager.d.ts      | getMissionSnapShot(deviceId: string, missionId: number, callback: AsyncCallback<MissionSnapshot>): void   | 异步回调 |
45| @ohos.app.ability.missionManager.d.ts      | getMissionSnapShot(deviceId: string, missionId: number): Promise<MissionSnapshot>   | 异步回调 |
46| @ohos.app.ability.missionManager.d.ts      | getLowResolutionMissionSnapShot(deviceId: string, missionId: number, callback: AsyncCallback<MissionSnapshot>): void   | 异步回调 |
47| @ohos.app.ability.missionManager.d.ts      | getLowResolutionMissionSnapShot(deviceId: string, missionId: number): Promise<MissionSnapshot>   | 异步回调 |
48| @ohos.app.ability.missionManager.d.ts      | lockMission(missionId: number, callback: AsyncCallback<void>): void   | 异步回调 |
49| @ohos.app.ability.missionManager.d.ts      | lockMission(missionId: number): Promise<void>   | 异步回调 |
50| @ohos.app.ability.missionManager.d.ts      | unlockMission(missionId: number, callback: AsyncCallback<void>): void   | 异步回调 |
51| @ohos.app.ability.missionManager.d.ts      | unlockMission(missionId: number): Promise<void>   | 异步回调 |
52| @ohos.app.ability.missionManager.d.ts      | clearMission(missionId: number, callback: AsyncCallback<void>): void   | 异步回调 |
53| @ohos.app.ability.missionManager.d.ts      | clearMission(missionId: number): Promise<void>   | 异步回调 |
54| @ohos.app.ability.missionManager.d.ts      | clearAllMissions(callback: AsyncCallback<void>): void   | 异步回调 |
55| @ohos.app.ability.missionManager.d.ts      | clearAllMissions(): Promise<void>   | 异步回调 |
56| @ohos.app.ability.missionManager.d.ts      | moveMissionToFront(missionId: number, callback: AsyncCallback<void>): void   | 异步回调 |
57| @ohos.app.ability.missionManager.d.ts      | moveMissionToFront(missionId: number, options: StartOptions, callback: AsyncCallback<void>): void   | 异步回调 |
58| @ohos.app.ability.missionManager.d.ts      | moveMissionToFront(missionId: number, options?: StartOptions): Promise<void>   | 异步回调 |
59| @ohos.app.ability.quickFixManager.d.ts     | applyQuickFix(hapModuleQuickFixFiles: Array<string>, callback: AsyncCallback<void>): void   | 异步回调 |
60| @ohos.app.ability.quickFixManager.d.ts     | applyQuickFix(hapModuleQuickFixFiles: Array<string>): Promise<void>   | 异步回调 |
61| @ohos.app.ability.quickFixManager.d.ts     | getApplicationQuickFixInfo(bundleName: string, callback: AsyncCallback<ApplicationQuickFixInfo>): void   | 异步回调 |
62| @ohos.app.ability.quickFixManager.d.ts     | getApplicationQuickFixInfo(bundleName: string): Promise<ApplicationQuickFixInfo>   | 异步回调 |
63| @ohos.app.ability.wantAgent.d.ts           | getWant(agent: WantAgent, callback: AsyncCallback<Want>): void   | 异步回调 |
64| @ohos.app.ability.wantAgent.d.ts           | getWant(agent: WantAgent): Promise<Want>   | 异步回调 |
65| @ohos.app.form.formHost.d.ts               | deleteForm(formId: string, callback: AsyncCallback<void>): void   | 异步回调 |
66| @ohos.app.form.formHost.d.ts               | deleteForm(formId: string): Promise<void>   | 异步回调 |
67| @ohos.app.form.formHost.d.ts               | releaseForm(formId: string, callback: AsyncCallback<void>): void   | 异步回调 |
68| @ohos.app.form.formHost.d.ts               | releaseForm(formId: string, isReleaseCache: boolean, callback: AsyncCallback<void>): void   | 异步回调 |
69| @ohos.app.form.formHost.d.ts               | releaseForm(formId: string, isReleaseCache?: boolean): Promise<void>   | 异步回调 |
70| @ohos.app.form.formHost.d.ts               | requestForm(formId: string, callback: AsyncCallback<void>): void   | 异步回调 |
71| @ohos.app.form.formHost.d.ts               | requestForm(formId: string): Promise<void>   | 异步回调 |
72| @ohos.app.form.formHost.d.ts               | castToNormalForm(formId: string, callback: AsyncCallback<void>): void   | 异步回调 |
73| @ohos.app.form.formHost.d.ts               | castToNormalForm(formId: string): Promise<void>   | 异步回调 |
74| @ohos.app.form.formHost.d.ts               | notifyVisibleForms(formIds: Array<string>, callback: AsyncCallback<void>): void   | 异步回调 |
75| @ohos.app.form.formHost.d.ts               | notifyVisibleForms(formIds: Array<string>): Promise<void>   | 异步回调 |
76| @ohos.app.form.formHost.d.ts               | notifyInvisibleForms(formIds: Array<string>, callback: AsyncCallback<void>): void   | 异步回调 |
77| @ohos.app.form.formHost.d.ts               | notifyInvisibleForms(formIds: Array<string>): Promise<void>   | 异步回调 |
78| @ohos.app.form.formHost.d.ts               | enableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void>): void   | 异步回调 |
79| @ohos.app.form.formHost.d.ts               | enableFormsUpdate(formIds: Array<string>): Promise<void>   | 异步回调 |
80| @ohos.app.form.formHost.d.ts               | disableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void>): void   | 异步回调 |
81| @ohos.app.form.formHost.d.ts               | disableFormsUpdate(formIds: Array<string>): Promise<void>   | 异步回调 |
82| @ohos.app.form.formHost.d.ts               | isSystemReady(callback: AsyncCallback<void>): void   | 抛异常 |
83| @ohos.app.form.formHost.d.ts               | isSystemReady(): Promise<void>   | 抛异常 |
84| @ohos.app.form.formHost.d.ts               | getAllFormsInfo(callback: AsyncCallback<Array<formInfo.FormInfo>>): void   | 异步回调 |
85| @ohos.app.form.formHost.d.ts               | getAllFormsInfo(): Promise<Array<formInfo.FormInfo>>   | 异步回调 |
86| @ohos.app.form.formHost.d.ts               | getFormsInfo(bundleName: string, callback: AsyncCallback<Array<formInfo.FormInfo>>): void   | 异步回调 |
87| @ohos.app.form.formHost.d.ts               | getFormsInfo(bundleName: string, moduleName: string, callback: AsyncCallback<Array<formInfo.FormInfo>>): void   | 异步回调 |
88| @ohos.app.form.formHost.d.ts               | getFormsInfo(bundleName: string, moduleName?: string): Promise<Array<formInfo.FormInfo>>   | 异步回调 |
89| @ohos.app.form.formHost.d.ts               | deleteInvalidForms(formIds: Array<string>, callback: AsyncCallback<number>): void   | 异步回调 |
90| @ohos.app.form.formHost.d.ts               | deleteInvalidForms(formIds: Array<string>): Promise<number>   | 异步回调 |
91| @ohos.app.form.formHost.d.ts               | acquireFormState(want: Want, callback: AsyncCallback<formInfo.FormStateInfo>): void   | 异步回调 |
92| @ohos.app.form.formHost.d.ts               | acquireFormState(want: Want): Promise<formInfo.FormStateInfo>   | 异步回调 |
93| @ohos.app.form.formHost.d.ts               | on(type: "formUninstall", callback: Callback<string>): void   | 抛异常 |
94| @ohos.app.form.formHost.d.ts               | off(type: "formUninstall", callback?: Callback<string>): void   | 抛异常 |
95| @ohos.app.form.formHost.d.ts               | notifyFormsVisible(formIds: Array<string>, isVisible: boolean, callback: AsyncCallback<void>): void   | 异步回调 |
96| @ohos.app.form.formHost.d.ts               | notifyFormsVisible(formIds: Array<string>, isVisible: boolean): Promise<void>   | 异步回调 |
97| @ohos.app.form.formHost.d.ts               | notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean, callback: AsyncCallback<void>): void   | 异步回调 |
98| @ohos.app.form.formHost.d.ts               | notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean): Promise<void>   | 异步回调 |
99| @ohos.app.form.formHost.d.ts               | shareForm(formId: string, deviceId: string, callback: AsyncCallback<void>): void   | 异步回调 |
100| @ohos.app.form.formHost.d.ts               | shareForm(formId: string, deviceId: string): Promise<void>   | 异步回调 |
101| @ohos.app.form.formHost.d.ts               | notifyFormsPrivacyProtected(formIds: Array<string>, isProtected: boolean, callback: AsyncCallback<void>): void   | 异步回调 |
102| @ohos.app.form.formHost.d.ts               | notifyFormsPrivacyProtected(formIds: Array<string>, isProtected: boolean): Promise<void>   | 异步回调 |
103| @ohos.app.form.formProvider.d.ts           | requestPublishForm(want: Want, formBindingData: formBindingData.FormBindingData, callback: AsyncCallback<string>): void   | 异步回调 |
104| @ohos.app.form.formProvider.d.ts           | requestPublishForm(want: Want, callback: AsyncCallback<string>): void   | 异步回调 |
105| @ohos.app.form.formProvider.d.ts           | requestPublishForm(want: Want, formBindingData?: formBindingData.FormBindingData): Promise<string>   | 异步回调 |
106| @ohos.app.form.formProvider.d.ts           | isRequestPublishFormSupported(callback: AsyncCallback<boolean>): void   | 抛异常 |
107| @ohos.app.form.formProvider.d.ts           | isRequestPublishFormSupported(): Promise<boolean>   | 抛异常 |
108| UIAbilityContext.d.ts                      | startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback<void>): void   | 异步回调 |
109| UIAbilityContext.d.ts                      | startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback<void>): void   | 异步回调 |
110| UIAbilityContext.d.ts                      | startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): Promise<void>   | 异步回调 |
111| UIAbilityContext.d.ts                      | startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncCallback<AbilityResult>): void   | 抛异常 |
112| UIAbilityContext.d.ts                      | startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback<AbilityResult>): void   | 抛异常 |
113| UIAbilityContext.d.ts                      | startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartOptions): Promise<AbilityResult>   | 抛异常 |
114| UIAbilityContext.d.ts                      | startServiceExtensionAbility(want: Want, callback: AsyncCallback<void>): void   | 异步回调 |
115| UIAbilityContext.d.ts                      | startServiceExtensionAbility(want: Want): Promise<void>   | 异步回调 |
116| UIAbilityContext.d.ts                      | startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback<void>): void   | 异步回调 |
117| UIAbilityContext.d.ts                      | startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise<void>   | 异步回调 |
118| UIAbilityContext.d.ts                      | stopServiceExtensionAbility(want: Want, callback: AsyncCallback<void>): void   | 异步回调 |
119| UIAbilityContext.d.ts                      | stopServiceExtensionAbility(want: Want): Promise<void>   | 异步回调 |
120| UIAbilityContext.d.ts                      | stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback<void>): void   | 异步回调 |
121| UIAbilityContext.d.ts                      | stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise<void>   | 异步回调 |
122| UIAbilityContext.d.ts                      | connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options: ConnectOptions): number   | 异步回调 |
123| UIAbilityContext.d.ts                      | setMissionIcon(icon: image.PixelMap, callback: AsyncCallback<void>): void   | 异步回调 |
124| UIAbilityContext.d.ts                      | setMissionIcon(icon: image.PixelMap): Promise<void>   | 异步回调 |
125| ServiceExtensionContext.d.ts               | startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback<void>): void   | 异步回调 |
126| ServiceExtensionContext.d.ts               | startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback<void>): void   | 异步回调 |
127| ServiceExtensionContext.d.ts               | startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): Promise<void>   | 异步回调 |
128| ServiceExtensionContext.d.ts               | startServiceExtensionAbility(want: Want, callback: AsyncCallback<void>): void   | 异步回调 |
129| ServiceExtensionContext.d.ts               | startServiceExtensionAbility(want: Want): Promise<void>   | 异步回调 |
130| ServiceExtensionContext.d.ts               | startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback<void>): void   | 异步回调 |
131| ServiceExtensionContext.d.ts               | startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise<void>   | 异步回调 |
132| ServiceExtensionContext.d.ts               | stopServiceExtensionAbility(want: Want, callback: AsyncCallback<void>): void   | 异步回调 |
133| ServiceExtensionContext.d.ts               | stopServiceExtensionAbility(want: Want): Promise<void>   | 异步回调 |
134| ServiceExtensionContext.d.ts               | stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback<void>): void   | 异步回调 |
135| ServiceExtensionContext.d.ts               | stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise<void>   | 异步回调 |
136| ServiceExtensionContext.d.ts               | connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options: ConnectOptions): number   | 异步回调 |
137| Context.d.ts                               | createBundleContext(bundleName: string): Context   | 抛异常 |
138| Context.d.ts                               | createModuleContext(bundleName: string, moduleName: string): Context   | 抛异常 |
139| FormExtensionContext.d.ts                  | startAbility(want: Want, callback: AsyncCallback<void>): void   | 异步回调 |
140| FormExtensionContext.d.ts                  | startAbility(want: Want): Promise<void>   | 异步回调 |
141