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