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