• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# AbilityStage
2
3> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
4>
5> 本模块首批接口从API version 9开始支持。API 9当前为Canary版本,仅供使用,不保证接口可稳定调用。
6
7
8
9AbilityStage是HAP包的运行时类。在HAP加载的时候,通知开发者,开发者可以在此进行该HAP的初始化(如资源预加载,线程创建等)。
10
11
12## 导入模块
13
14
15```js
16import AbilityStage from '@ohos.application.AbilityStage';
17```
18
19## AbilityStage.onCreate
20
21onCreate(): void
22
23当应用创建时调用。
24
25**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
26
27
28
29**示例:**
30
31  ```js
32  class MyAbilityStage extends AbilityStage {
33      onCreate() {
34          console.log("MyAbilityStage.onCreate is called")
35      }
36  }
37  ```
38
39
40## AbilityStage.onAcceptWant
41
42onAcceptWant(want: Want): string;
43
44启动一个specified ability时触发的事件。
45
46**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
47
48**参数:**
49
50  | 参数名 | 类型 | 必填 | 说明 |
51  | -------- | -------- | -------- | -------- |
52  | want | [Want](js-apis-featureAbility.md#Want类型说明) | 是 | Want类型参数,传入需要启动的ability的信息,如ability名称,包名等。 |
53
54**返回值:**
55
56  | 类型 | 说明 |
57  | -------- | -------- |
58  | string | 用户返回一个ability标识,如果之前启动过次标识的ability,不创建新的实例并拉回栈顶,否则创建新的实例并启动。 |
59
60**示例:**
61
62  ```js
63  class MyAbilityStage extends AbilityStage {
64      onAcceptWant(want) {
65          console.log("MyAbilityStage.onAcceptWant called");
66          return "com.example.test";
67      }
68  }
69  ```
70
71
72## AbilityStage.onConfigurationUpdated
73
74onConfigurationUpdated(config: Configuration): void;
75
76环境变化通知接口,发生全局配置变更时回调。
77
78**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
79
80**参数:**
81
82  | 参数名 | 类型 | 必填 | 说明 |
83  | -------- | -------- | -------- | -------- |
84  | config | [Configuration](js-apis-configuration.md) | 是 | 发生全局配置变更时触发回调,当前全局配置包括系统语言、深浅色模式。 |
85
86**示例:**
87
88  ```js
89  class MyAbilityStage extends AbilityStage {
90      onConfigurationUpdated(config) {
91          console.log('onConfigurationUpdated, language:' + config.language);
92      }
93  }
94  ```
95## AbilityStage.context
96
97指示有关上下文的配置信息。
98
99**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
100
101| 属性名      | 类型                        | 说明                                                         |
102| ----------- | --------------------------- | ------------------------------------------------------------ |
103| context  | [AbilityStageContext](js-apis-featureAbility.md) | 在启动能力阶段进行初始化时回调。 |
104