ExtensionContext是Extension的上下文环境,继承自Context。
ExtensionContext模块提供访问特定Extension的资源的能力,对于拓展的Extension,可直接将ExtensionContext作为上下文环境,或者定义一个继承自ExtensionContext的类型作为上下文环境。如:ServiceExtension提供了ServiceExtensionContext,它在ExtensionContext的基础上扩展了启动、停止、绑定、解绑Ability的能力,详见ServiceExtensionContext。
说明:
- 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
- 本模块接口仅可在Stage模型下使用。
导入模块
import common from '@ohos.app.ability.common';
属性
系统能力:SystemCapability.Ability.AbilityRuntime.Core
名称 | 类型 | 可读 | 可写 | 说明 |
---|---|---|---|---|
currentHapModuleInfo | HapModuleInfo | 是 | 否 | 所属Hap包的信息。 (详见SDK目录下的 api\bundle\hapModuleInfo.d.ts ) |
config | Configuration | 是 | 否 | 所属Module的配置信息。 (详见SDK目录下的 api\@ohos.app.ability.Configuration.d.ts ) |
extensionAbilityInfo | ExtensionAbilityInfo | 是 | 否 | 所属Extension的信息。 (详见SDK目录下的 api\bundle\extensionAbilityInfo.d.ts ) |
使用场景
ExtensionContext主要用于查询所属Extension的信息、Module的配置信息以及Hap包的信息,开发者可根据自身业务需求使用对应的信息。此处以ServiceExtension为例,展示ExtensionContext的一种使用场景。
场景说明: 一个应用为了适配不同性能的设备,提供了highPerformance、midPerformance、lowPerformance三个Module,这三个Module均提供了一个ServiceExtension给entry使用。安装应用时,应用市场会根据设备的性能,选择对应Module的Hap包与entry的Hap包进行打包安装,实际运行应用时,entry将解析ServiceExtensionContext.HapModuleInfo获取Hap包信息,根据不同的Hap包执行不同的业务逻辑。
示例:
三个Module内都定义一个相同名称的ServiceExtension:
// 单例对象 GlobalContext.ts
export class GlobalContext {
private constructor() {}
private static instance: GlobalContext;
private _objects = new Map<string, Object>();
public static getContext(): GlobalContext {
if (!GlobalContext.instance) {
GlobalContext.instance = new GlobalContext();
}
return GlobalContext.instance;
}
getObject(value: string): Object | undefined {
return this._objects.get(value);
}
setObject(key: string, objectClass: Object): void {
this._objects.set(key, objectClass);
}
}
import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
import rpc from '@ohos.rpc';
import { GlobalContext } from '../GlobalContext'
export default class TheServiceExtension extends ServiceExtension {
onCreate(want: Want) {
console.log('ServiceAbility onCreate, want: ${want.abilityName}');
GlobalContext.getContext().setObject("ExtensionContext", this.context);
}
onRequest(want: Want, startId: number) {
console.log('ServiceAbility onRequest, want: ${want.abilityName}, startId: ${startId}');
}
onConnect(want: Want) {
console.log('ServiceAbility onConnect, want: ${want.abilityName}');
let remoteObject = new rpc.RemoteObject("test");
return remoteObject;
}
onDisconnect(want: Want) {
console.log('ServiceAbility onDisconnect, want: ${want.abilityName}');
}
onDestroy() {
console.log('ServiceAbility onDestroy');
}
};
在entry的MainAbility的onCreate回调内启动ServiceExtension
import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import Want from '@ohos.app.ability.Want';
export default class EntryAbility extends UIAbility {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
console.log('[Demo] EntryAbility onCreate');
let wantExt: Want = {
deviceId: '',
bundleName: 'com.example.TheServiceExtension',
abilityName: 'TheServiceExtension',
};
this.context.startServiceExtensionAbility(wantExt);
}
};
在entry内新建一个ServiceModule.ts,专用于执行业务逻辑
import common from '@ohos.app.ability.common';
import { GlobalContext } from '../GlobalContext';
export default class ServiceModel {
moduleName: string = '';
constructor() {}
executeTask() {
if (GlobalContext.getContext().getObject('ExtensionContext') === undefined) {
console.log('ERROR, ServiceExtension does not exist');
return;
}
let extensionContext = GlobalContext.getContext().getObject('ExtensionContext') as common.ServiceExtensionContext;
this.moduleName = extensionContext.currentHapModuleInfo.name;
// 根据moduleName执行不同的业务逻辑,实现对不同性能设备的区分
switch (this.moduleName) {
case 'highPerformance':
console.log('This is high performance device.');
// 执行对应业务逻辑
break;
case 'midPerformance':
console.log('This is mid performance device.');
// 执行对应业务逻辑
break;
case 'lowPerformance':
console.log('This is low performance device.');
// 执行对应业务逻辑
break;
default:
console.log('ERROR, invalid moduleName.');
break;
}
}
};
最后
有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(HarmonyOS NEXT)资料用来跟着学习是非常有必要的。
这份鸿蒙(HarmonyOS NEXT)资料包含了鸿蒙开发必掌握的核心知识要点,内容包含了(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等)鸿蒙(HarmonyOS NEXT)技术知识点。
希望这一份鸿蒙学习资料能够给大家带来帮助,有需要的小伙伴自行领取,限时开源,先到先得~无套路领取!!
获取这份完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料
鸿蒙(HarmonyOS NEXT)最新学习路线
-
HarmonOS基础技能
- HarmonOS就业必备技能
- HarmonOS多媒体技术
- 鸿蒙NaPi组件进阶
- HarmonOS高级技能
- 初识HarmonOS内核
- 实战就业级设备开发
有了路线图,怎么能没有学习资料呢,小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙(OpenHarmony )学习手册(共计1236页)与鸿蒙(OpenHarmony )开发入门教学视频,内容包含:ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。
获取以上完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料
《鸿蒙 (OpenHarmony)开发入门教学视频》
《鸿蒙生态应用开发V2.0白皮书》
《鸿蒙 (OpenHarmony)开发基础到实战手册》
OpenHarmony北向、南向开发环境搭建
《鸿蒙开发基础》
- ArkTS语言
- 安装DevEco Studio
- 运用你的第一个ArkTS应用
- ArkUI声明式UI开发
- .……
《鸿蒙开发进阶》
- Stage模型入门
- 网络管理
- 数据管理
- 电话服务
- 分布式应用开发
- 通知与窗口管理
- 多媒体技术
- 安全技能
- 任务管理
- WebGL
- 国际化开发
- 应用测试
- DFX面向未来设计
- 鸿蒙系统移植和裁剪定制
- ……
《鸿蒙进阶实战》
- ArkTS实践
- UIAbility应用
- 网络案例
- ……
获取以上完整鸿蒙HarmonyOS学习资料,请点击→纯血版全套鸿蒙HarmonyOS学习资料
总结
总的来说,华为鸿蒙不再兼容安卓,对中年程序员来说是一个挑战,也是一个机会。只有积极应对变化,不断学习和提升自己,他们才能在这个变革的时代中立于不败之地。