HarmonyOS实战开发：UIAbilityContext

UIAbilityContext是需要生存状态的UIAbility所对应的context，继承自Context，提供UIAbility的相关设置信息以及操作UIAbility和ServiceExtensionAbility的方法，如启动UIAbility，停止当前UIAbilityContext所属的UIAbility，启动、停止、毗连、断开毗连ServiceExtensionAbility等。
   说明：
  

• 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标志接口的起始版本。
  
• 本模块接口仅可在Stage模子下使用。
  
• 本模块接口需要在主线程中使用，不要在Worker、TaskPool等子线程中使用。
  

  导入模块

1. import common from '@ohos.app.ability.common';

复制代码

属性

体系本领：以下各项对应的体系本领均为SystemCapability.Ability.AbilityRuntime.Core
名称类型可读可写说明abilityInfoAbilityInfo是否UIAbility的相关信息。currentHapModuleInfoHapModuleInfo是否当前HAP的信息。configConfiguration是否与UIAbility相关的设置信息，如语言、颜色模式等。   关于示例代码的说明：
  在本文档的示例中，通过来获取，此中代表继承自的实例。如需要在页面中使用提供的本领，请参见获取UIAbility的上下文信息。this.contextUIAbilityContextthisUIAbilityUIAbilityUIAbilityContext
  UIAbilityContext.startAbility

startAbility(want: Want, callback: AsyncCallback<void>): void
启动Ability（callback情势）。
使用规则：

• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 组件启动规则详见：组件启动规则（Stage模子）。
  
• 跨任务链启动时，如果需要跨任务链进行返回，需要参考Want中的parameter参数用法。
  

体系本领：SystemCapability.Ability.AbilityRuntime.Core
参数：
参数名类型必填说明wantWant是启动Ability的want信息。callbackAsyncCallback<void>是callback情势返回启动效果。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000009An ability cannot be started or stopped in Wukong mode.16000010The call with the continuation flag is forbidden.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import Want from '@ohos.app.ability.Want';
3. import { BusinessError } from '@ohos.base';
5. export default class EntryAbility extends UIAbility {
6.   
7.   onForeground() {
8.     let want: Want = {
9.       bundleName: 'com.example.myapplication',
10.       abilityName: 'EntryAbility'
11.     };
13.     try {
14.       this.context.startAbility(want, (err: BusinessError) => {
15.         if (err.code) {
16.           // 处理业务逻辑错误
17.           console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
18.           return;
19.         }
20.         // 执行正常业务
21.         console.info('startAbility succeed');
22.       });
23.     } catch (err) {
24.       // 处理入参错误异常
25.       let code = (err as BusinessError).code;
26.       let message = (err as BusinessError).message;
27.       console.error(`startAbility failed, code is ${code}, message is ${message}`);
28.     }
29.   }
30. }

复制代码

UIAbilityContext.startAbility

startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>): void
启动Ability（callback情势）。
使用规则：

• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 组件启动规则详见：组件启动规则（Stage模子）。
  

体系本领：SystemCapability.Ability.AbilityRuntime.Core
参数：
参数名类型必填说明wantWant是启动Ability的want信息。optionsStartOptions是启动Ability所携带的参数。callbackAsyncCallback<void>是callback情势返回启动效果。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000009An ability cannot be started or stopped in Wukong mode.16000010The call with the continuation flag is forbidden.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import Want from '@ohos.app.ability.Want';
3. import StartOptions from '@ohos.app.ability.StartOptions';
4. import { BusinessError } from '@ohos.base';
6. export default class EntryAbility extends UIAbility {
8.   onForeground() {
9.     let want: Want = {
10.       deviceId: '',
11.       bundleName: 'com.example.myapplication',
12.       abilityName: 'EntryAbility'
13.     };
14.     let options: StartOptions = {
15.       windowMode: 0
16.     };
18.     try {
19.       this.context.startAbility(want, options, (err: BusinessError) => {
20.         if (err.code) {
21.           // 处理业务逻辑错误
22.           console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
23.           return;
24.         }
25.         // 执行正常业务
26.         console.info('startAbility succeed');
27.       });
28.     } catch (err) {
29.       // 处理入参错误异常
30.       let code = (err as BusinessError).code;
31.       let message = (err as BusinessError).message;
32.       console.error(`startAbility failed, code is ${code}, message is ${message}`);
33.     }
34.   }
35. }

复制代码

UIAbilityContext.startAbility

startAbility(want: Want, options?: StartOptions): Promise<void>
启动Ability（promise情势）。
使用规则：

• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 组件启动规则详见：组件启动规则（Stage模子）。
  

体系本领：SystemCapability.Ability.AbilityRuntime.Core
参数：
参数名类型必填说明wantWant是启动Ability的want信息。optionsStartOptions否启动Ability所携带的参数。 返回值：
类型说明Promise<void>Promise情势返回启动效果。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000009An ability cannot be started or stopped in Wukong mode.16000010The call with the continuation flag is forbidden.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import Want from '@ohos.app.ability.Want';
3. import StartOptions from '@ohos.app.ability.StartOptions';
4. import { BusinessError } from '@ohos.base';
6. export default class EntryAbility extends UIAbility {
8.   onForeground() {
9.     let want: Want = {
10.       bundleName: 'com.example.myapplication',
11.       abilityName: 'EntryAbility'
12.     };
13.     let options: StartOptions = {
14.       windowMode: 0,
15.     };
17.     try {
18.       this.context.startAbility(want, options)
19.         .then(() => {
20.           // 执行正常业务
21.           console.info('startAbility succeed');
22.         })
23.         .catch((err: BusinessError) => {
24.           // 处理业务逻辑错误
25.           console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
26.         });
27.     } catch (err) {
28.       // 处理入参错误异常
29.       let code = (err as BusinessError).code;
30.       let message = (err as BusinessError).message;
31.       console.error(`startAbility failed, code is ${code}, message is ${message}`);
32.     }
33.   }
34. }

复制代码

UIAbilityContext.startAbilityForResult

startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>): void
启动一个Ability。Ability被启动后，有如下情况(callback情势):

• 正常情况下可通过调用terminateSelfWithResult接口使之终止并且返回效果给调用方。
  
• 异常情况下比如杀死Ability会返回异常信息给调用方, 异常信息中resultCode为-1。
  
• 如果被启动的Ability模式是单实例模式, 不同应用多次调用该接口启动这个Ability，当这个Ability调用terminateSelfWithResult接口使之终止时，只将正常效果返回给末了一个调用方, 别的调用方返回异常信息, 异常信息中resultCode为-1。
  

使用规则：

• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 组件启动规则详见：组件启动规则（Stage模子）。
  

体系本领：SystemCapability.Ability.AbilityRuntime.Core
参数：
参数名类型必填说明wantWant是启动Ability的want信息。callbackAsyncCallback<AbilityResult>是实行效果回调函数。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000009An ability cannot be started or stopped in Wukong mode.16000010The call with the continuation flag is forbidden.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import common from '@ohos.app.ability.common';
3. import Want from '@ohos.app.ability.Want';
4. import { BusinessError } from '@ohos.base';
6. export default class EntryAbility extends UIAbility {
8.   onForeground() {
9.     let want: Want = {
10.       deviceId: '',
11.       bundleName: 'com.example.myapplication',
12.       abilityName: 'EntryAbility'
13.     };
15.     try {
16.       this.context.startAbilityForResult(want, (err: BusinessError, result: common.AbilityResult) => {
17.         if (err.code) {
18.           // 处理业务逻辑错误
19.           console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`);
20.           return;
21.         }
22.         // 执行正常业务
23.         console.info('startAbilityForResult succeed');
24.       });
25.     } catch (err) {
26.       // 处理入参错误异常
27.       let code = (err as BusinessError).code;
28.       let message = (err as BusinessError).message;
29.       console.error(`startAbilityForResult failed, code is ${code}, message is ${message}`);
30.     }
31.   }
32. }

复制代码

UIAbilityContext.startAbilityForResult

startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback<AbilityResult>): void
启动一个Ability。Ability被启动后，有如下情况(callback情势):

• 正常情况下可通过调用terminateSelfWithResult接口使之终止并且返回效果给调用方。
  
• 异常情况下比如杀死Ability会返回异常信息给调用方，异常信息中resultCode为-1。
  
• 如果被启动的Ability模式是单实例模式, 不同应用多次调用该接口启动这个Ability，当这个Ability调用terminateSelfWithResult接口使之终止时，只将正常效果返回给末了一个调用方，别的调用方返回异常信息, 异常信息中resultCode为-1。
  

使用规则：

• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 组件启动规则详见：组件启动规则（Stage模子）。
  

体系本领：SystemCapability.Ability.AbilityRuntime.Core
参数：
参数名类型必填说明wantWant是启动Ability的want信息。optionsStartOptions是启动Ability所携带的参数。callbackAsyncCallback<AbilityResult>是实行效果回调函数。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000009An ability cannot be started or stopped in Wukong mode.16000010The call with the continuation flag is forbidden.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import common from '@ohos.app.ability.common';
3. import Want from '@ohos.app.ability.Want';
4. import StartOptions from '@ohos.app.ability.StartOptions';
5. import { BusinessError } from '@ohos.base';
7. export default class EntryAbility extends UIAbility {
9.   onForeground() {
10.     let want: Want = {
11.       deviceId: '',
12.       bundleName: 'com.example.myapplication',
13.       abilityName: 'EntryAbility'
14.     };
15.     let options: StartOptions = {
16.       windowMode: 0,
17.     };
19.     try {
20.       this.context.startAbilityForResult(want, options, (err: BusinessError, result: common.AbilityResult) => {
21.         if (err.code) {
22.           // 处理业务逻辑错误
23.           console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`);
24.           return;
25.         }
26.         // 执行正常业务
27.         console.info('startAbilityForResult succeed');
28.       });
29.     } catch (err) {
30.       // 处理入参错误异常
31.       let code = (err as BusinessError).code;
32.       let message = (err as BusinessError).message;
33.       console.error(`startAbilityForResult failed, code is ${code}, message is ${message}`);
34.     }
35.   }
36. }

复制代码

UIAbilityContext.startAbilityForResult

startAbilityForResult(want: Want, options?: StartOptions): Promise<AbilityResult>
启动一个Ability。Ability被启动后，有如下情况(promise情势):

• 正常情况下可通过调用terminateSelfWithResult接口使之终止并且返回效果给调用方。
  
• 异常情况下比如杀死Ability会返回异常信息给调用方, 异常信息中resultCode为-1。
  
• 如果被启动的Ability模式是单实例模式, 不同应用多次调用该接口启动这个Ability，当这个Ability调用terminateSelfWithResult接口使之终止时，只将正常效果返回给末了一个调用方, 别的调用方返回异常信息, 异常信息中resultCode为-1。
  

使用规则：

• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 组件启动规则详见：组件启动规则（Stage模子）。
  

体系本领：SystemCapability.Ability.AbilityRuntime.Core
参数：
参数名类型必填说明wantWant是启动Ability的want信息。optionsStartOptions否启动Ability所携带的参数。 返回值：
类型说明Promise<AbilityResult>Promise情势返回实行效果。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000009An ability cannot be started or stopped in Wukong mode.16000010The call with the continuation flag is forbidden.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import common from '@ohos.app.ability.common';
3. import Want from '@ohos.app.ability.Want';
4. import StartOptions from '@ohos.app.ability.StartOptions';
5. import { BusinessError } from '@ohos.base';
7. export default class EntryAbility extends UIAbility {
9.   onForeground() {
10.     let want: Want = {
11.       bundleName: 'com.example.myapplication',
12.       abilityName: 'EntryAbility'
13.     };
14.     let options: StartOptions = {
15.       windowMode: 0,
16.     };
18.     try {
19.       this.context.startAbilityForResult(want, options)
20.         .then((result: common.AbilityResult) => {
21.           // 执行正常业务
22.           console.info('startAbilityForResult succeed');
23.         })
24.         .catch((err: BusinessError) => {
25.           // 处理业务逻辑错误
26.           console.error(`startAbilityForResult failed, code is ${err.code}, message is ${err.message}`);
27.         });
28.     } catch (err) {
29.       // 处理入参错误异常
30.       let code = (err as BusinessError).code;
31.       let message = (err as BusinessError).message;
32.       console.error(`startAbilityForResult failed, code is ${code}, message is ${message}`);
33.     }
34.   }
35. }

复制代码

UIAbilityContext.startAbilityForResultWithAccount

startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncCallback<AbilityResult>): void
启动一个Ability并在该Ability销毁时返回实行效果（callback情势）。
使用规则：

• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 组件启动规则详见：组件启动规则（Stage模子）。
  

   说明：
  当accountId为当前用户时，不需要校验该权限。
  需要权限: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API: 此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是启动Ability的want信息。accountIdnumber是体系帐号的帐号ID，详情参考getCreatedOsAccountsCount。callbackAsyncCallback<AbilityResult>是启动Ability的回调函数，返回Ability效果。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000009An ability cannot be started or stopped in Wukong mode.16000010The call with the continuation flag is forbidden.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import common from '@ohos.app.ability.common';
3. import Want from '@ohos.app.ability.Want';
4. import { BusinessError } from '@ohos.base';
6. export default class EntryAbility extends UIAbility {
8.   onForeground() {
10.     let want: Want = {
11.       deviceId: '',
12.       bundleName: 'com.example.myapplication',
13.       abilityName: 'EntryAbility'
14.     };
15.     let accountId = 100;
17.     try {
18.       this.context.startAbilityForResultWithAccount(want, accountId, (err: BusinessError, result: common.AbilityResult) => {
19.         if (err.code) {
20.           // 处理业务逻辑错误
21.           console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`);
22.           return;
23.         }
24.         // 执行正常业务
25.         console.info('startAbilityForResultWithAccount succeed');
26.       });
27.     } catch (err) {
28.       // 处理入参错误异常
29.       let code = (err as BusinessError).code;
30.       let message = (err as BusinessError).message;
31.       console.error(`startAbilityForResultWithAccount failed, code is ${code}, message is ${message}`);
32.     }
33.   }
34. }

复制代码

UIAbilityContext.startAbilityForResultWithAccount

startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback<void>): void
启动一个Ability并在该Ability销毁时返回实行效果（callback情势）。
使用规则：

• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 组件启动规则详见：组件启动规则（Stage模子）。
  

   说明：
  当accountId为当前用户时，不需要校验该权限。
  需要权限: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API: 此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是启动Ability的want信息。accountIdnumber是体系帐号的帐号ID，详情参考getCreatedOsAccountsCount。optionsStartOptions是启动Ability所携带的参数。callbackAsyncCallback<void>是启动Ability后，Ability被销毁时的回调函数。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000009An ability cannot be started or stopped in Wukong mode.16000010The call with the continuation flag is forbidden.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import Want from '@ohos.app.ability.Want';
3. import StartOptions from '@ohos.app.ability.StartOptions';
4. import { BusinessError } from '@ohos.base';
6. export default class EntryAbility extends UIAbility {
8.   onForeground() {
10.     let want: Want = {
11.       deviceId: '',
12.       bundleName: 'com.example.myapplication',
13.       abilityName: 'EntryAbility'
14.     };
15.     let accountId = 100;
16.     let options: StartOptions = {
17.       windowMode: 0
18.     };
20.     try {
21.       this.context.startAbilityForResultWithAccount(want, accountId, options, (err: BusinessError) => {
22.         if (err.code) {
23.           // 处理业务逻辑错误
24.           console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`);
25.           return;
26.         }
27.         // 执行正常业务
28.         console.info('startAbilityForResultWithAccount succeed');
29.       });
30.     } catch (err) {
31.       // 处理入参错误异常
32.       let code = (err as BusinessError).code;
33.       let message = (err as BusinessError).message;
34.       console.error(`startAbilityForResultWithAccount failed, code is ${code}, message is ${message}`);
35.     }
36.   }
37. }

复制代码

UIAbilityContext.startAbilityForResultWithAccount

startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartOptions): Promise<AbilityResult>
启动一个Ability并在该Ability销毁时返回实行效果（promise情势）。
使用规则：

• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 组件启动规则详见：组件启动规则（Stage模子）。
  

   说明：
  当accountId为当前用户时，不需要校验该权限。
  需要权限: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API: 此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是启动Ability的want信息。accountIdnumber是体系帐号的帐号ID，详情参考getCreatedOsAccountsCount。optionsStartOptions否启动Ability所携带的参数。 返回值：
类型说明Promise<AbilityResult>Ability被销毁时的回调函数，包含AbilityResult参数。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000009An ability cannot be started or stopped in Wukong mode.16000010The call with the continuation flag is forbidden.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import common from '@ohos.app.ability.common';
3. import Want from '@ohos.app.ability.Want';
4. import StartOptions from '@ohos.app.ability.StartOptions';
5. import { BusinessError } from '@ohos.base';
7. export default class EntryAbility extends UIAbility {
9.   onForeground() {
10.     let want: Want = {
11.       deviceId: '',
12.       bundleName: 'com.example.myapplication',
13.       abilityName: 'EntryAbility'
14.     };
15.     let accountId = 100;
16.     let options: StartOptions = {
17.       windowMode: 0
18.     };
20.     try {
21.       this.context.startAbilityForResultWithAccount(want, accountId, options)
22.         .then((result: common.AbilityResult) => {
23.           // 执行正常业务
24.           console.info('startAbilityForResultWithAccount succeed');
25.         })
26.         .catch((err: BusinessError) => {
27.           // 处理业务逻辑错误
28.           console.error(`startAbilityForResultWithAccount failed, code is ${err.code}, message is ${err.message}`);
29.         });
30.     } catch (err) {
31.       // 处理入参错误异常
32.       let code = (err as BusinessError).code;
33.       let message = (err as BusinessError).message;
34.       console.error(`startAbilityForResultWithAccount failed, code is ${code}, message is ${message}`);
35.     }
36.   }
37. }

复制代码

UIAbilityContext.startServiceExtensionAbility

startServiceExtensionAbility(want: Want, callback: AsyncCallback<void>): void
启动一个新的ServiceExtensionAbility（callback情势）。
体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API: 此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是启动ServiceExtensionAbility的want信息。callbackAsyncCallback<void>是启动ServiceExtensionAbility的回调函数。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import Want from '@ohos.app.ability.Want';
3. import { BusinessError } from '@ohos.base';
5. export default class EntryAbility extends UIAbility {
7.   onForeground() {
8.     let want: Want = {
9.       deviceId: '',
10.       bundleName: 'com.example.myapplication',
11.       abilityName: 'ServiceExtensionAbility'
12.     };
14.     try {
15.       this.context.startServiceExtensionAbility(want)
16.         .then(() => {
17.           // 执行正常业务
18.           console.info('startServiceExtensionAbility succeed');
19.         })
20.         .catch((err: BusinessError) => {
21.           // 处理业务逻辑错误
22.           console.error(`startServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
23.         });
24.     } catch (err) {
25.       // 处理入参错误异常
26.       let code = (err as BusinessError).code;
27.       let message = (err as BusinessError).message;
28.       console.error(`startServiceExtensionAbility failed, code is ${code}, message is ${message}`);
29.     }
30.   }
31. }

复制代码

UIAbilityContext.startServiceExtensionAbility

startServiceExtensionAbility(want: Want): Promise<void>
启动一个新的ServiceExtensionAbility（Promise情势）。
体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API: 此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是启动ServiceExtensionAbility的want信息。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import Want from '@ohos.app.ability.Want';
3. import { BusinessError } from '@ohos.base';
5. export default class EntryAbility extends UIAbility {
7.   onForeground() {
8.     let want: Want = {
9.       deviceId: '',
10.       bundleName: 'com.example.myapplication',
11.       abilityName: 'ServiceExtensionAbility'
12.     };
14.     try {
15.       this.context.startServiceExtensionAbility(want)
16.         .then(() => {
17.           // 执行正常业务
18.           console.info('startServiceExtensionAbility succeed');
19.         })
20.         .catch((err: BusinessError) => {
21.           // 处理业务逻辑错误
22.           console.error(`startServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
23.         });
24.     } catch (err) {
25.       // 处理入参错误异常
26.       let code = (err as BusinessError).code;
27.       let message = (err as BusinessError).message;
28.       console.error(`startServiceExtensionAbility failed, code is ${code}, message is ${message}`);
29.     }
30.   }
31. }

复制代码

UIAbilityContext.startServiceExtensionAbilityWithAccount

startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback<void>): void
启动一个新的ServiceExtensionAbility（callback情势）。
   说明：
  当accountId为当前用户时，不需要校验该权限。
  需要权限: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API: 此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是启动ServiceExtensionAbility的want信息。accountIdnumber是体系帐号的帐号ID，详情参考getCreatedOsAccountsCount。callbackAsyncCallback<void>是启动ServiceExtensionAbility的回调函数。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import Want from '@ohos.app.ability.Want';
3. import { BusinessError } from '@ohos.base';
5. export default class EntryAbility extends UIAbility {
7.   onForeground() {
8.     let want: Want = {
9.       deviceId: '',
10.       bundleName: 'com.example.myapplication',
11.       abilityName: 'ServiceExtensionAbility'
12.     };
13.     let accountId = 100;
15.     try {
16.       this.context.startServiceExtensionAbilityWithAccount(want, accountId, (err: BusinessError) => {
17.         if (err.code) {
18.           // 处理业务逻辑错误
19.           console.error(`startServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
20.           return;
21.         }
22.         // 执行正常业务
23.         console.info('startServiceExtensionAbilityWithAccount succeed');
24.       });
25.     } catch (err) {
26.       // 处理入参错误异常
27.       let code = (err as BusinessError).code;
28.       let message = (err as BusinessError).message;
29.       console.error(`startServiceExtensionAbilityWithAccount failed, code is ${code}, message is ${message}`);
30.     }
31.   }
32. }

复制代码

UIAbilityContext.startServiceExtensionAbilityWithAccount

startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise<void>
启动一个新的ServiceExtensionAbility（Promise情势）。
   说明：
  当accountId为当前用户时，不需要校验该权限。
  需要权限: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API: 此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是启动Ability的want信息。accountIdnumber是体系帐号的帐号ID，详情参考getCreatedOsAccountsCount。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import Want from '@ohos.app.ability.Want';
3. import { BusinessError } from '@ohos.base';
5. export default class EntryAbility extends UIAbility {
7.   onForeground() {
8.     let want: Want = {
9.       deviceId: '',
10.       bundleName: 'com.example.myapplication',
11.       abilityName: 'ServiceExtensionAbility'
12.     };
13.     let accountId = 100;
15.     try {
16.       this.context.startServiceExtensionAbilityWithAccount(want, accountId)
17.         .then(() => {
18.           // 执行正常业务
19.           console.info('startServiceExtensionAbilityWithAccount succeed');
20.         })
21.         .catch((err: BusinessError) => {
22.           // 处理业务逻辑错误
23.           console.error(`startServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
24.         });
25.     } catch (err) {
26.       // 处理入参错误异常
27.       let code = (err as BusinessError).code;
28.       let message = (err as BusinessError).message;
29.       console.error(`startServiceExtensionAbilityWithAccount failed, code is ${code}, message is ${message}`);
30.     }
31.   }
32. }

复制代码

UIAbilityContext.stopServiceExtensionAbility

stopServiceExtensionAbility(want: Want, callback: AsyncCallback<void>): void
停止同一应用步伐内的服务（callback情势）。
体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API: 此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是停止ServiceExtensionAbility的want信息。callbackAsyncCallback<void>是停止ServiceExtensionAbility的回调函数。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import Want from '@ohos.app.ability.Want';
3. import { BusinessError } from '@ohos.base';
5. export default class EntryAbility extends UIAbility {
7. onForeground() {
8.   let want: Want = {
9.     deviceId: '',
10.     bundleName: 'com.example.myapplication',
11.     abilityName: 'ServiceExtensionAbility'
12.   };
14.   try {
15.     this.context.stopServiceExtensionAbility(want, (err: BusinessError) => {
16.       if (err.code) {
17.         // 处理业务逻辑错误
18.         console.error(`stopServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
19.         return;
20.       }
21.       // 执行正常业务
22.       console.info('stopServiceExtensionAbility succeed');
23.     });
24.   } catch (err) {
25.     // 处理入参错误异常
26.     let code = (err as BusinessError).code;
27.     let message = (err as BusinessError).message;
28.     console.error(`stopServiceExtensionAbility failed, code is ${code}, message is ${message}`);
29.   }
30. }
31. }

复制代码

UIAbilityContext.stopServiceExtensionAbility

stopServiceExtensionAbility(want: Want): Promise<void>
停止同一应用步伐内的服务（Promise情势）。
体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API: 此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是停止ServiceExtensionAbility的want信息。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000011The context does not exist.16000050Internal error.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import Want from '@ohos.app.ability.Want';
3. import { BusinessError } from '@ohos.base';
5. export default class EntryAbility extends UIAbility {
7. onForeground() {
8.   let want: Want = {
9.     deviceId: '',
10.     bundleName: 'com.example.myapplication',
11.     abilityName: 'ServiceExtensionAbility'
12.   };
14.   try {
15.     this.context.stopServiceExtensionAbility(want)
16.       .then(() => {
17.         // 执行正常业务
18.         console.info('stopServiceExtensionAbility succeed');
19.       })
20.       .catch((err: BusinessError) => {
21.         // 处理业务逻辑错误
22.         console.error(`stopServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
23.       });
24.   } catch (err) {
25.     // 处理入参错误异常
26.     let code = (err as BusinessError).code;
27.     let message = (err as BusinessError).message;
28.     console.error(`stopServiceExtensionAbility failed, code is ${code}, message is ${message}`);
29.   }
30. }
31. }

复制代码

UIAbilityContext.stopServiceExtensionAbilityWithAccount

stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback<void>): void
停止同一应用步伐内指定账户的服务（callback情势）。
   说明：
  当accountId为当前用户时，不需要校验该权限。
  需要权限: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API: 此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是停止ServiceExtensionAbility的want信息。accountIdnumber是体系帐号的帐号ID，详情参考getCreatedOsAccountsCount。callbackAsyncCallback<void>是停止ServiceExtensionAbility的回调函数。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000011The context does not exist.16000050Internal error.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import Want from '@ohos.app.ability.Want';
3. import { BusinessError } from '@ohos.base';
5. export default class EntryAbility extends UIAbility {
7.   onForeground() {
8.     let want: Want = {
9.       deviceId: '',
10.       bundleName: 'com.example.myapplication',
11.       abilityName: 'ServiceExtensionAbility'
12.     };
13.     let accountId = 100;
15.     try {
16.       this.context.stopServiceExtensionAbilityWithAccount(want, accountId, (err: BusinessError) => {
17.         if (err.code) {
18.           // 处理业务逻辑错误
19.           console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
20.           return;
21.         }
22.         // 执行正常业务
23.         console.info('stopServiceExtensionAbilityWithAccount succeed');
24.       });
25.     } catch (err) {
26.       // 处理入参错误异常
27.       let code = (err as BusinessError).code;
28.       let message = (err as BusinessError).message;
29.       console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${code}, message is ${message}`);
30.     }
31.   }
32. }

复制代码

UIAbilityContext.stopServiceExtensionAbilityWithAccount

stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise<void>
停止同一应用步伐内指定账户的服务（Promise情势）。
   说明：
  当accountId为当前用户时，不需要校验该权限。
  需要权限: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API: 此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是停止ServiceExtensionAbility的want信息。accountIdnumber是体系帐号的帐号ID，详情参考getCreatedOsAccountsCount。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000011The context does not exist.16000050Internal error.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import Want from '@ohos.app.ability.Want';
3. import { BusinessError } from '@ohos.base';
5. export default class EntryAbility extends UIAbility {
7.   onForeground() {
8.     let want: Want = {
9.       deviceId: '',
10.       bundleName: 'com.example.myapplication',
11.       abilityName: 'ServiceExtensionAbility'
12.     };
13.     let accountId = 100;
15.     try {
16.       this.context.stopServiceExtensionAbilityWithAccount(want, accountId)
17.         .then(() => {
18.           // 执行正常业务
19.           console.info('stopServiceExtensionAbilityWithAccount succeed');
20.         })
21.         .catch((err: BusinessError) => {
22.           // 处理业务逻辑错误
23.           console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
24.         });
25.     } catch (err) {
26.       // 处理入参错误异常
27.       let code = (err as BusinessError).code;
28.       let message = (err as BusinessError).message;
29.       console.error(`stopServiceExtensionAbilityWithAccount failed, code is ${code}, message is ${message}`);
30.     }
31.   }
32. }

复制代码

UIAbilityContext.terminateSelf

terminateSelf(callback: AsyncCallback<void>): void
停止Ability自身（callback情势）。
体系本领：SystemCapability.Ability.AbilityRuntime.Core
参数：
参数名类型必填说明callbackAsyncCallback<void>是停止Ability自身的回调函数。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000004Can not start invisible component.16000005The specified process does not have the permission.16000009An ability cannot be started or stopped in Wukong mode.16000011The context does not exist.16000050Internal error. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import { BusinessError } from '@ohos.base';
4. export default class EntryAbility extends UIAbility {
6.   onForeground() {
7.     try {
8.       this.context.terminateSelf((err: BusinessError) => {
9.         if (err.code) {
10.           // 处理业务逻辑错误
11.           console.error(`terminateSelf failed, code is ${err.code}, message is ${err.message}`);
12.           return;
13.         }
14.         // 执行正常业务
15.         console.info('terminateSelf succeed');
16.       });
17.     } catch (err) {
18.       // 捕获同步的参数错误
19.       let code = (err as BusinessError).code;
20.       let message = (err as BusinessError).message;
21.       console.error(`terminateSelf failed, code is ${code}, message is ${message}`);
22.     }
23.   }
24. }

复制代码

UIAbilityContext.terminateSelf

terminateSelf(): Promise<void>
停止Ability自身（promise情势）。
体系本领：SystemCapability.Ability.AbilityRuntime.Core
返回值：
类型说明Promise<void>停止Ability自身的回调函数。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000004Can not start invisible component.16000005The specified process does not have the permission.16000009An ability cannot be started or stopped in Wukong mode.16000011The context does not exist.16000050Internal error. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import { BusinessError } from '@ohos.base';
4. export default class EntryAbility extends UIAbility {
6.   onForeground() {
7.     try {
8.       this.context.terminateSelf()
9.         .then(() => {
10.           // 执行正常业务
11.           console.info('terminateSelf succeed');
12.         })
13.         .catch((err: BusinessError) => {
14.           // 处理业务逻辑错误
15.           console.error(`terminateSelf failed, code is ${err.code}, message is ${err.message}`);
16.         });
17.     } catch (err) {
18.       // 捕获同步的参数错误
19.       let code = (err as BusinessError).code;
20.       let message = (err as BusinessError).message;
21.       console.error(`terminateSelf failed, code is ${code}, message is ${message}`);
22.     }
23.   }
24. }

复制代码

UIAbilityContext.terminateSelfWithResult

terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback<void>): void
停止当前的Ability。如果该Ability是通过调用startAbilityForResult接口被拉起的，调用terminateSelfWithResult接口时会将效果返回给调用者，如果该Ability不是通过调用startAbilityForResult接口被拉起的，调用terminateSelfWithResult接口时不会有效果返回给调用者（callback情势）。
体系本领：SystemCapability.Ability.AbilityRuntime.Core
参数：
参数名类型必填说明parameterAbilityResult是返回给调用startAbilityForResult 接口调用方的相关信息。callbackAsyncCallback<void>是callback情势返回停止效果。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000004Can not start invisible component.16000005The specified process does not have the permission.16000009An ability cannot be started or stopped in Wukong mode.16000011The context does not exist.16000050Internal error. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import common from '@ohos.app.ability.common';
3. import Want from '@ohos.app.ability.Want';
4. import { BusinessError } from '@ohos.base';
6. export default class EntryAbility extends UIAbility {
8.   onForeground() {
9.     let want: Want = {
10.       bundleName: 'com.example.myapplication',
11.       abilityName: 'EntryAbility'
12.     };
13.     let resultCode = 100;
14.     // 返回给接口调用方AbilityResult信息
15.     let abilityResult: common.AbilityResult = {
16.       want,
17.       resultCode
18.     };
20.     try {
21.       this.context.terminateSelfWithResult(abilityResult, (err: BusinessError) => {
22.         if (err.code) {
23.           // 处理业务逻辑错误
24.           console.error(`terminateSelfWithResult failed, code is ${err.code}, message is ${err.message}`);
25.           return;
26.         }
27.         // 执行正常业务
28.         console.info('terminateSelfWithResult succeed');
29.       });
30.     } catch (err) {
31.       // 处理入参错误异常
32.       let code = (err as BusinessError).code;
33.       let message = (err as BusinessError).message;
34.       console.error(`terminateSelfWithResult failed, code is ${code}, message is ${message}`);
35.     }
36.   }
37. }

复制代码

UIAbilityContext.terminateSelfWithResult

terminateSelfWithResult(parameter: AbilityResult): Promise<void>
停止当前的Ability。如果该Ability是通过调用startAbilityForResult接口被拉起的，调用terminateSelfWithResult接口时会将效果返回给调用者，如果该Ability不是通过调用startAbilityForResult接口被拉起的，调用terminateSelfWithResult接口时不会有效果返回给调用者（promise情势）。
体系本领：SystemCapability.Ability.AbilityRuntime.Core
参数：
参数名类型必填说明parameterAbilityResult是返回给startAbilityForResult 调用方的信息。 返回值：
类型说明Promise<void>promise情势返回停止效果。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000004Can not start invisible component.16000005The specified process does not have the permission.16000009An ability cannot be started or stopped in Wukong mode.16000011The context does not exist.16000050Internal error. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import common from '@ohos.app.ability.common';
3. import Want from '@ohos.app.ability.Want';
4. import { BusinessError } from '@ohos.base';
6. export default class EntryAbility extends UIAbility {
8.   onForeground() {
9.     let want: Want = {
10.       bundleName: 'com.example.myapplication',
11.       abilityName: 'EntryAbility'
12.     };
13.     let resultCode = 100;
14.     // 返回给接口调用方AbilityResult信息
15.     let abilityResult: : common.AbilityResult = {
16.       want,
17.       resultCode
18.     };
20.     try {
21.       this.context.terminateSelfWithResult(abilityResult)
22.         .then(() => {
23.           // 执行正常业务
24.           console.info('terminateSelfWithResult succeed');
25.         })
26.         .catch((err: BusinessError) => {
27.           // 处理业务逻辑错误
28.           console.error(`terminateSelfWithResult failed, code is ${err.code}, message is ${err.message}`);
29.         });
30.     } catch (err) {
31.       // 处理入参错误异常
32.       let code = (err as BusinessError).code;
33.       let message = (err as BusinessError).message;
34.       console.error(`terminateSelfWithResult failed, code is ${code}, message is ${message}`);
35.     }
36.   }
37. }

复制代码

UIAbilityContext.connectServiceExtensionAbility

connectServiceExtensionAbility(want: Want, options: ConnectOptions): number
将当前Ability毗连到一个使用AbilityInfo.AbilityType.SERVICE模板的Ability。
体系本领：SystemCapability.Ability.AbilityRuntime.Core
参数：
参数名类型必填说明wantWant是毗连ServiceExtensionAbility的want信息。optionsConnectOptions是与ServiceExtensionAbility创建毗连后回调函数的实例。 返回值：
类型说明number返回Ability毗连的效果code。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16000011The context does not exist.16000050Internal error. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import common from '@ohos.app.ability.common';
3. import Want from '@ohos.app.ability.Want';
4. import { BusinessError } from '@ohos.base';
5. import rpc from '@ohos.rpc';
7. export default class EntryAbility extends UIAbility {
9.   onForeground() {
10.     let want: Want = {
11.       deviceId: '',
12.       bundleName: 'com.example.myapplication',
13.       abilityName: 'ServiceExtensionAbility'
14.     };
15.     let commRemote: rpc.IRemoteObject;
16.     let options: common.ConnectOptions = {
17.       onConnect(elementName, remote) {
18.         commRemote = remote;
19.         console.info('onConnect...')
20.       },
21.       onDisconnect(elementName) {
22.         console.info('onDisconnect...')
23.       },
24.       onFailed(code) {
25.         console.info('onFailed...')
26.       }
27.     };
28.     let connection: number;
29.     try {
30.       connection = this.context.connectServiceExtensionAbility(want, options);
31.     } catch (err) {
32.       // 处理入参错误异常
33.       let code = (err as BusinessError).code;
34.       let message = (err as BusinessError).message;
35.       console.error(`connectServiceExtensionAbility failed, code is ${code}, message is ${message}`);
36.     }
37.   }
38. }

复制代码

UIAbilityContext.connectServiceExtensionAbilityWithAccount

connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options: ConnectOptions): number
将当前Ability毗连到一个使用AbilityInfo.AbilityType.SERVICE模板的指定account的Ability。
   说明：
  当accountId为当前用户时，不需要校验该权限。
  需要权限： ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API: 此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是启动Ability的want信息。accountIdnumber是体系帐号的帐号ID，详情参考getCreatedOsAccountsCount。optionsConnectOptions是与ServiceExtensionAbility创建毗连后回调函数的实例。。 返回值：
类型说明number返回Ability毗连的效果code。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16000011The context does not exist.16000050Internal error. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import common from '@ohos.app.ability.common';
3. import Want from '@ohos.app.ability.Want';
4. import { BusinessError } from '@ohos.base';
5. import rpc from '@ohos.rpc';
7. export default class EntryAbility extends UIAbility {
9.   onForeground() {
10.     let want: Want = {
11.       deviceId: '',
12.       bundleName: 'com.example.myapplication',
13.       abilityName: 'ServiceExtensionAbility'
14.     };
15.     let accountId = 100;
16.     let commRemote: rpc.IRemoteObject;
17.     let options: common.ConnectOptions = {
18.       onConnect(elementName, remote) {
19.         commRemote = remote;
20.         console.info('onConnect...')
21.       },
22.       onDisconnect(elementName) {
23.         console.info('onDisconnect...')
24.       },
25.       onFailed(code) {
26.         console.info('onFailed...')
27.       }
28.     };
29.     let connection: number;
30.     try {
31.       connection = this.context.connectServiceExtensionAbilityWithAccount(want, accountId, options);
32.     } catch (err) {
33.       // 处理入参错误异常
34.       let code = (err as BusinessError).code;
35.       let message = (err as BusinessError).message;
36.       console.error(`connectServiceExtensionAbility failed, code is ${code}, message is ${message}`);
37.     }
38.   }
39. }

复制代码

UIAbilityContext.disconnectServiceExtensionAbility

disconnectServiceExtensionAbility(connection: number): Promise<void>
断开与ServiceExtensionAbility的毗连，断开毗连之后需要将毗连成功时返回的remote对象置空（promise情势）。
体系本领：SystemCapability.Ability.AbilityRuntime.Core
参数：
参数名类型必填说明connectionnumber是毗连的ServiceExtensionAbility的数字代码，即connectServiceExtensionAbility返回的connectionId。 返回值：
类型说明Promise<void>返回实行效果。 错误码：
错误码ID错误信息16000011The context does not exist.16000050Internal error. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import { BusinessError } from '@ohos.base';
3. import rpc from '@ohos.rpc';
5. export default class EntryAbility extends UIAbility {
7.   onForeground() {
8.     // connection为connectServiceExtensionAbility中的返回值
9.     let connection = 1;
10.     let commRemote: rpc.IRemoteObject | null;
12.     try {
13.       this.context.disconnectServiceExtensionAbility(connection).then(() => {
14.         commRemote = null;
15.         // 执行正常业务
16.         console.info('disconnectServiceExtensionAbility succeed');
17.       }).catch((err: BusinessError) => {
18.         // 处理业务逻辑错误
19.         console.error(`disconnectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
20.       })
21.     } catch (err) {
22.       commRemote = null;
23.       // 处理入参错误异常
24.       let code = (err as BusinessError).code;
25.       let message = (err as BusinessError).message;
26.       console.error(`disconnectServiceExtensionAbility failed, code is ${code}, message is ${message}`);
27.     }
28.   }
29. }

复制代码

UIAbilityContext.disconnectServiceExtensionAbility

disconnectServiceExtensionAbility(connection: number, callback: AsyncCallback<void>): void
断开与ServiceExtensionAbility的毗连，断开毗连之后需要将毗连成功时返回的remote对象置空（callback情势）。
体系本领：SystemCapability.Ability.AbilityRuntime.Core
参数：
参数名类型必填说明connectionnumber是毗连的ServiceExtensionAbility的数字代码，即connectServiceExtensionAbility返回的connectionId。callbackAsyncCallback<void>是callback情势返回断开毗连的效果。 错误码：
错误码ID错误信息16000011The context does not exist.16000050Internal error. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import { BusinessError } from '@ohos.base';
3. import rpc from '@ohos.rpc';
5. export default class EntryAbility extends UIAbility {
7.   onForeground() {
8.     // connection为connectServiceExtensionAbility中的返回值
9.     let connection = 1;
10.     let commRemote: rpc.IRemoteObject | null;
12.     try {
13.       this.context.disconnectServiceExtensionAbility(connection, (err: BusinessError) => {
14.         commRemote = null;
15.         if (err.code) {
16.           // 处理业务逻辑错误
17.           console.error(`disconnectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`);
18.           return;
19.         }
20.         // 执行正常业务
21.         console.info('disconnectServiceExtensionAbility succeed');
22.       });
23.     } catch (err) {
24.       commRemote = null;
25.       // 处理入参错误异常
26.       let code = (err as BusinessError).code;
27.       let message = (err as BusinessError).message;
28.       console.error(`disconnectServiceExtensionAbility failed, code is ${code}, message is ${message}`);
29.     }
30.   }
31. }

复制代码

UIAbilityContext.startAbilityByCall

startAbilityByCall(want: Want): Promise<Caller>
启动指定Ability至前台或后台，同时获取其Caller通信接口，调用方可使用Caller与被启动的Ability进行通信。
使用规则：

• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 同装备与跨装备场景下，该接口的使用规则存在差异，详见：组件启动规则（Stage模子）。
  

需要权限： ohos.permission.ABILITY_BACKGROUND_COMMUNICATION
体系本领：SystemCapability.Ability.AbilityRuntime.Core
参数：
参数名类型必填说明wantWant是传入需要启动的Ability的信息，包含abilityName、moduleName、bundleName、deviceId(可选)、parameters(可选)，此中deviceId缺省或为空表示启动本地Ability，parameters缺省或为空表示后台启动Ability。 返回值：
类型说明Promise<Caller>获取要通讯的caller对象。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：
后台启动：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import { Caller } from '@ohos.app.ability.UIAbility';
3. import Want from '@ohos.app.ability.Want';
4. import { BusinessError } from '@ohos.base';
6. export default class EntryAbility extends UIAbility {
8.   onForeground() {
9.     let caller: Caller;
11.     // 后台启动Ability，不配置parameters
12.     let wantBackground: Want = {
13.       bundleName: 'com.example.myapplication',
14.       moduleName: 'entry',
15.       abilityName: 'EntryAbility',
16.       deviceId: ''
17.     };
19.     try {
20.       this.context.startAbilityByCall(wantBackground)
21.         .then((obj: Caller) => {
22.           // 执行正常业务
23.           caller = obj;
24.           console.info('startAbilityByCall succeed');
25.         }).catch((err: BusinessError) => {
26.         // 处理业务逻辑错误
27.         console.error(`startAbilityByCall failed, code is ${err.code}, message is ${err.message}`);
28.       });
29.     } catch (err) {
30.       // 处理入参错误异常
31.       let code = (err as BusinessError).code;
32.       let message = (err as BusinessError).message;
33.       console.error(`startAbilityByCall failed, code is ${code}, message is ${message}`);
34.     }
35.   }
36. }

复制代码

前台启动：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import { Caller } from '@ohos.app.ability.UIAbility';
3. import Want from '@ohos.app.ability.Want';
4. import { BusinessError } from '@ohos.base';
6. export default class EntryAbility extends UIAbility {
8.   onForeground() {
9.     let caller: Caller;
11.     // 前台启动Ability，将parameters中的'ohos.aafwk.param.callAbilityToForeground'配置为true
12.     let wantForeground: Want = {
13.       bundleName: 'com.example.myapplication',
14.       moduleName: 'entry',
15.       abilityName: 'EntryAbility',
16.       deviceId: '',
17.       parameters: {
18.         'ohos.aafwk.param.callAbilityToForeground': true
19.       }
20.     };
22.     try {
23.       this.context.startAbilityByCall(wantForeground)
24.         .then((obj: Caller) => {
25.           // 执行正常业务
26.           caller = obj;
27.           console.info('startAbilityByCall succeed');
28.         }).catch((err: BusinessError) => {
29.         // 处理业务逻辑错误
30.         console.error(`startAbilityByCall failed, code is ${err.code}, message is ${err.message}`);
31.       });
32.     } catch (err) {
33.       // 处理入参错误异常
34.       let code = (err as BusinessError).code;
35.       let message = (err as BusinessError).message;
36.       console.error(`startAbilityByCall failed, code is ${code}, message is ${message}`);
37.     }
38.   }
39. }

复制代码

UIAbilityContext.startAbilityWithAccount

startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback<void>): void
根据want和accountId启动Ability（callback情势）。
使用规则：

• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 组件启动规则详见：组件启动规则（Stage模子）。
  

   说明：
  当accountId为当前用户时，不需要校验该权限。
  需要权限： ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API: 此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是启动Ability的want信息。accountIdnumber是体系帐号的帐号ID，详情参考getCreatedOsAccountsCount。callbackAsyncCallback<void>是启动Ability的回调函数。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000009An ability cannot be started or stopped in Wukong mode.16000010The call with the continuation flag is forbidden.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import Want from '@ohos.app.ability.Want';
3. import { BusinessError } from '@ohos.base';
5. export default class EntryAbility extends UIAbility {
7.   onForeground() {
8.     let want: Want = {
9.       deviceId: '',
10.       bundleName: 'com.example.myapplication',
11.       abilityName: 'EntryAbility'
12.     };
13.     let accountId = 100;
15.     try {
16.       this.context.startAbilityWithAccount(want, accountId, (err: BusinessError) => {
17.         if (err.code) {
18.           // 处理业务逻辑错误
19.           console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
20.           return;
21.         }
22.         // 执行正常业务
23.         console.info('startAbilityWithAccount succeed');
24.       });
25.     } catch (err) {
26.       // 处理入参错误异常
27.       let code = (err as BusinessError).code;
28.       let message = (err as BusinessError).message;
29.       console.error(`startAbilityWithAccount failed, code is ${code}, message is ${message}`);
30.     }
31.   }
32. }

复制代码

UIAbilityContext.startAbilityWithAccount

startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback<void>): void
根据want、accountId及startOptions启动Ability（callback情势）。
使用规则：

• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 组件启动规则详见：组件启动规则（Stage模子）。
  

   说明：
  当accountId为当前用户时，不需要校验该权限。
  需要权限： ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API: 此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是启动Ability的want信息。accountIdnumber是体系帐号的帐号ID，详情参考getCreatedOsAccountsCount。optionsStartOptions是启动Ability所携带的参数。callbackAsyncCallback<void>是启动Ability的回调函数。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000009An ability cannot be started or stopped in Wukong mode.16000010The call with the continuation flag is forbidden.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import Want from '@ohos.app.ability.Want';
3. import StartOptions from '@ohos.app.ability.StartOptions';
4. import { BusinessError } from '@ohos.base';
6. export default class EntryAbility extends UIAbility {
8.   onForeground() {
9.     let want: Want = {
10.       deviceId: '',
11.       bundleName: 'com.example.myapplication',
12.       abilityName: 'EntryAbility'
13.     };
14.     let accountId = 100;
15.     let options: StartOptions = {
16.       windowMode: 0
17.     };
19.     try {
20.       this.context.startAbilityWithAccount(want, accountId, options, (err: BusinessError) => {
21.         if (err.code) {
22.           // 处理业务逻辑错误
23.           console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
24.           return;
25.         }
26.         // 执行正常业务
27.         console.info('startAbilityWithAccount succeed');
28.       });
29.     } catch (err) {
30.       // 处理入参错误异常
31.       let code = (err as BusinessError).code;
32.       let message = (err as BusinessError).message;
33.       console.error(`startAbilityWithAccount failed, code is ${code}, message is ${message}`);
34.     }
35.   }
36. }

复制代码

UIAbilityContext.startAbilityWithAccount

startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): Promise<void>
根据want、accountId和startOptions启动Ability（Promise情势）。
使用规则：

• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 组件启动规则详见：组件启动规则（Stage模子）。
  

   说明：
  当accountId为当前用户时，不需要校验该权限。
  需要权限： ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API: 此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是启动Ability的want信息。accountIdnumber是体系帐号的帐号ID，详情参考getCreatedOsAccountsCount。optionsStartOptions否启动Ability所携带的参数。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000009An ability cannot be started or stopped in Wukong mode.16000010The call with the continuation flag is forbidden.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import Want from '@ohos.app.ability.Want';
3. import StartOptions from '@ohos.app.ability.StartOptions';
4. import { BusinessError } from '@ohos.base';
6. export default class EntryAbility extends UIAbility {
8.   onForeground() {
9.     let want: Want = {
10.       deviceId: '',
11.       bundleName: 'com.example.myapplication',
12.       abilityName: 'EntryAbility'
13.     };
14.     let accountId = 100;
15.     let options: StartOptions = {
16.       windowMode: 0
17.     };
19.     try {
20.       this.context.startAbilityWithAccount(want, accountId, options)
21.         .then(() => {
22.           // 执行正常业务
23.           console.info('startAbilityWithAccount succeed');
24.         })
25.         .catch((err: BusinessError) => {
26.           // 处理业务逻辑错误
27.           console.error(`startAbilityWithAccount failed, code is ${err.code}, message is ${err.message}`);
28.         });
29.     } catch (err) {
30.       // 处理入参错误异常
31.       let code = (err as BusinessError).code;
32.       let message = (err as BusinessError).message;
33.       console.error(`startAbilityWithAccount failed, code is ${code}, message is ${message}`);
34.     }
35.   }
36. }

复制代码

UIAbilityContext.setMissionLabel

setMissionLabel(label: string, callback: AsyncCallback<void>): void
设置UIAbility在任务中显示的名称（callback情势）。
体系本领：SystemCapability.Ability.AbilityRuntime.Core
参数：
参数名类型必填说明labelstring是显示名称。callbackAsyncCallback<void>是回调函数，返回接口调用是否成功的效果。 错误码：
错误码ID错误信息16000011The context does not exist.16000050Internal error. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import { BusinessError } from '@ohos.base';
4. export default class EntryAbility extends UIAbility {
6.   onCreate(want, launchParam) {
7.     this.context.setMissionLabel('test', (result: BusinessError) => {
8.       console.info(`setMissionLabel: ${JSON.stringify(result)}`);
9.     });
10.   }
11. }

复制代码

UIAbilityContext.setMissionLabel

setMissionLabel(label: string): Promise<void>
设置UIAbility在任务中显示的名称（promise情势）。
体系本领：SystemCapability.Ability.AbilityRuntime.Core
参数：
参数名类型必填说明labelstring是显示名称。 返回值：
类型说明Promise<void>返回一个Promise，包含接口的效果。 错误码：
错误码ID错误信息16000011The context does not exist.16000050Internal error. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import { BusinessError } from '@ohos.base';
4. export default class EntryAbility extends UIAbility {
6. onCreate(want, launchParam) {
7.   this.context.setMissionLabel('test').then(() => {
8.     console.info('success');
9.   }).catch((err: BusinessError) => {
10.     let code = (err as BusinessError).code;
11.     let message = (err as BusinessError).message;
12.     console.error(`setMissionLabel failed, code is ${code}, message is ${message}`);
13.   });
14. }
15. }

复制代码

UIAbilityContext.setMissionIcon

setMissionIcon(icon: image.PixelMap, callback: AsyncCallback<void>): void
设置当前ability在任务中显示的图标, 图标巨细最大为600M（callback情势）。
体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API: 此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明iconimage.PixelMap是在最近的任务中显示的ability图标。callbackAsyncCallback<void>是指定的回调函数的效果。 错误码：
错误码ID错误信息16000011The context does not exist.16000050Internal error. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import { BusinessError } from '@ohos.base';
3. import image from '@ohos.multimedia.image';
5. export default class EntryAbility extends UIAbility {
6.   onForeground() {
7.     let imagePixelMap: image.PixelMap;
8.     let color = new ArrayBuffer(0);
9.     image.createPixelMap(color, {
10.       size: {
11.         height: 100,
12.         width: 100
13.       }
14.     }).then((data) => {
15.       imagePixelMap = data;
16.       this.context.setMissionIcon(imagePixelMap, (err: BusinessError) => {
17.         console.error(`setMissionLabel failed, code is ${err.code}, message is ${err.message}`);
18.       })
19.     })
20.       .catch((err: BusinessError) => {
21.         console.error(`createPixelMap failed, code is ${err.code}, message is ${err.message}`);
22.       });
23.   }
24. }

复制代码

UIAbilityContext.setMissionIcon

setMissionIcon(icon: image.PixelMap): Promise<void>
设置当前ability在任务中显示的图标, 图标巨细最大为600M（promise情势）。
体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API: 此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明iconimage.PixelMap是在最近的任务中显示的ability图标。 返回值：
类型说明Promise<void>返回一个Promise，包含接口的效果。 错误码：
错误码ID错误信息16000011The context does not exist.16000050Internal error. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import { BusinessError } from '@ohos.base';
3. import image from '@ohos.multimedia.image';
5. export default class EntryAbility extends UIAbility {
6.   onForeground() {
7.     let imagePixelMap: image.PixelMap;
8.     let color = new ArrayBuffer(0);
9.     image.createPixelMap(color, {
10.       size: {
11.         height: 100,
12.         width: 100
13.       }
14.     }).then((data) => {
15.         imagePixelMap = data;
16.         this.context.setMissionIcon(imagePixelMap)
17.           .then(() => {
18.             console.info('setMissionIcon succeed');
19.           })
20.           .catch((err: BusinessError) => {
21.             console.error(`setMissionLabel failed, code is ${err.code}, message is ${err.message}`);
22.           });
23.       })
24.       .catch((err: BusinessError) => {
25.         console.error(`createPixelMap failed, code is ${err.code}, message is ${err.message}`);
26.       });
27.   }
28. }

复制代码

UIAbilityContext.setMissionContinueState10+

setMissionContinueState(state: AbilityConstant.ContinueState, callback: AsyncCallback<void>): void
设置UIAbility任务中流转状态（callback情势）。
体系本领：SystemCapability.Ability.AbilityRuntime.Core
参数：
参数名类型必填说明stateAbilityConstant.ContinueState是流转状态。callbackAsyncCallback<void>是回调函数，返回接口调用是否成功的效果。 错误码：
错误码ID错误信息16000011The context does not exist.16000050Internal error. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import AbilityConstant from '@ohos.app.ability.AbilityConstant';
3. import { BusinessError } from '@ohos.base';
5. export default class EntryAbility extends UIAbility {
6.   onForeground() {
7.     this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE, (result: BusinessError) => {
8.       console.info(`setMissionContinueState: ${JSON.stringify(result)}`);
9.     });
10.   }
11. }

复制代码

UIAbilityContext.setMissionContinueState10+

setMissionContinueState(state: AbilityConstant.ContinueState): Promise<void>
设置UIAbility任务中流转状态（promise情势）。
体系本领：SystemCapability.Ability.AbilityRuntime.Core
参数：
参数名类型必填说明stateAbilityConstant.ContinueState是流转状态。 返回值：
类型说明Promise<void>返回一个Promise，包含接口的效果。 错误码：
错误码ID错误信息16000011The context does not exist.16000050Internal error. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import AbilityConstant from '@ohos.app.ability.AbilityConstant';
3. import { BusinessError } from '@ohos.base';
5. export default class EntryAbility extends UIAbility {
6.   onForeground() {
7.     this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE).then(() => {
8.       console.info('success');
9.     }).catch((err: BusinessError) => {
10.       console.error(`setMissionContinueState failed, code is ${err.code}, message is ${err.message}`);
11.     });
12.   }
13. }

复制代码

UIAbilityContext.restoreWindowStage

restoreWindowStage(localStorage: LocalStorage): void
规复UIAbility中的WindowStage数据。
体系本领：SystemCapability.Ability.AbilityRuntime.Core
参数：
参数名类型必填说明localStorageLocalStorage是用于规复window stage的存储数据。 错误码：
错误码ID错误信息16000011The context does not exist.16000050Internal error. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
3. export default class EntryAbility extends UIAbility {
4.   onForeground() {
5.     let storage = new LocalStorage();
6.     this.context.restoreWindowStage(storage);
7.   }
8. }

复制代码

UIAbilityContext.isTerminating

isTerminating(): boolean
查询UIAbility是否在terminating状态。
体系本领：SystemCapability.Ability.AbilityRuntime.Core
返回值：
类型说明booltrue：ability当前处于terminating状态；false：不处于terminating状态。 错误码：
错误码ID错误信息16000011The context does not exist. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
3. export default class EntryAbility extends UIAbility {
4.   onForeground() {
5.     let isTerminating: boolean = this.context.isTerminating();
6.     console.info(`ability state is ${isTerminating}`);
7.   }
8. }

复制代码

UIAbilityContext.requestDialogService

requestDialogService(want: Want, result: AsyncCallback<dialogRequest.RequestResult>): void
启动一个支持模态弹框的ServiceExtensionAbility。ServiceExtensionAbility被启动后，应用弹出模态弹框，通过调用setRequestResult接口返回效果给调用者。
使用规则：

• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 组件启动规则详见：组件启动规则（Stage模子）。
  

体系本领：SystemCapability.Ability.AbilityRuntime.Core
参数：
参数名类型必填说明wantWant是启动ServiceExtensionAbility的want信息。resultAsyncCallback<dialogRequest.RequestResult>是实行效果回调函数。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000009An ability cannot be started or stopped in Wukong mode.16000010The call with the continuation flag is forbidden.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import dialogRequest from '@ohos.app.ability.dialogRequest';
3. import Want from '@ohos.app.ability.Want';
4. import { BusinessError } from '@ohos.base';
6. export default class EntryAbility extends UIAbility {
7.   onForeground() {
8.     let want: Want = {
9.       deviceId: '',
10.       bundleName: 'com.example.myapplication',
11.       abilityName: 'AuthAccountServiceExtension'
12.     };
14.     try {
15.       this.context.requestDialogService(want, (err: BusinessError, result: dialogRequest.RequestResult) => {
16.         if (err.code) {
17.           // 处理业务逻辑错误
18.           console.error(`requestDialogService failed, code is ${err.code}, message is ${err.message}`);
19.           return;
20.         }
21.         // 执行正常业务
22.         console.info(`requestDialogService succeed, result = ${JSON.stringify(result)}`);
23.       });
24.     } catch (err) {
25.       // 处理入参错误异常
26.       let code = (err as BusinessError).code;
27.       let message = (err as BusinessError).message;
28.       console.error(`requestDialogService failed, code is ${code}, message is ${message}`);
29.     }
30.   }
31. }

复制代码

UIAbilityContext.requestDialogService

requestDialogService(want: Want): Promise<dialogRequest.RequestResult>
启动一个支持模态弹框的ServiceExtensionAbility。ServiceExtensionAbility被启动后，应用弹出模态弹框，通过调用setRequestResult接口返回效果给调用者（promise情势）。
使用规则：

• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 组件启动规则详见：组件启动规则（Stage模子）。
  

体系本领：SystemCapability.Ability.AbilityRuntime.Core
参数：
参数名类型必填说明wantWant是启动ServiceExtensionAbility的want信息。 返回值：
类型说明Promise<dialogRequest.RequestResult>Promise情势返回实行效果。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000009An ability cannot be started or stopped in Wukong mode.16000010The call with the continuation flag is forbidden.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import dialogRequest from '@ohos.app.ability.dialogRequest';
3. import Want from '@ohos.app.ability.Want';
4. import { BusinessError } from '@ohos.base';
6. export default class EntryAbility extends UIAbility {
8.   onForeground() {
9.     let want: Want = {
10.       bundleName: 'com.example.myapplication',
11.       abilityName: 'AuthAccountServiceExtension'
12.     };
14.     try {
15.       this.context.requestDialogService(want)
16.         .then((result: dialogRequest.RequestResult) => {
17.           // 执行正常业务
18.           console.info(`requestDialogService succeed, result = ${JSON.stringify(result)}`);
19.         })
20.         .catch((err: BusinessError) => {
21.           // 处理业务逻辑错误
22.           console.error(`requestDialogService failed, code is ${err.code}, message is ${err.message}`);
23.         });
24.     } catch (err) {
25.       // 处理入参错误异常
26.       let code = (err as BusinessError).code;
27.       let message = (err as BusinessError).message;
28.       console.error(`requestDialogService failed, code is ${code}, message is ${message}`);
29.     }
30.   }
31. }

复制代码

UIAbilityContext.startRecentAbility

startRecentAbility(want: Want, callback: AsyncCallback<void>): void
启动一个指定的Ability，如果这个Ability有多个实例，将拉起最近启动的谁人实例。启动效果以callback的情势返回开发者。
使用规则：

• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 组件启动规则详见：组件启动规则（Stage模子）。
  

体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API: 此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是需要启动Ability的want信息。callbackAsyncCallback<void>是指定的回调函数的效果。 错误码：
以下错误码的详细介绍请参见元本领子体系错误码。
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000009An ability cannot be started or stopped in Wukong mode.16000010The call with the continuation flag is forbidden.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16200001The caller has been released. 示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import Want from '@ohos.app.ability.Want';
3. import { BusinessError } from '@ohos.base';
5. export default class EntryAbility extends UIAbility {
7.   onForeground() {
8.     let want: Want = {
9.       bundleName: 'com.example.myapplication',
10.       abilityName: 'EntryAbility'
11.     };
13.     try {
14.       this.context.startRecentAbility(want, (err: BusinessError) => {
15.         if (err.code) {
16.           // 处理业务逻辑错误
17.           console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`);
18.           return;
19.         }
20.         // 执行正常业务
21.         console.info('startRecentAbility succeed');
22.       });
23.     } catch (err) {
24.       // 处理入参错误异常
25.       let code = (err as BusinessError).code;
26.       let message = (err as BusinessError).message;
27.       console.error(`startRecentAbility failed, code is ${code}, message is ${message}`);
28.     }
29.   }
30. }

复制代码

UIAbilityContext.startRecentAbility

startRecentAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>): void
启动一个指定的Ability，如果这个Ability有多个实例，将拉起最近启动的谁人实例。启动效果以callback的情势返回开发者。 当开发者需要携带启动参数时可以选择此API。
使用规则：

• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 组件启动规则详见：组件启动规则（Stage模子）。
  

体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API: 此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是需要启动Ability的want信息。optionsStartOptions是启动Ability所携带的参数。callbackAsyncCallback<void>是指定的回调函数的效果。 错误码：
以下错误码的详细介绍请参见元本领子体系错误码。
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000009An ability cannot be started or stopped in Wukong mode.16000010The call with the continuation flag is forbidden.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16200001The caller has been released. 示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import Want from '@ohos.app.ability.Want';
3. import StartOptions from '@ohos.app.ability.StartOptions';
4. import { BusinessError } from '@ohos.base';
6. export default class EntryAbility extends UIAbility {
8.   onForeground() {
9.     let want: Want = {
10.       deviceId: '',
11.       bundleName: 'com.example.myapplication',
12.       abilityName: 'EntryAbility'
13.     };
14.     let options: StartOptions = {
15.       windowMode: 0
16.     };
18.     try {
19.       this.context.startRecentAbility(want, options, (err: BusinessError) => {
20.         if (err.code) {
21.           // 处理业务逻辑错误
22.           console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`);
23.           return;
24.         }
25.         // 执行正常业务
26.         console.info('startRecentAbility succeed');
27.       });
28.     } catch (err) {
29.       // 处理入参错误异常
30.       let code = (err as BusinessError).code;
31.       let message = (err as BusinessError).message;
32.       console.error(`startRecentAbility failed, code is ${code}, message is ${message}`);
33.     }
34.   }
35. }

复制代码

UIAbilityContext.startRecentAbility

startRecentAbility(want: Want, options?: StartOptions): Promise<void>
启动一个指定的Ability，如果这个Ability有多个实例，将拉起最近启动的谁人实例。 当开发者期望启动效果以Promise情势返回时可以选择此API。
使用规则：

• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 组件启动规则详见：组件启动规则（Stage模子）。
  

体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API: 此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是需要启动Ability的want信息。optionsStartOptions否启动Ability所携带的参数。 错误码：
以下错误码的详细介绍请参见元本领子体系错误码。
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000009An ability cannot be started or stopped in Wukong mode.16000010The call with the continuation flag is forbidden.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16200001The caller has been released. 示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import Want from '@ohos.app.ability.Want';
3. import StartOptions from '@ohos.app.ability.StartOptions';
4. import { BusinessError } from '@ohos.base';
6. export default class EntryAbility extends UIAbility {
8.   onForeground() {
9.     let want: Want = {
10.       bundleName: 'com.example.myapplication',
11.       abilityName: 'EntryAbility'
12.     };
13.     let options: StartOptions = {
14.       windowMode: 0,
15.     };
17.     try {
18.       this.context.startRecentAbility(want, options)
19.         .then(() => {
20.           // 执行正常业务
21.           console.info('startRecentAbility succeed');
22.         })
23.         .catch((err: BusinessError) => {
24.           // 处理业务逻辑错误
25.           console.error(`startRecentAbility failed, code is ${err.code}, message is ${err.message}`);
26.         });
27.     } catch (err) {
28.       // 处理入参错误异常
29.       let code = (err as BusinessError).code;
30.       let message = (err as BusinessError).message;
31.       console.error(`startRecentAbility failed, code is ${code}, message is ${message}`);
32.     }
33.   }
34. }

复制代码

UIAbilityContext.startAbilityByCallWithAccount10+

startAbilityByCallWithAccount(want: Want, accountId: number): Promise<Caller>
根据accountId对指定的Ability进行call调用，并且可以使用返回的Caller通信接口与被调用方进行通信。
使用规则：

• 跨用户场景下，Call调用目标Ability时，调用方应用需同时申请与权限。ohos.permission.ABILITY_BACKGROUND_COMMUNICATIONohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
  
• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 同装备与跨装备场景下，该接口的使用规则存在差异，详见：组件启动规则（Stage模子）。
  

需要权限: ohos.permission.ABILITY_BACKGROUND_COMMUNICATION, ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API：此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是传入需要启动的Ability的信息，包含abilityName、moduleName、bundleName、deviceId(可选)、parameters(可选)，此中deviceId缺省或为空表示启动本地Ability，parameters缺省或为空表示后台启动Ability。accountIdnumber是体系帐号的帐号ID，-1表示当前活动用户，详情参考getCreatedOsAccountsCount。 返回值：
类型说明Promise<Caller>获取要通讯的caller对象。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005Static permission denied. The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16200001The caller has been released. 以上错误码详细介绍请参考元本领子体系错误码。
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import { Caller } from '@ohos.app.ability.UIAbility';
3. import Want from '@ohos.app.ability.Want';
4. import { BusinessError } from '@ohos.base';
6. export default class EntryAbility extends UIAbility {
8.   onForeground() {
9.     let caller: Caller;
11.     // 系统账号的账号ID, -1表示当前激活用户
12.     let accountId = -1;
14.     // 指定启动的Ability
15.     let want: Want = {
16.       bundleName: 'com.acts.actscalleeabilityrely',
17.       moduleName: 'entry',
18.       abilityName: 'EntryAbility',
19.       deviceId: '',
20.       parameters: {
21.         // 'ohos.aafwk.param.callAbilityToForeground' 值设置为true时为前台启动, 设置false或不设置为后台启动
22.         'ohos.aafwk.param.callAbilityToForeground': true
23.       }
24.     };
26.     try {
27.       this.context.startAbilityByCallWithAccount(want, accountId)
28.         .then((obj: Caller) => {
29.           // 执行正常业务
30.           caller = obj;
31.           console.log('startAbilityByCallWithAccount succeed');
32.         }).catch((error: BusinessError) => {
33.         // 处理业务逻辑错误
34.         console.error('startAbilityByCallWithAccount failed, error.code: ${error.code}, error.message: ${error.message}');
35.       });
36.     } catch (paramError) {
37.       // 处理入参错误异常
38.       console.error('error.code: ${paramError.code}, error.message: ${paramError.message}');
39.     }
40.   }
41. }

复制代码

UIAbilityContext.startAbilityAsCaller10+

startAbilityAsCaller(want: Want, callback: AsyncCallback<void>): void
使用设置的caller信息启动一个Ability，caller信息由want携带，在体系服务层辨认，Ability可以在onCreate生命周期的want参数中获取到caller信息。使用该接口启动一个Ability时，want的caller信息不会被当前自身的应用信息覆盖，体系服务层可获取到初始caller的信息。使用callback异步回调。
使用规则：

• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 组件启动规则详见：组件启动规则（Stage模子）。
  

体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API：此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是启动Ability的want信息。callbackAsyncCallback<void>是回调函数。当启动Ability成功，err为undefined，否则为错误对象。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000009An ability cannot be started or stopped in Wukong mode.16000010The call with the continuation flag is forbidden.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import AbilityConstant from '@ohos.app.ability.AbilityConstant';
3. import Want from '@ohos.app.ability.Want';
5. export default class EntryAbility extends UIAbility {
6.   onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
7.     // want包含启动该应用的Caller信息
8.     let localWant: Want = want;
9.     localWant.bundleName = 'com.example.demo';
10.     localWant.moduleName = 'entry';
11.     localWant.abilityName = 'TestAbility';
13.     // 使用启动方的Caller身份信息启动新Ability
14.     this.context.startAbilityAsCaller(localWant, (err) => {
15.       if (err && err.code != 0) {
16.         console.error('startAbilityAsCaller failed, err:' + JSON.stringify(err));
17.       } else {
18.         console.log('startAbilityAsCaller success.');
19.       }
20.     })
21.   }
22. }

复制代码

UIAbilityContext.startAbilityAsCaller10+

startAbilityAsCaller(want: Want, options: StartOptions, callback: AsyncCallback<void>): void
使用设置的caller信息启动一个Ability，caller信息由want携带，在体系服务层辨认，Ability可以在onCreate生命周期的want参数中获取到caller信息。使用该接口启动一个Ability时，want的caller信息不会被当前自身的应用信息覆盖，体系服务层可获取到初始caller的信息。使用callback异步回调。
使用规则：

• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 组件启动规则详见：组件启动规则（Stage模子）。
  

体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API：此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是启动Ability的want信息。optionsStartOptions是启动Ability所携带的参数。callbackAsyncCallback<void>是回调函数。当启动Ability成功，err为undefined，否则为错误对象。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000009An ability cannot be started or stopped in Wukong mode.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import AbilityConstant from '@ohos.app.ability.AbilityConstant';
3. import StartOptions from '@ohos.app.ability.StartOptions';
4. import Want from '@ohos.app.ability.Want';
6. export default class EntryAbility extends UIAbility {
7.   onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
8.     // want包含启动该应用的Caller信息
9.     let localWant: Want = want;
10.     localWant.bundleName = 'com.example.demo';
11.     localWant.moduleName = 'entry';
12.     localWant.abilityName = 'TestAbility';
14.     let option: StartOptions = {
15.       displayId: 0
16.     }
18.     // 使用启动方的Caller身份信息启动新Ability
19.     this.context.startAbilityAsCaller(localWant, option, (err) => {
20.       if (err && err.code != 0) {
21.         console.error('startAbilityAsCaller failed, err:' + JSON.stringify(err));
22.       } else {
23.         console.log('startAbilityAsCaller success.');
24.       }
25.     })
26.   }
27. }

复制代码

UIAbilityContext.startAbilityAsCaller10+

startAbilityAsCaller(want: Want, options?: StartOptions): Promise<void>
使用设置的caller信息启动一个Ability，caller信息由want携带，在体系服务层辨认，Ability可以在onCreate生命周期的want参数中获取到caller信息。使用该接口启动一个Ability时，want的caller信息不会被当前自身的应用信息覆盖，体系服务层可获取到初始caller的信息。使用Promise异步回调。
使用规则：

• 调用方应用位于后台时，使用该接口启动Ability需申请权限。ohos.permission.START_ABILITIES_FROM_BACKGROUND
  
• 跨应用场景下，目标Ability的exported属性若设置为false，调用方应用需申请权限。ohos.permission.START_INVISIBLE_ABILITY
  
• 组件启动规则详见：组件启动规则（Stage模子）。
  

体系本领：SystemCapability.Ability.AbilityRuntime.Core
体系API：此接口为体系接口，三方应用不支持调用。
参数：
参数名类型必填说明wantWant是启动Ability的want信息。optionsStartOptions否启动Ability所携带的参数。 返回值：
类型说明Promise<void>Promise对象。无返回效果的Promise对象。 错误码：
错误码ID错误信息16000001The specified ability does not exist.16000002Incorrect ability type.16000004Can not start invisible component.16000005The specified process does not have the permission.16000006Cross-user operations are not allowed.16000008The crowdtesting application expires.16000009An ability cannot be started or stopped in Wukong mode.16000010The call with the continuation flag is forbidden.16000011The context does not exist.16000012The application is controlled.16000013The application is controlled by EDM.16000050Internal error.16000053The ability is not on the top of the UI.16000055Installation-free timed out.16200001The caller has been released. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import AbilityConstant from '@ohos.app.ability.AbilityConstant';
3. import StartOptions from '@ohos.app.ability.StartOptions';
4. import Want from '@ohos.app.ability.Want';
5. import { BusinessError } from '@ohos.base';
7. export default class EntryAbility extends UIAbility {
8.   onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
9.     // want包含启动该应用的Caller信息
10.     let localWant: Want = want;
11.     localWant.bundleName = 'com.example.demo';
12.     localWant.moduleName = 'entry';
13.     localWant.abilityName = 'TestAbility';
15.     let option: StartOptions = {
16.       displayId: 0
17.     }
19.     // 使用启动方的Caller身份信息启动新Ability
20.     this.context.startAbilityAsCaller(localWant, option)
21.       .then(() => {
22.         console.log('startAbilityAsCaller success.');
23.       })
24.       .catch((err: BusinessError) => {
25.         console.error('startAbilityAsCaller failed, err:' + JSON.stringify(err));
26.       })
27.   }
28. }

复制代码

UIAbilityContext.reportDrawnCompleted10+

reportDrawnCompleted(callback: AsyncCallback<void>): void
当页面加载完成（loadContent成功）时，为开发者提供打点功能（callback情势）。 体系本领：SystemCapability.Ability.AbilityRuntime.Core
参数：
参数名类型必填说明callbackAsyncCallback<void>是页面加载完成打点的回调函数。 错误码：
错误码ID错误信息16000011The context does not exist.16000050Internal error. 错误码详细介绍请参考元本领子体系错误码
示例：

1. import UIAbility from '@ohos.app.ability.UIAbility';
2. import window from '@ohos.window';
3. import { BusinessError } from '@ohos.base';
5. export default class EntryAbility extends UIAbility {
6. onWindowStageCreate(windowStage: window.WindowStage) {
7.   windowStage.loadContent('pages/Index', (err, data) => {
8.     if (err.code) {
9.       return;
10.     }
11.     try {
12.       this.context.reportDrawnCompleted((err) => {
13.         if (err.code) {
14.           // 处理业务逻辑错误
15.           console.error(`reportDrawnCompleted failed, code is ${err.code}, message is ${err.message}`);
16.           return;
17.         }
18.         // 执行正常业务
19.         console.info('reportDrawnCompleted succeed');
20.       });
21.     } catch (err) {
22.       // 捕获同步的参数错误
23.       let code = (err as BusinessError).code;
24.       let message = (err as BusinessError).message;
25.       console.error(`reportDrawnCompleted failed, code is ${code}, message is ${message}`);
26.     }
27.   });
28.   console.log("MainAbility onWindowStageCreate")
29. }
30. };

复制代码

末了

有很多小伙伴不知道学习哪些鸿蒙开发技能？不知道需要重点把握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。以是有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。 
这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必把握的焦点知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模子、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技能、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技能知识点。
渴望这一份鸿蒙学习资料可以或许给大家带来资助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！
获取这份完备版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料
鸿蒙（HarmonyOS NEXT）最新学习路线

•  HarmonOS底子技能
  

• HarmonOS就业必备技能 
  
  
  
•  HarmonOS多媒体技能
  

• 鸿蒙NaPi组件进阶
  

• HarmonOS高级技能
  

• 初识HarmonOS内核 
  
  
  
• 实战就业级装备开发
  

有了路线图，怎么能没有学习资料呢，小编也准备了一份团结鸿蒙官方发布条记整理收纳的一套体系性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模子、资源分类…等知识点。
获取以上完备版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料
《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

《鸿蒙 (OpenHarmony)开发底子到实战手册》

OpenHarmony北向、南向开发环境搭建

 《鸿蒙开发底子》

• ArkTS语言
  
• 安装DevEco Studio
  
• 运用你的第一个ArkTS应用
  
• ArkUI声明式UI开发
  
• .……
  

 《鸿蒙开发进阶》

• Stage模子入门
  
• 网络管理
  
• 数据管理
  
• 电话服务
  
• 分布式应用开发
  
• 关照与窗口管理
  
• 多媒体技能
  
• 安全技能
  
• 任务管理
  
• WebGL
  
• 国际化开发
  
• 应用测试
  
• DFX面向将来设计
  
• 鸿蒙体系移植和裁剪定制
  
• ……
  

《鸿蒙进阶实战》

• ArkTS实践
  
• UIAbility应用
  
• 网络案例
  
• ……
  

 获取以上完备鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料
总结

总的来说，华为鸿蒙不再兼容安卓，对中年步伐员来说是一个挑衅，也是一个时机。只有积极应对变革，不断学习和提升自己，他们才气在这个变革的时代中立于不败之地。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。