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 41 export default class EntryAbility extends UIAbility { 42 onCreate(want, launchParam) { 43 // 获取UIAbility实例的上下文 44 let context = this.context; 45 46 // ... 47 } 48 } 49 ``` 50 51- 在页面中获取UIAbility实例的上下文信息，包括导入依赖资源context模块和在组件中定义一个context变量两个部分。 52 53 ```ts 54 import common from '@ohos.app.ability.common'; 55 56 @Entry 57 @Component 58 struct Index { 59 private context = getContext(this) as common.UIAbilityContext; 60 61 startAbilityTest() { 62 let want = { 63 // Want参数信息 64 }; 65 this.context.startAbility(want); 66 } 67 68 // 页面展示 69 build() { 70 // ... 71 } 72 } 73 ``` 74 75 也可以在导入依赖资源context模块后，在具体使用[UIAbilityContext](../reference/apis/js-apis-inner-application-uiAbilityContext.md)前进行变量定义。 76 77 78 ```ts 79 import common from '@ohos.app.ability.common'; 80 81 @Entry 82 @Component 83 struct Index { 84 85 startAbilityTest() { 86 let context = getContext(this) as common.UIAbilityContext; 87 let want = { 88 // Want参数信息 89 }; 90 context.startAbility(want); 91 } 92 93 // 页面展示 94 build() { 95 // ... 96 } 97 } 98 ``` 99
