• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# UIAbility组件基本用法
2
3
4UIAbility组件的基本用法包括:指定UIAbility的启动页面以及获取UIAbility的上下文[UIAbilityContext](../reference/apis/js-apis-inner-application-uiAbilityContext.md)。
5
6
7## 指定UIAbility的启动页面
8
9应用中的UIAbility在启动过程中,需要指定启动页面,否则应用启动后会因为没有默认加载页面而导致白屏。可以在UIAbility的`onWindowStageCreate()`生命周期回调中,通过[WindowStage](../reference/apis/js-apis-window.md#windowstage9)对象的`loadContent()`方法设置启动页面。
10
11
12```ts
13import UIAbility from '@ohos.app.ability.UIAbility';
14import window from '@ohos.window';
15
16export default class EntryAbility extends UIAbility {
17  onWindowStageCreate(windowStage: window.WindowStage) {
18    // Main window is created, set main page for this ability
19    windowStage.loadContent('pages/Index', (err, data) => {
20      // ...
21    });
22  }
23
24  // ...
25}
26```
27
28> **说明:**
29> 在DevEco Studio中创建的UIAbility中,该UIAbility实例默认会加载Index页面,根据需要将Index页面路径替换为需要的页面路径即可。
30
31
32## 获取UIAbility的上下文信息
33
34UIAbility类拥有自身的上下文信息,该信息为[UIAbilityContext](../reference/apis/js-apis-inner-application-uiAbilityContext.md)类的实例,[UIAbilityContext](../reference/apis/js-apis-inner-application-uiAbilityContext.md)类拥有abilityInfo、currentHapModuleInfo等属性。通过UIAbilityContext可以获取UIAbility的相关配置信息,如包代码路径、Bundle名称、Ability名称和应用程序需要的环境状态等属性信息,以及可以获取操作UIAbility实例的方法(如`startAbility()`、`connectServiceExtensionAbility()`、`terminateSelf()`等)。
35
36- 在UIAbility中可以通过`this.context`获取UIAbility实例的上下文信息。
37
38  ```ts
39  import UIAbility from '@ohos.app.ability.UIAbility';
40  import AbilityConstant from '@ohos.app.ability.AbilityConstant';
41  import Want from '@ohos.app.ability.Want';
42
43  export default class EntryAbility extends UIAbility {
44    onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
45      // 获取UIAbility实例的上下文
46      let context = this.context;
47      ...
48    }
49  }
50  ```
51
52- 在页面中获取UIAbility实例的上下文信息,包括导入依赖资源context模块和在组件中定义一个context变量两个部分。
53
54  ```ts
55  import common from '@ohos.app.ability.common';
56  import Want from '@ohos.app.ability.Want';
57
58  @Entry
59  @Component
60  struct Index {
61    private context = getContext(this) as common.UIAbilityContext;
62
63    startAbilityTest() {
64      let want: Want = {
65        // Want参数信息
66      };
67      this.context.startAbility(want);
68    }
69
70    // 页面展示
71    build() {
72      ...
73    }
74  }
75  ```
76
77  也可以在导入依赖资源context模块后,在具体使用[UIAbilityContext](../reference/apis/js-apis-inner-application-uiAbilityContext.md)前进行变量定义。
78
79
80  ```ts
81  import common from '@ohos.app.ability.common';
82  import Want from '@ohos.app.ability.Want';
83
84  @Entry
85  @Component
86  struct Index {
87
88    startAbilityTest() {
89      let context = getContext(this) as common.UIAbilityContext;
90      let want: Want = {
91        // Want参数信息
92      };
93      context.startAbility(want);
94    }
95
96    // 页面展示
97    build() {
98      ...
99    }
100  }
101  ```
102