元能力子系统Changelog

cl.ability.1 startAbility接口启动UIAbility，且UIAbility模式为singleton的时，如果该UIAbility正在启动中，返回错误码16000082

访问级别

公开接口

变更原因

通过startAbility相关接口以singleton模式启动UIAbility时，如果该UIAbility正在启动中，原有逻辑将不执行本次请求并返回OK。为了让调用方能够感知到请求异常，变更后将返回错误码。

变更影响

该变更为不兼容变更。

变更前：通过startAbility相关接口以singleton模式启动UIAbility时，如果该UIAbility正在启动中，系统将不响应本次请求并返回OK。调用方不感知异常。

变更后：通过startAbility相关接口以singleton模式启动UIAbility时，如果该UIAbility正在启动中，系统将不响应本次请求并返回错误码。接口调用失败。

起始API Level

API 9

变更发生版本

从OpenHarmony SDK 5.0.0.56开始。

变更的接口/组件

startAbility/openLink

涉及相关接口: UIAbilityContext:

startAbility(want: Want, options?: StartOptions)
startAbility(want: Want, callback: AsyncCallback<void>)
startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>)
startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>)
startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback<AbilityResult>)
startAbilityForResult(want: Want, options?: StartOptions)
startAbilityAsCaller(want: Want, options?: StartOptions)
startAbilityAsCaller(want: Want, callback: AsyncCallback<void>)
startAbilityAsCaller(want: Want, options: StartOptions, callback: AsyncCallback<void>)
startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartOptions)
startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncCallback<AbilityResult>)
startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback<void>)
startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions)
startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback<void>)
startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback<void>)
startRecentAbility(want: Want, options?: StartOptions)
startRecentAbility(want: Want, callback: AsyncCallback<void>)
startRecentAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>)
openLink(link: string, options?: OpenLinkOptions, callback?: AsyncCallback<AbilityResult>)

ServiceExtensionContext:

startAbility(want: Want, options?: StartOptions)
startAbility(want: Want, callback: AsyncCallback<void>)
startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>)
startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions)
startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback<void>)
startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback<void>)
startAbilityAsCaller(want: Want, options?: StartOptions)
startAbilityAsCaller(want: Want, callback: AsyncCallback<void>)
startAbilityAsCaller(want: Want, options: StartOptions, callback: AsyncCallback<void>)
startRecentAbility(want: Want, options?: StartOptions)
startRecentAbility(want: Want, callback: AsyncCallback<void>)
startRecentAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>)
openLink(link:string, options?: OpenLinkOptions)

UIExtensionContext:

startAbility(want: Want, options?: StartOptions)
startAbility(want: Want, callback: AsyncCallback<void>)
startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>)
startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>)
startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback<AbilityResult>)
startAbilityForResult(want: Want, options?: StartOptions)
startAbilityForResultAsCaller(want: Want, options?: StartOptions)
openLink(link:string, options?: OpenLinkOptions, callback?: AsyncCallback<AbilityResult>)

UIExtensionContentSession

startAbility(want: Want, options?: StartOptions)
startAbility(want: Want, callback: AsyncCallback<void>)
startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>)
startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>)
startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback<AbilityResult>)
startAbilityForResult(want: Want, options?: StartOptions)
startAbilityAsCaller(want: Want, options?: StartOptions)
startAbilityAsCaller(want: Want, callback: AsyncCallback<void>)
startAbilityAsCaller(want: Want, options: StartOptions, callback: AsyncCallback<void>)

AbilityDelegator:

InsightIntentContext:

适配指导

应用侧调用接口启动UIAbility，且该UIAbility模式为singleton时，如果收到错误码16000082，表示该UIAbility正在启动中，需要等该UIAbility启动完成，再进行重试。