diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.2.1/changelogs-ability.md b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.2.1/changelogs-ability.md new file mode 100644 index 0000000000000000000000000000000000000000..5dba4b6de3a95f4aa5a6b8c9d72f9ca6aa25a686 --- /dev/null +++ b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.2.1/changelogs-ability.md @@ -0,0 +1,140 @@ +# 元能力子系统ChangeLog + +## cl.ability.1 SystemAPI使用规则变更 + +目前元能力提供的system-api在调用时未做系统应用校验,三方应用使用Full版本的SDK就可以使用这些system-api,存在安全隐患,因此在OpenHarmony 4.0.2.1版本开始增加应用身份校验。 + +**变更影响** + +只有系统应用允许使用system-api,三方应用使用system-api将返回202错误,返回202错误的方式有两种:1.抛异常;2.异步回调 + +**关键接口/组件变更** + +system-api列表如下所示。 + +| 模块名 | 方法 | 返回错误码方式 | +| ------------------------------------------ | --------------------------------------------------------------------------------- | -------------- | +| @ohos.app.ability.abilityManager.d.ts | updateConfiguration(config: Configuration, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.ability.abilityManager.d.ts | updateConfiguration(config: Configuration): Promise | 异步回调 | +| @ohos.app.ability.abilityManager.d.ts | getAbilityRunningInfos(): Promise> | 异步回调 | +| @ohos.app.ability.abilityManager.d.ts | getAbilityRunningInfos(callback: AsyncCallback>): void | 异步回调 | +| @ohos.app.ability.abilityManager.d.ts | getExtensionRunningInfos(upperLimit: number): Promise> | 异步回调 | +| @ohos.app.ability.abilityManager.d.ts | getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback>): void | 异步回调 | +| @ohos.app.ability.abilityManager.d.ts | getTopAbility(): Promise | 抛异常 | +| @ohos.app.ability.abilityManager.d.ts | getTopAbility(callback: AsyncCallback): void | 抛异常 | +| @ohos.app.ability.appManager.d.ts | on(type: "applicationState", observer: ApplicationStateObserver): number | 异步回调 | +| @ohos.app.ability.appManager.d.ts | on(type: "applicationState", observer: ApplicationStateObserver, bundleNameList: Array): number | 异步回调 | +| @ohos.app.ability.appManager.d.ts | off(type: "applicationState", observerId: number, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.ability.appManager.d.ts | off(type: "applicationState", observerId: number): Promise | 异步回调 | +| @ohos.app.ability.appManager.d.ts | getForegroundApplications(callback: AsyncCallback>): void | 异步回调 | +| @ohos.app.ability.appManager.d.ts | getForegroundApplications(): Promise> | 异步回调 | +| @ohos.app.ability.appManager.d.ts | killProcessWithAccount(bundleName: string, accountId: number): Promise | 异步回调 | +| @ohos.app.ability.appManager.d.ts | killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.ability.appManager.d.ts | killProcessesByBundleName(bundleName: string): Promise | 异步回调 | +| @ohos.app.ability.appManager.d.ts | killProcessesByBundleName(bundleName: string, callback: AsyncCallback) | 异步回调 | +| @ohos.app.ability.appManager.d.ts | clearUpApplicationData(bundleName: string): Promise | 异步回调 | +| @ohos.app.ability.appManager.d.ts | clearUpApplicationData(bundleName: string, callback: AsyncCallback) | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | on(type: "mission", listener: MissionListener): number | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | off(type: "mission", listenerId: number, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | off(type: "mission", listenerId: number): Promise | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | getMissionInfo(deviceId: string, missionId: number): Promise | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | getMissionInfos(deviceId: string, numMax: number, callback: AsyncCallback>): void | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | getMissionInfos(deviceId: string, numMax: number): Promise> | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | getMissionSnapShot(deviceId: string, missionId: number, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | getMissionSnapShot(deviceId: string, missionId: number): Promise | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | getLowResolutionMissionSnapShot(deviceId: string, missionId: number, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | getLowResolutionMissionSnapShot(deviceId: string, missionId: number): Promise | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | lockMission(missionId: number, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | lockMission(missionId: number): Promise | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | unlockMission(missionId: number, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | unlockMission(missionId: number): Promise | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | clearMission(missionId: number, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | clearMission(missionId: number): Promise | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | clearAllMissions(callback: AsyncCallback): void | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | clearAllMissions(): Promise | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | moveMissionToFront(missionId: number, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | moveMissionToFront(missionId: number, options: StartOptions, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.ability.missionManager.d.ts | moveMissionToFront(missionId: number, options?: StartOptions): Promise | 异步回调 | +| @ohos.app.ability.quickFixManager.d.ts | applyQuickFix(hapModuleQuickFixFiles: Array, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.ability.quickFixManager.d.ts | applyQuickFix(hapModuleQuickFixFiles: Array): Promise | 异步回调 | +| @ohos.app.ability.quickFixManager.d.ts | getApplicationQuickFixInfo(bundleName: string, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.ability.quickFixManager.d.ts | getApplicationQuickFixInfo(bundleName: string): Promise | 异步回调 | +| @ohos.app.ability.wantAgent.d.ts | getWant(agent: WantAgent, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.ability.wantAgent.d.ts | getWant(agent: WantAgent): Promise | 异步回调 | +| @ohos.app.form.formHost.d.ts | deleteForm(formId: string, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.form.formHost.d.ts | deleteForm(formId: string): Promise | 异步回调 | +| @ohos.app.form.formHost.d.ts | releaseForm(formId: string, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.form.formHost.d.ts | releaseForm(formId: string, isReleaseCache: boolean, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.form.formHost.d.ts | releaseForm(formId: string, isReleaseCache?: boolean): Promise | 异步回调 | +| @ohos.app.form.formHost.d.ts | requestForm(formId: string, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.form.formHost.d.ts | requestForm(formId: string): Promise | 异步回调 | +| @ohos.app.form.formHost.d.ts | castToNormalForm(formId: string, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.form.formHost.d.ts | castToNormalForm(formId: string): Promise | 异步回调 | +| @ohos.app.form.formHost.d.ts | notifyVisibleForms(formIds: Array, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.form.formHost.d.ts | notifyVisibleForms(formIds: Array): Promise | 异步回调 | +| @ohos.app.form.formHost.d.ts | notifyInvisibleForms(formIds: Array, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.form.formHost.d.ts | notifyInvisibleForms(formIds: Array): Promise | 异步回调 | +| @ohos.app.form.formHost.d.ts | enableFormsUpdate(formIds: Array, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.form.formHost.d.ts | enableFormsUpdate(formIds: Array): Promise | 异步回调 | +| @ohos.app.form.formHost.d.ts | disableFormsUpdate(formIds: Array, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.form.formHost.d.ts | disableFormsUpdate(formIds: Array): Promise | 异步回调 | +| @ohos.app.form.formHost.d.ts | isSystemReady(callback: AsyncCallback): void | 抛异常 | +| @ohos.app.form.formHost.d.ts | isSystemReady(): Promise | 抛异常 | +| @ohos.app.form.formHost.d.ts | getAllFormsInfo(callback: AsyncCallback>): void | 异步回调 | +| @ohos.app.form.formHost.d.ts | getAllFormsInfo(): Promise> | 异步回调 | +| @ohos.app.form.formHost.d.ts | getFormsInfo(bundleName: string, callback: AsyncCallback>): void | 异步回调 | +| @ohos.app.form.formHost.d.ts | getFormsInfo(bundleName: string, moduleName: string, callback: AsyncCallback>): void | 异步回调 | +| @ohos.app.form.formHost.d.ts | getFormsInfo(bundleName: string, moduleName?: string): Promise> | 异步回调 | +| @ohos.app.form.formHost.d.ts | deleteInvalidForms(formIds: Array, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.form.formHost.d.ts | deleteInvalidForms(formIds: Array): Promise | 异步回调 | +| @ohos.app.form.formHost.d.ts | acquireFormState(want: Want, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.form.formHost.d.ts | acquireFormState(want: Want): Promise | 异步回调 | +| @ohos.app.form.formHost.d.ts | on(type: "formUninstall", callback: Callback): void | 抛异常 | +| @ohos.app.form.formHost.d.ts | off(type: "formUninstall", callback?: Callback): void | 抛异常 | +| @ohos.app.form.formHost.d.ts | notifyFormsVisible(formIds: Array, isVisible: boolean, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.form.formHost.d.ts | notifyFormsVisible(formIds: Array, isVisible: boolean): Promise | 异步回调 | +| @ohos.app.form.formHost.d.ts | notifyFormsEnableUpdate(formIds: Array, isEnableUpdate: boolean, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.form.formHost.d.ts | notifyFormsEnableUpdate(formIds: Array, isEnableUpdate: boolean): Promise | 异步回调 | +| @ohos.app.form.formHost.d.ts | shareForm(formId: string, deviceId: string, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.form.formHost.d.ts | shareForm(formId: string, deviceId: string): Promise | 异步回调 | +| @ohos.app.form.formHost.d.ts | notifyFormsPrivacyProtected(formIds: Array, isProtected: boolean, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.form.formHost.d.ts | notifyFormsPrivacyProtected(formIds: Array, isProtected: boolean): Promise | 异步回调 | +| @ohos.app.form.formProvider.d.ts | requestPublishForm(want: Want, formBindingData: formBindingData.FormBindingData, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.form.formProvider.d.ts | requestPublishForm(want: Want, callback: AsyncCallback): void | 异步回调 | +| @ohos.app.form.formProvider.d.ts | requestPublishForm(want: Want, formBindingData?: formBindingData.FormBindingData): Promise | 异步回调 | +| @ohos.app.form.formProvider.d.ts | isRequestPublishFormSupported(callback: AsyncCallback): void | 抛异常 | +| @ohos.app.form.formProvider.d.ts | isRequestPublishFormSupported(): Promise | 抛异常 | +| UIAbilityContext.d.ts | startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback): void | 异步回调 | +| UIAbilityContext.d.ts | startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback): void | 异步回调 | +| UIAbilityContext.d.ts | startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): Promise | 异步回调 | +| UIAbilityContext.d.ts | startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncCallback): void | 抛异常 | +| UIAbilityContext.d.ts | startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback): void | 抛异常 | +| UIAbilityContext.d.ts | startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartOptions): Promise | 抛异常 | +| UIAbilityContext.d.ts | startServiceExtensionAbility(want: Want, callback: AsyncCallback): void | 异步回调 | +| UIAbilityContext.d.ts | startServiceExtensionAbility(want: Want): Promise | 异步回调 | +| UIAbilityContext.d.ts | startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback): void | 异步回调 | +| UIAbilityContext.d.ts | startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise | 异步回调 | +| UIAbilityContext.d.ts | stopServiceExtensionAbility(want: Want, callback: AsyncCallback): void | 异步回调 | +| UIAbilityContext.d.ts | stopServiceExtensionAbility(want: Want): Promise | 异步回调 | +| UIAbilityContext.d.ts | stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback): void | 异步回调 | +| UIAbilityContext.d.ts | stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise | 异步回调 | +| UIAbilityContext.d.ts | connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options: ConnectOptions): number | 异步回调 | +| UIAbilityContext.d.ts | setMissionIcon(icon: image.PixelMap, callback: AsyncCallback): void | 异步回调 | +| UIAbilityContext.d.ts | setMissionIcon(icon: image.PixelMap): Promise | 异步回调 | +| ServiceExtensionContext.d.ts | startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback): void | 异步回调 | +| ServiceExtensionContext.d.ts | startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback): void | 异步回调 | +| ServiceExtensionContext.d.ts | startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): Promise | 异步回调 | +| ServiceExtensionContext.d.ts | startServiceExtensionAbility(want: Want, callback: AsyncCallback): void | 异步回调 | +| ServiceExtensionContext.d.ts | startServiceExtensionAbility(want: Want): Promise | 异步回调 | +| ServiceExtensionContext.d.ts | startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback): void | 异步回调 | +| ServiceExtensionContext.d.ts | startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise | 异步回调 | +| ServiceExtensionContext.d.ts | stopServiceExtensionAbility(want: Want, callback: AsyncCallback): void | 异步回调 | +| ServiceExtensionContext.d.ts | stopServiceExtensionAbility(want: Want): Promise | 异步回调 | +| ServiceExtensionContext.d.ts | stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback): void | 异步回调 | +| ServiceExtensionContext.d.ts | stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise | 异步回调 | +| ServiceExtensionContext.d.ts | connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options: ConnectOptions): number | 异步回调 | +| Context.d.ts | createBundleContext(bundleName: string): Context | 抛异常 | +| Context.d.ts | createModuleContext(bundleName: string, moduleName: string): Context | 抛异常 | +| FormExtensionContext.d.ts | startAbility(want: Want, callback: AsyncCallback): void | 异步回调 | +| FormExtensionContext.d.ts | startAbility(want: Want): Promise | 异步回调 |