1# Ability Framework Changelog 2 3## cl.ability.1 Error Code 16000082 Is Returned When the startAbility API Is Called to Start a UIAbility That Is Configured in Singleton Mode and Is Currently Being Launched 4 5**Access Level** 6 7Public API 8 9**Reason for Change** 10 11When the **startAbility** API is called to start a UIAbility that is configured in singleton mode and is currently being launched, the original logic does not execute the call request and returns OK. 12 13To enable the caller to detect request exceptions, an error code is introduced in this case. 14 15**Change Impact** 16 17This change is a non-compatible change. 18 19Before change: When the **startAbility** API is called to start a UIAbility in singleton mode, the system does not respond to the call request and returns OK if the UIAbility is currently being launched. The caller is unaware of the exception. 20 21After change: When the **startAbility** API is called to start a UIAbility in singleton mode, the system does not respond to the call request and returns an error code if the UIAbility is currently being launched. The API call fails. 22 23 24**Start API Level** 25 269 27 28**Change Since** 29 30OpenHarmony SDK 5.0.0.56 31 32**Key API/Component Changes** 33 34startAbility/openLink 35 36The following APIs are involved: 37 38UIAbilityContext: 39 40- startAbility(want: Want, options?: StartOptions) 41- startAbility(want: Want, callback: AsyncCallback<void>) 42- startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>) 43- startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>) 44- startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback<AbilityResult>) 45- startAbilityForResult(want: Want, options?: StartOptions) 46- startAbilityAsCaller(want: Want, options?: StartOptions) 47- startAbilityAsCaller(want: Want, callback: AsyncCallback<void>) 48- startAbilityAsCaller(want: Want, options: StartOptions, callback: AsyncCallback<void>) 49- startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartOptions) 50- startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncCallback<AbilityResult>) 51- startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback<void>) 52- startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions) 53- startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback<void>) 54- startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback<void>) 55- startRecentAbility(want: Want, options?: StartOptions) 56- startRecentAbility(want: Want, callback: AsyncCallback<void>) 57- startRecentAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>) 58- openLink(link: string, options?: OpenLinkOptions, callback?: AsyncCallback<AbilityResult>) 59 60ServiceExtensionContext: 61- startAbility(want: Want, options?: StartOptions) 62- startAbility(want: Want, callback: AsyncCallback<void>) 63- startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>) 64- startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions) 65- startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback<void>) 66- startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback<void>) 67- startAbilityAsCaller(want: Want, options?: StartOptions) 68- startAbilityAsCaller(want: Want, callback: AsyncCallback<void>) 69- startAbilityAsCaller(want: Want, options: StartOptions, callback: AsyncCallback<void>) 70- startRecentAbility(want: Want, options?: StartOptions) 71- startRecentAbility(want: Want, callback: AsyncCallback<void>) 72- startRecentAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>) 73- openLink(link:string, options?: OpenLinkOptions) 74 75UIExtensionContext: 76- startAbility(want: Want, options?: StartOptions) 77- startAbility(want: Want, callback: AsyncCallback<void>) 78- startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>) 79- startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>) 80- startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback<AbilityResult>) 81- startAbilityForResult(want: Want, options?: StartOptions) 82- startAbilityForResultAsCaller(want: Want, options?: StartOptions) 83- openLink(link:string, options?: OpenLinkOptions, callback?: AsyncCallback<AbilityResult>) 84 85UIExtensionContentSession 86- startAbility(want: Want, options?: StartOptions) 87- startAbility(want: Want, callback: AsyncCallback<void>) 88- startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>) 89- startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>) 90- startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback<AbilityResult>) 91- startAbilityForResult(want: Want, options?: StartOptions) 92- startAbilityAsCaller(want: Want, options?: StartOptions) 93- startAbilityAsCaller(want: Want, callback: AsyncCallback<void>) 94- startAbilityAsCaller(want: Want, options: StartOptions, callback: AsyncCallback<void>) 95 96AbilityDelegator: 97- startAbility(want: Want) 98- startAbility(want: Want, callback: AsyncCallback<void>) 99 100InsightIntentContext: 101- startAbility(want: Want) 102- startAbility(want: Want, callback: AsyncCallback<void>) 103 104**Adaptation Guide** 105 106When an application calls an API to start a UIAbility in singleton mode, if the error code 16000082 is reported, the UIAbility is currently being launched. Wait until the UIAbility finishes launching and try again. 107