harmony 鸿蒙WindowExtensionContext
WindowExtensionContext
WindowExtensionContext模块是WindowExtensionAbility的上下文环境,继承自ExtensionContext。
WindowExtensionContext模块提供WindowExtensionAbility具有的能力,包括启动Ability。
说明:
本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
本模块接口为系统接口。
本模块接口仅可在Stage模型下使用。
使用说明
在使用WindowExtensionContext的功能前,需要通过WindowExtensionAbility子类实例获取。
import WindowExtensionAbility from '@ohos.application.WindowExtensionAbility';
import WindowExtensionContext from 'application/WindowExtensionContext';
let context: WindowExtensionContext|null = null;
class WindowExtAbility extends WindowExtensionAbility {
onConnect() {
context = this.context; // 获取WindowExtensionContext
}
}
WindowExtensionContext.startAbility
startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>): void
启动Ability,使用callback异步回调。
系统能力:SystemCapability.WindowManager.WindowManager.Core
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
want | Want | 是 | 启动Ability的want信息。 |
options | StartOptions | 是 | 启动Ability所携带的参数。 |
callback | AsyncCallback<void> | 是 | callback形式返回启动结果。 |
示例:
import WindowExtensionAbility from '@ohos.application.WindowExtensionAbility';
import { BusinessError } from '@ohos.base';
import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
class WindowExtAbility extends WindowExtensionAbility {
onConnect() {
let want: Want = {
bundleName: 'com.example.myapplication',
abilityName: 'MainAbility'
};
let options: StartOptions = {
windowMode: 102
};
try {
this.context.startAbility(want, options, (error: BusinessError) => {
let message = (error as BusinessError).message;
let errCode = (error as BusinessError).code;
if (errCode) {
// 处理业务逻辑错误
console.error(`startAbility failed, error.code: ${errCode}, error.message: ${message}`);
return;
}
// 执行正常业务
console.log('startAbility succeed');
});
} catch (paramError) {
// 处理入参错误异常
let message = (paramError as BusinessError).message;
let errCode = (paramError as BusinessError).code;
console.error(`error.code: ${errCode}, error.message: ${message}`);
}
}
}
WindowExtensionContext.startAbility
startAbility(want: Want, options?: StartOptions): Promise<void>
启动Ability,使用Promise异步回调。
系统能力:SystemCapability.WindowManager.WindowManager.Core
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
want | Want | 是 | Want类型参数,传入需要启动的ability的信息,如Ability名称,Bundle名称等。 |
options | StartOptions | 否 | 启动Ability所携带的参数。 |
返回值:
类型 | 说明 |
---|---|
Promise<void> | 无返回结果的Promise对象。 |
示例:
import WindowExtensionAbility from '@ohos.application.WindowExtensionAbility';
import { BusinessError } from '@ohos.base';
import Want from '@ohos.app.ability.Want';
import StartOptions from '@ohos.app.ability.StartOptions';
class WindowExtAbility extends WindowExtensionAbility {
onConnect() {
let want: Want = {
bundleName: 'com.example.myapp',
abilityName: 'MainAbility'
};
let options: StartOptions = {
windowMode: 102,
};
try {
this.context.startAbility(want, options)
.then(() => {
// 执行正常业务
console.log('startAbility succeed');
})
.catch((error: BusinessError) => {
// 处理业务逻辑错误
let message = (error as BusinessError).message;
let errCode = (error as BusinessError).code;
console.error(`startAbility failed, error.code: ${errCode}, error.message: ${message}`);
});
} catch (paramError) {
// 处理入参错误异常
let message = (paramError as BusinessError).message;
let errCode = (paramError as BusinessError).code;
console.error(`error.code: ${errCode}, error.message: ${message}`);
}
}
}
你可能感兴趣的鸿蒙文章
harmony 鸿蒙BundleStatusCallback
harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)
harmony 鸿蒙@ohos.distributedBundle (分布式包管理)
harmony 鸿蒙@ohos.bundle (Bundle模块)
harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)
- 所属分类: 后端技术
- 本文标签:
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
8、 golang
-
9、 openharmony
-
10、 Vue中input框自动聚焦