个人网站心得,wordpress漫画站,科研平台网站建设计划,织梦网站模块UIAbility组件基本用法
UIAbility组件的基本用法包括#xff1a;指定UIAbility的启动页面以及获取UIAbility的上下文UIAbilityContext。
指定UIAbility的启动页面
应用中的UIAbility在启动过程中#xff0c;需要指定启动页面#xff0c;否则应用启动后会因为没有默认加载…UIAbility组件基本用法
UIAbility组件的基本用法包括指定UIAbility的启动页面以及获取UIAbility的上下文UIAbilityContext。
指定UIAbility的启动页面
应用中的UIAbility在启动过程中需要指定启动页面否则应用启动后会因为没有默认加载页面而导致白屏。可以在UIAbility的onWindowStageCreate()生命周期回调中通过WindowStage对象的loadContent()方法设置启动页面。
import UIAbility from ohos.app.ability.UIAbility;
import Window from ohos.window;export default class EntryAbility extends UIAbility {onWindowStageCreate(windowStage: Window.WindowStage) {// Main window is created, set main page for this abilitywindowStage.loadContent(pages/Index, (err, data) {// ...});}// ...
}说明
在DevEco Studio中创建的UIAbility中该UIAbility实例默认会加载Index页面根据需要将Index页面路径替换为需要的页面路径即可。
获取UIAbility的上下文信息
UIAbility类拥有自身的上下文信息该信息为UIAbilityContext类的实例UIAbilityContext类拥有abilityInfo、currentHapModuleInfo等属性。通过UIAbilityContext可以获取UIAbility的相关配置信息如包代码路径、Bundle名称、Ability名称和应用程序需要的环境状态等属性信息以及可以获取操作UIAbility实例的方法如startAbility()、connectServiceExtensionAbility()、terminateSelf()等。 在UIAbility中可以通过this.context获取UIAbility实例的上下文信息。 import UIAbility from ohos.app.ability.UIAbility;export default class EntryAbility extends UIAbility {onCreate(want, launchParam) {// 获取UIAbility实例的上下文let context this.context;// ...}
}在页面中获取UIAbility实例的上下文信息包括导入依赖资源context模块和在组件中定义一个context变量两个部分。 import common from ohos.app.ability.common;Entry
Component
struct Index {private context getContext(this) as common.UIAbilityContext;startAbilityTest() {let want {// Want参数信息};this.context.startAbility(want);}// 页面展示build() {// ...}
}也可以在导入依赖资源context模块后在具体使用UIAbilityContext前进行变量定义。 import common from ohos.app.ability.common;Entry
Component
struct Index {startAbilityTest() {let context getContext(this) as common.UIAbilityContext;let want {// Want参数信息};context.startAbility(want);}// 页面展示build() {// ...}
}UIAbility组件与UI的数据同步
基于HarmonyOS的应用模型可以通过以下两种方式来实现UIAbility组件与UI之间的数据同步。
EventHub基于发布订阅模式来实现事件需要先订阅后发布订阅者收到消息后进行处理。globalThisArkTS引擎实例内部的一个全局对象在ArkTS引擎实例内部都能访问。
使用EventHub进行数据通信
EventHub提供了UIAbility组件/ExtensionAbility组件级别的事件机制以UIAbility组件/ExtensionAbility组件为中心提供了订阅、取消订阅和触发事件的数据通信能力。接口说明请参见EventHub。
在使用EventHub之前首先需要获取EventHub对象。基类Context提供了EventHub对象本章节以使用EventHub实现UIAbility与UI之间的数据通信为例进行说明。 在UIAbility中调用eventHub.on()方法注册一个自定义事件“event1”eventHub.on()有如下两种调用方式使用其中一种即可。 import UIAbility from ohos.app.ability.UIAbility;const TAG: string [Example].[Entry].[EntryAbility];export default class EntryAbility extends UIAbility {func1(...data) {// 触发事件完成相应的业务操作console.info(TAG, 1. JSON.stringify(data));}onCreate(want, launch) {// 获取eventHublet eventhub this.context.eventHub;// 执行订阅操作eventhub.on(event1, this.func1);eventhub.on(event1, (...data) {// 触发事件完成相应的业务操作console.info(TAG, 2. JSON.stringify(data));});}
}在UI界面中通过eventHub.emit()方法触发该事件在触发事件的同时根据需要传入参数信息。 import common from ohos.app.ability.common;Entry
Component
struct Index {private context getContext(this) as common.UIAbilityContext;eventHubFunc() {// 不带参数触发自定义“event1”事件this.context.eventHub.emit(event1);// 带1个参数触发自定义“event1”事件this.context.eventHub.emit(event1, 1);// 带2个参数触发自定义“event1”事件this.context.eventHub.emit(event1, 2, test);// 开发者可以根据实际的业务场景设计事件传递的参数}// 页面展示build() {// ...}
}在UIAbility的注册事件回调中可以得到对应的触发事件结果运行日志结果如下所示。 [][1][2,test]在自定义事件“event1”使用完成后可以根据需要调用eventHub.off()方法取消该事件的订阅。 // context为UIAbility实例的AbilityContext
this.context.eventHub.off(event1);使用globalThis进行数据同步
globalThis是ArkTS引擎实例内部的一个全局对象引擎内部的UIAbility/ExtensionAbility/Page都可以使用因此可以使用globalThis全局对象进行数据同步。
图1 使用globalThis进行数据同步 如上图所示下面从如下三个场景和一个注意点来介绍globalThis的使用
UIAbility和Page之间使用globalThisUIAbility和UIAbility之间使用globalThisUIAbility和ExtensionAbility之间使用globalThisglobalThis使用的注意事项
UIAbility和Page之间使用globalThis
globalThis为ArkTS引擎实例下的全局对象可以通过globalThis绑定属性/方法来进行UIAbility组件与UI的数据同步。例如在UIAbility组件中绑定want参数即可在UIAbility对应的UI界面上使用want参数信息。 调用startAbility()方法启动一个UIAbility实例时被启动的UIAbility创建完成后会进入onCreate()生命周期回调且在onCreate()生命周期回调中能够接受到传递过来的want参数可以将want参数绑定到globalThis上。 import UIAbility from ohos.app.ability.UIAbilityexport default class EntryAbility extends UIAbility {onCreate(want, launch) {globalThis.entryAbilityWant want;// ...}// ...
}在UI界面中即可通过globalThis获取到want参数信息。 let entryAbilityWant;Entry
Component
struct Index {aboutToAppear() {entryAbilityWant globalThis.entryAbilityWant;}// 页面展示build() {// ...}
}UIAbility和UIAbility之间使用globalThis
同一个应用中UIAbility和UIAbility之间的数据传递可以通过将数据绑定到全局变量globalThis上进行同步如在AbilityA中将数据保存在globalThis然后跳转到AbilityB中取得该数据 AbilityA中保存数据一个字符串数据并挂载到globalThis上。 import UIAbility from ohos.app.ability.UIAbilityexport default class AbilityA extends UIAbility {onCreate(want, launch) {globalThis.entryAbilityStr AbilityA; // AbilityA存放字符串“AbilityA”到globalThis// ...}
}AbilityB中获取对应的数据。 import UIAbility from ohos.app.ability.UIAbilityexport default class AbilityB extends UIAbility {onCreate(want, launch) {// AbilityB从globalThis读取name并输出console.info(name from entryAbilityStr: globalThis.entryAbilityStr);// ...}
}UIAbility和ExtensionAbility之间使用globalThis
同一个应用中UIAbility和ExtensionAbility之间的数据传递也可以通过将数据绑定到全局变量globalThis上进行同步如在AbilityA中保存数据在ServiceExtensionAbility中获取数据。 AbilityA中保存数据一个字符串数据并挂载到globalThis上。 import UIAbility from ohos.app.ability.UIAbilityexport default class AbilityA extends UIAbility {onCreate(want, launch) {// AbilityA存放字符串“AbilityA”到globalThisglobalThis.entryAbilityStr AbilityA;// ...}
}ExtensionAbility中获取数据。 import Extension from ohos.app.ability.ServiceExtensionAbilityexport default class ServiceExtAbility extends Extension {onCreate(want) {// ServiceExtAbility从globalThis读取name并输出console.info(name from entryAbilityStr: globalThis.entryAbilityStr);// ...}
}globalThis使用的注意事项
图2 globalThis注意事项 Stage模型下进程内的UIAbility组件共享ArkTS引擎实例使用globalThis时需要避免存放相同名称的对象。例如AbilityA和AbilityB可以使用globalThis共享数据在存放相同名称的对象时先存放的对象会被后存放的对象覆盖。FA模型因为每个UIAbility组件之间引擎隔离不会存在该问题。对于绑定在globalThis上的对象其生命周期与ArkTS虚拟机实例相同建议在使用完成之后将其赋值为null以减少对应用内存的占用。
Stage模型上同名对象覆盖导致问题的场景举例说明。 在AbilityA文件中使用globalThis中存放了UIAbilityContext。 import UIAbility from ohos.app.ability.UIAbilityexport default class AbilityA extends UIAbility {onCreate(want, launch) {globalThis.context this.context; // AbilityA存放context到globalThis// ...}
}在AbilityA的页面中获取该UIAbilityContext并进行使用。使用完成后将AbilityA实例切换至后台。 Entry
Component
struct Index {onPageShow() {let ctx globalThis.context; // 页面中从globalThis中取出context并使用let permissions [com.example.permission]ctx.requestPermissionsFromUser(permissions,(result) {// ...});}// 页面展示build() {// ...}
}在AbilityB文件中使用globalThis中存放了UIAbilityContext并且命名为相同的名称。 import UIAbility from ohos.app.ability.UIAbilityexport default class AbilityB extends UIAbility {onCreate(want, launch) {// AbilityB覆盖了AbilityA在globalThis中存放的contextglobalThis.context this.context;// ...}
}在AbilityB的页面中获取该UIAbilityContext并进行使用。此时获取到的globalThis.context已经表示为AbilityB中赋值的UIAbilityContext内容。 Entry
Component
struct Index {onPageShow() {let ctx globalThis.context; // Page中从globalThis中取出context并使用let permissions [com.example.permission]ctx.requestPermissionsFromUser(permissions,(result) {console.info(requestPermissionsFromUser result: JSON.stringify(result));});}// 页面展示build() {// ...}
}在AbilityB实例切换至后台将AbilityA实例从后台切换回到前台。此时AbilityA的onCreate生命周期不会再次进入。 import UIAbility from ohos.app.ability.UIAbilityexport default class AbilityA extends UIAbility {onCreate(want, launch) { // AbilityA从后台进入前台不会再走这个生命周期globalThis.context this.context;// ...}
}在AbilityA的页面再次回到前台时其获取到的globalThis.context表示的为AbilityB的UIAbilityContext而不是AbilityA的UIAbilityContext在AbilityA的页面中使用则会出错。 import UIAbility from ohos.app.ability.UIAbilityexport default class AbilityA extends UIAbility {onCreate(want, launch) { // AbilityA从后台进入前台不会再走这个生命周期globalThis.context this.context;// ...}
}
