Ability Subsystem ChangeLog

cl.ability.1 System API Usage Rule Change

System application verification is not performed for system APIs provided by the ability when they are called. The APIs can be used by a third-party application using the full SDK, which brings security risks. Therefore, application identity verification is added to OpenHarmony 4.0.2.1 and later versions.

Change Impacts

System APIs are available to only system applications. When a third-party application tries to use a system API, the 202 error will be returned via either an exception or asynchronous callback.

Key API/Component Changes

Below are the system APIs.

Module	API	Error Code Return Mode
@ohos.app.ability.abilityManager.d.ts	updateConfiguration(config: Configuration, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.ability.abilityManager.d.ts	updateConfiguration(config: Configuration): Promise	Asynchronous callback
@ohos.app.ability.abilityManager.d.ts	getAbilityRunningInfos(): Promise<Array>	Asynchronous callback
@ohos.app.ability.abilityManager.d.ts	getAbilityRunningInfos(callback: AsyncCallback<Array>): void	Asynchronous callback
@ohos.app.ability.abilityManager.d.ts	getExtensionRunningInfos(upperLimit: number): Promise<Array>	Asynchronous callback
@ohos.app.ability.abilityManager.d.ts	getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback<Array>): void	Asynchronous callback
@ohos.app.ability.abilityManager.d.ts	getTopAbility(): Promise	Exception
@ohos.app.ability.abilityManager.d.ts	getTopAbility(callback: AsyncCallback): void	Exception
@ohos.app.ability.appManager.d.ts	on(type: "applicationState", observer: ApplicationStateObserver): number	Asynchronous callback
@ohos.app.ability.appManager.d.ts	on(type: "applicationState", observer: ApplicationStateObserver, bundleNameList: Array): number	Asynchronous callback
@ohos.app.ability.appManager.d.ts	off(type: "applicationState", observerId: number, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.ability.appManager.d.ts	off(type: "applicationState", observerId: number): Promise	Asynchronous callback
@ohos.app.ability.appManager.d.ts	getForegroundApplications(callback: AsyncCallback<Array>): void	Asynchronous callback
@ohos.app.ability.appManager.d.ts	getForegroundApplications(): Promise<Array>	Asynchronous callback
@ohos.app.ability.appManager.d.ts	killProcessWithAccount(bundleName: string, accountId: number): Promise	Asynchronous callback
@ohos.app.ability.appManager.d.ts	killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.ability.appManager.d.ts	killProcessesByBundleName(bundleName: string): Promise	Asynchronous callback
@ohos.app.ability.appManager.d.ts	killProcessesByBundleName(bundleName: string, callback: AsyncCallback)	Asynchronous callback
@ohos.app.ability.appManager.d.ts	clearUpApplicationData(bundleName: string): Promise	Asynchronous callback
@ohos.app.ability.appManager.d.ts	clearUpApplicationData(bundleName: string, callback: AsyncCallback)	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	on(type: "mission", listener: MissionListener): number	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	off(type: "mission", listenerId: number, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	off(type: "mission", listenerId: number): Promise	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	getMissionInfo(deviceId: string, missionId: number): Promise	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	getMissionInfos(deviceId: string, numMax: number, callback: AsyncCallback<Array>): void	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	getMissionInfos(deviceId: string, numMax: number): Promise<Array>	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	getMissionSnapShot(deviceId: string, missionId: number, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	getMissionSnapShot(deviceId: string, missionId: number): Promise	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	getLowResolutionMissionSnapShot(deviceId: string, missionId: number, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	getLowResolutionMissionSnapShot(deviceId: string, missionId: number): Promise	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	lockMission(missionId: number, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	lockMission(missionId: number): Promise	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	unlockMission(missionId: number, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	unlockMission(missionId: number): Promise	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	clearMission(missionId: number, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	clearMission(missionId: number): Promise	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	clearAllMissions(callback: AsyncCallback): void	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	clearAllMissions(): Promise	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	moveMissionToFront(missionId: number, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	moveMissionToFront(missionId: number, options: StartOptions, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.ability.missionManager.d.ts	moveMissionToFront(missionId: number, options?: StartOptions): Promise	Asynchronous callback
@ohos.app.ability.quickFixManager.d.ts	applyQuickFix(hapModuleQuickFixFiles: Array, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.ability.quickFixManager.d.ts	applyQuickFix(hapModuleQuickFixFiles: Array): Promise	Asynchronous callback
@ohos.app.ability.quickFixManager.d.ts	getApplicationQuickFixInfo(bundleName: string, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.ability.quickFixManager.d.ts	getApplicationQuickFixInfo(bundleName: string): Promise	Asynchronous callback
@ohos.app.ability.wantAgent.d.ts	getWant(agent: WantAgent, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.ability.wantAgent.d.ts	getWant(agent: WantAgent): Promise	Asynchronous callback
@ohos.app.form.formHost.d.ts	deleteForm(formId: string, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.form.formHost.d.ts	deleteForm(formId: string): Promise	Asynchronous callback
@ohos.app.form.formHost.d.ts	releaseForm(formId: string, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.form.formHost.d.ts	releaseForm(formId: string, isReleaseCache: boolean, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.form.formHost.d.ts	releaseForm(formId: string, isReleaseCache?: boolean): Promise	Asynchronous callback
@ohos.app.form.formHost.d.ts	requestForm(formId: string, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.form.formHost.d.ts	requestForm(formId: string): Promise	Asynchronous callback
@ohos.app.form.formHost.d.ts	castToNormalForm(formId: string, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.form.formHost.d.ts	castToNormalForm(formId: string): Promise	Asynchronous callback
@ohos.app.form.formHost.d.ts	notifyVisibleForms(formIds: Array, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.form.formHost.d.ts	notifyVisibleForms(formIds: Array): Promise	Asynchronous callback
@ohos.app.form.formHost.d.ts	notifyInvisibleForms(formIds: Array, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.form.formHost.d.ts	notifyInvisibleForms(formIds: Array): Promise	Asynchronous callback
@ohos.app.form.formHost.d.ts	enableFormsUpdate(formIds: Array, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.form.formHost.d.ts	enableFormsUpdate(formIds: Array): Promise	Asynchronous callback
@ohos.app.form.formHost.d.ts	disableFormsUpdate(formIds: Array, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.form.formHost.d.ts	disableFormsUpdate(formIds: Array): Promise	Asynchronous callback
@ohos.app.form.formHost.d.ts	isSystemReady(callback: AsyncCallback): void	Exception
@ohos.app.form.formHost.d.ts	isSystemReady(): Promise	Exception
@ohos.app.form.formHost.d.ts	getAllFormsInfo(callback: AsyncCallback<Array<formInfo.FormInfo>>): void	Asynchronous callback
@ohos.app.form.formHost.d.ts	getAllFormsInfo(): Promise<Array<formInfo.FormInfo>>	Asynchronous callback
@ohos.app.form.formHost.d.ts	getFormsInfo(bundleName: string, callback: AsyncCallback<Array<formInfo.FormInfo>>): void	Asynchronous callback
@ohos.app.form.formHost.d.ts	getFormsInfo(bundleName: string, moduleName: string, callback: AsyncCallback<Array<formInfo.FormInfo>>): void	Asynchronous callback
@ohos.app.form.formHost.d.ts	getFormsInfo(bundleName: string, moduleName?: string): Promise<Array<formInfo.FormInfo>>	Asynchronous callback
@ohos.app.form.formHost.d.ts	deleteInvalidForms(formIds: Array, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.form.formHost.d.ts	deleteInvalidForms(formIds: Array): Promise	Asynchronous callback
@ohos.app.form.formHost.d.ts	acquireFormState(want: Want, callback: AsyncCallback<formInfo.FormStateInfo>): void	Asynchronous callback
@ohos.app.form.formHost.d.ts	acquireFormState(want: Want): Promise<formInfo.FormStateInfo>	Asynchronous callback
@ohos.app.form.formHost.d.ts	on(type: "formUninstall", callback: Callback): void	Exception
@ohos.app.form.formHost.d.ts	off(type: "formUninstall", callback?: Callback): void	Exception
@ohos.app.form.formHost.d.ts	notifyFormsVisible(formIds: Array, isVisible: boolean, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.form.formHost.d.ts	notifyFormsVisible(formIds: Array, isVisible: boolean): Promise	Asynchronous callback
@ohos.app.form.formHost.d.ts	notifyFormsEnableUpdate(formIds: Array, isEnableUpdate: boolean, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.form.formHost.d.ts	notifyFormsEnableUpdate(formIds: Array, isEnableUpdate: boolean): Promise	Asynchronous callback
@ohos.app.form.formHost.d.ts	shareForm(formId: string, deviceId: string, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.form.formHost.d.ts	shareForm(formId: string, deviceId: string): Promise	Asynchronous callback
@ohos.app.form.formHost.d.ts	notifyFormsPrivacyProtected(formIds: Array, isProtected: boolean, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.form.formHost.d.ts	notifyFormsPrivacyProtected(formIds: Array, isProtected: boolean): Promise	Asynchronous callback
@ohos.app.form.formProvider.d.ts	requestPublishForm(want: Want, formBindingData: formBindingData.FormBindingData, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.form.formProvider.d.ts	requestPublishForm(want: Want, callback: AsyncCallback): void	Asynchronous callback
@ohos.app.form.formProvider.d.ts	requestPublishForm(want: Want, formBindingData?: formBindingData.FormBindingData): Promise	Asynchronous callback
@ohos.app.form.formProvider.d.ts	isRequestPublishFormSupported(callback: AsyncCallback): void	Exception
@ohos.app.form.formProvider.d.ts	isRequestPublishFormSupported(): Promise	Exception
UIAbilityContext.d.ts	startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback): void	Asynchronous callback
UIAbilityContext.d.ts	startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback): void	Asynchronous callback
UIAbilityContext.d.ts	startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): Promise	Asynchronous callback
UIAbilityContext.d.ts	startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncCallback): void	Exception
UIAbilityContext.d.ts	startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback): void	Exception
UIAbilityContext.d.ts	startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartOptions): Promise	Exception
UIAbilityContext.d.ts	startServiceExtensionAbility(want: Want, callback: AsyncCallback): void	Asynchronous callback
UIAbilityContext.d.ts	startServiceExtensionAbility(want: Want): Promise	Asynchronous callback
UIAbilityContext.d.ts	startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback): void	Asynchronous callback
UIAbilityContext.d.ts	startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise	Asynchronous callback
UIAbilityContext.d.ts	stopServiceExtensionAbility(want: Want, callback: AsyncCallback): void	Asynchronous callback
UIAbilityContext.d.ts	stopServiceExtensionAbility(want: Want): Promise	Asynchronous callback
UIAbilityContext.d.ts	stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback): void	Asynchronous callback
UIAbilityContext.d.ts	stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise	Asynchronous callback
UIAbilityContext.d.ts	connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options: ConnectOptions): number	Asynchronous callback
UIAbilityContext.d.ts	setMissionIcon(icon: image.PixelMap, callback: AsyncCallback): void	Asynchronous callback
UIAbilityContext.d.ts	setMissionIcon(icon: image.PixelMap): Promise	Asynchronous callback
ServiceExtensionContext.d.ts	startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback): void	Asynchronous callback
ServiceExtensionContext.d.ts	startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback): void	Asynchronous callback
ServiceExtensionContext.d.ts	startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): Promise	Asynchronous callback
ServiceExtensionContext.d.ts	startServiceExtensionAbility(want: Want, callback: AsyncCallback): void	Asynchronous callback
ServiceExtensionContext.d.ts	startServiceExtensionAbility(want: Want): Promise	Asynchronous callback
ServiceExtensionContext.d.ts	startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback): void	Asynchronous callback
ServiceExtensionContext.d.ts	startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise	Asynchronous callback
ServiceExtensionContext.d.ts	stopServiceExtensionAbility(want: Want, callback: AsyncCallback): void	Asynchronous callback
ServiceExtensionContext.d.ts	stopServiceExtensionAbility(want: Want): Promise	Asynchronous callback
ServiceExtensionContext.d.ts	stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback): void	Asynchronous callback
ServiceExtensionContext.d.ts	stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise	Asynchronous callback
ServiceExtensionContext.d.ts	connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options: ConnectOptions): number	Asynchronous callback
Context.d.ts	createBundleContext(bundleName: string): Context	Exception
Context.d.ts	createModuleContext(bundleName: string, moduleName: string): Context	Exception
FormExtensionContext.d.ts	startAbility(want: Want, callback: AsyncCallback): void	Asynchronous callback
FormExtensionContext.d.ts	startAbility(want: Want): Promise	Asynchronous callback