diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-appServiceExtensionContext.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-appServiceExtensionContext.md index e085228424badfb075cff674eb9964ff1652db8a..b35805b62e8452fd56714bcb31a7c937836398be 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-appServiceExtensionContext.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-appServiceExtensionContext.md @@ -33,92 +33,6 @@ class AppServiceExtension extends AppServiceExtensionAbility { } ``` -## AppServiceExtensionContext.startAbility - -startAbility(want: Want, options?: StartOptions): Promise<void> - -启动Ability。仅支持在主线程调用。使用Promise异步回调。 - -**系统能力**:SystemCapability.Ability.AbilityRuntime.Core - -**参数:** - -| 参数名 | 类型 | 必填 | 说明 | -| -------- | -------- | -------- | -------- | -| want | [Want](js-apis-app-ability-want.md) | 是 | Want类型参数,传入需要启动的Ability的信息,如Ability名称、Bundle名称等。 | -| options | [StartOptions](js-apis-app-ability-startOptions.md) | 否 | 启动Ability所携带的参数。 | - -**返回值:** - -| 类型 | 说明 | -| -------- | -------- | -| Promise<void> | Promise对象。无返回结果的Promise对象。 | - -**错误码:** - -以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 - -| 错误码ID | 错误信息 | -| ------- | -------- | -| 201 | The application does not have permission to call the interface. | -| 16000001 | The specified ability does not exist. | -| 16000002 | Incorrect ability type. | -| 16000004 | Cannot start an invisible component. | -| 16000005 | The specified process does not have the permission. | -| 16000008 | The crowdtesting application expires. | -| 16000009 | An ability cannot be started or stopped in Wukong mode. | -| 16000010 | The call with the continuation and prepare continuation flag is forbidden. | -| 16000011 | The context does not exist. | -| 16000012 | The application is controlled. | -| 16000013 | The application is controlled by EDM. | -| 16000019 | No matching ability is found. | -| 16000050 | Internal error. | -| 16000055 | Installation-free timed out. | -| 16000071 | App clone is not supported. | -| 16000072 | App clone or multi-instance is not supported. | -| 16000073 | The app clone index is invalid. | -| 16000076 | The app instance key is invalid. | -| 16000077 | The number of app instances reaches the limit. | -| 16000078 | The multi-instance is not supported. | -| 16000079 | The APP_INSTANCE_KEY cannot be specified. | -| 16000080 | Creating a new instance is not supported. | - -**示例:** - -```ts -import { AppServiceExtensionAbility, Want, StartOptions } from '@kit.AbilityKit'; -import { BusinessError } from '@kit.BasicServicesKit'; - -export default class MyAppServiceExtensionAbility extends AppServiceExtensionAbility { - onCreate(want: Want) { - let wantInfo: Want = { - bundleName: 'com.example.myapplication', - abilityName: 'EntryAbility' - }; - let options: StartOptions = { - displayId: 0 - }; - - try { - this.context.startAbility(wantInfo, options) - .then(() => { - // 执行正常业务 - console.info('startAbility succeed'); - }) - .catch((err: BusinessError) => { - // 处理业务逻辑错误 - console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`); - }); - } catch (err) { - // 处理入参错误异常 - let code = (err as BusinessError).code; - let message = (err as BusinessError).message; - console.error(`startAbility failed, code is ${code}, message is ${message}`); - } - } -} -``` - ## AppServiceExtensionContext.connectServiceExtensionAbility connectServiceExtensionAbility(want: Want, options: ConnectOptions): number