• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.application.abilityDelegatorRegistry (AbilityDelegatorRegistry)
2
3AbilityDelegatorRegistry模块提供用于存储已注册的AbilityDelegator和AbilityDelegatorArgs对象的全局寄存器的能力，包括获取应用程序的AbilityDelegator对象、获取单元测试参数AbilityDelegatorArgs对象。该模块中的接口只能用于测试框架中。
4
5> **说明：**
6>
7> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8
9## 导入模块
10
11```ts
12import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'
13```
14
15## AbilityLifecycleState
16
17Ability生命周期状态。
18
19**系统能力** ：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
20
21| 名称          | 值   | 说明                        |
22| ------------- | ---- | --------------------------- |
23| UNINITIALIZED | 0    | 表示无效状态。              |
24| CREATE        | 1    | 表示Ability处于已创建状态。 |
25| FOREGROUND    | 2    | 表示Ability处于前台状态。   |
26| BACKGROUND    | 3    | 表示Ability处于后台状态。   |
27| DESTROY       | 4    | 表示Ability处于已销毁状态。 |
28
29## AbilityDelegatorRegistry.getAbilityDelegator
30
31getAbilityDelegator(): AbilityDelegator
32
33获取应用程序的AbilityDelegator对象
34
35**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
36
37**返回值：**
38
39| 类型                                                         | 说明                                                         |
40| ------------------------------------------------------------ | ------------------------------------------------------------ |
41| [AbilityDelegator](js-apis-inner-application-abilityDelegator.md#AbilityDelegator) | [AbilityDelegator](js-apis-inner-application-abilityDelegator.md#AbilityDelegator)对象。可以用来调度测试框架相关功能。 |
42
43**示例：**
44
45```ts
46let abilityDelegator;
47
48abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
49```
50
51## AbilityDelegatorRegistry.getArguments
52
53getArguments(): AbilityDelegatorArgs
54
55获取单元测试参数AbilityDelegatorArgs对象
56
57**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
58
59**返回值：**
60
61| 类型                                                         | 说明                                                         |
62| ------------------------------------------------------------ | ------------------------------------------------------------ |
63| [AbilityDelegatorArgs](js-apis-inner-application-abilityDelegatorArgs.md#AbilityDelegatorArgs) | [AbilityDelegatorArgs](js-apis-inner-application-abilityDelegatorArgs.md#AbilityDelegatorArgs)对象。可以用来获取测试参数。 |
64
65**示例：**
66
67```ts
68let args = AbilityDelegatorRegistry.getArguments();
69console.info('getArguments bundleName:' + args.bundleName);
70console.info('getArguments testCaseNames:' + args.testCaseNames);
71console.info('getArguments testRunnerClassName:' + args.testRunnerClassName);
72```
73