输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
RelativeContainer
CustomDialogController
animateTo
CTRL+K
文档管理中心

HarmonyOS

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
RelativeContainer
CustomDialogController
animateTo
CTRL+K
API参考
高级筛选
API version全部版本
设备全部
元服务API集不筛选
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
API参考应用框架Ability Kit（程序框架服务）ArkTS API接口依赖的元素及定义applicationAbilityStartCallback

AbilityStartCallback

更新时间: 2026-06-13 03:51
本文导读

定义拉起UIExtensionAbility执行结果的回调。

说明

本模块首批接口从API version 11开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

本模块接口仅可在Stage模型下使用。

从API version 11开始，本模块接口支持在元服务中使用。

导入模块

PhonePC/2in1TabletTVWearable
import { common } from '@kit.AbilityKit';

AbilityStartCallback

PhonePC/2in1TabletTVWearable

属性

PhonePC/2in1TabletTVWearable

系统能力：SystemCapability.Ability.AbilityRuntime.Core

展开
名称 类型 只读 可选 说明
completionHandler21+ CompletionHandlerForAbilityStartCallback 否 是

用于返回拉起指定类型的Ability组件的回调结果。

元服务API：从API version 21开始，该接口支持在元服务中使用。

onError

PhonePC/2in1TabletTVWearable

onError(code: number, name: string, message: string): void

拉起UIExtensionAbility执行失败的回调。

元服务API：从API version 11开始，该接口支持在元服务中使用。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

展开
参数名 类型 必填 说明
code number 是 拉起UIExtensionAbility执行失败时返回的结果码。
name string 是 拉起UIExtensionAbility执行失败时返回的名称。
message string 是 拉起UIExtensionAbility执行失败时返回的错误信息。

示例：

import { UIAbility, common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  onForeground() {
    let wantParam: Record<string, Object> = {
      'time': '2023-10-23 20:45',
    };
    let abilityStartCallback: common.AbilityStartCallback = {
      onError: (code: number, name: string, message: string) => {
        console.info(`code: ${code}, name: ${name}, message: ${message}`);
      },
      onResult: (abilityResult: common.AbilityResult) => {
        console.info(`resultCode: ${abilityResult.resultCode}, bundleName: ${abilityResult.want?.bundleName}`);
      }
    };

    this.context.startAbilityByType('photoEditor', wantParam, abilityStartCallback, (err: BusinessError) => {
      if (err) {
        console.error(`startAbilityByType fail, err: ${JSON.stringify(err)}`);
      } else {
        console.info(`success`);
      }
    });
  }
}

onResult12+

PhonePC/2in1TabletTVWearable

onResult?(parameter: AbilityResult): void

拉起UIExtensionAbility终止时的回调。

元服务API：从API version 12开始，该接口支持在元服务中使用。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

展开
参数名 类型 必填 说明
parameter AbilityResult 是 当调用terminateSelfWithResult方法终止UIExtensionAbility时返回的结果。

示例：

import { UIAbility, common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  onForeground() {
    let wantParam: Record<string, Object> = {
      'time': '2023-10-23 20:45',
    };
    let abilityStartCallback: common.AbilityStartCallback = {
      onError: (code: number, name: string, message: string) => {
        console.info(`code:` + code + `name:` + name + `message:` + message);
      },
      onResult: (abilityResult: common.AbilityResult) => {
        console.info(`resultCode:` + abilityResult.resultCode + `bundleName:` + abilityResult.want?.bundleName);
      }
    };

    this.context.startAbilityByType('photoEditor', wantParam, abilityStartCallback, (err: BusinessError) => {
      if (err) {
        console.error(`startAbilityByType fail, err: ${JSON.stringify(err)}`);
      } else {
        console.info(`success`);
      }
    });
  }
}
AbilityStageMonitor
AbilityStateData
相关推荐
文档UIServiceExtensionConnectCallback
文档AbilityResult
文档@ohos.app.ability.CompletionHandlerForAbilityStartCallback (拉起应用结果回调的操作类)
文档UIExtensionContext
文档UIAbilityContext
文档@ohos.app.ability.Ability (Ability基类)
文档DataAbilityHelper
文档@ohos.app.ability.common (Ability公共模块)
文档设置事件回调
文档@ohos.app.ability.EnvironmentCallback (系统环境变化监听器)
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 API参考 中进行搜索
请输入您想要搜索的关键词