【HarmonyOS】如何实现应用内引用HSP模块中ArkUI组件

【关键字】

HSP开发、引入HSP模块中ArkUI组件

【写在前面】

在使用ArkTS开发HarmonyOS应用时,通常会定义一些公共组件或公共接口功能,此时可以将这些功能封装到HSP模块中,然后通过在HSP模块中导出组件或接口方式在其他模块中引用,可以实现应用内部代码与资源的共享。这里主要讲如何在entry模块中引用HSP模块中定义ArkUI组件的主要步骤,此处以API9 Stage模型HarmonyOS应用开发为例,hvigor版本为2.4.2。

【开发主要步骤】

步骤1:在HarmonyOS工程项目中,创建HSP模块,HSP模块可以在DevEco Studio中由指定模板创建,此处新增library模块,参考文档如下:

开发动态共享包

步骤2:在library模块中定义ArkUI组件,在"library/src/main/ets"目录下新增components文件夹,右键>New>ArkTS File新增名称为"MyTitleBar"的ets组件,如下图所示:

步骤3:在"library/src/main/ets/Index.ets"中导出ArkUI组件,此文件中可支持导出ts类和方法、ArkUI组件、native方法等,如下图所示:

注意:请检查"library/oh-package.json5"中是否添加main配置信息,如下所示:

步骤4:在其他模块就可以导入library模块并使用导出的组件与方法了,此处以entry模块为例,在"entry/oh-package.json5"添加依赖并点击"Sync Now"进行同步,同步后就可以在oh_modules中看到了。

步骤5:在需要使用的地方直接import使用即可。请注意此处不建议通过相对路径方式引用,否则当ArkUI组件中使用资源文件时,使用相对路径引用编译时可能会报错资源找不到。这样就实现引用HSP模块ArkUI组件功能了,其他类型导出和引用实现方式也大致相同,可具体参考相关文档。

【注意事项】

1、import HSP中组件或接口功能时,不建议使用相对路径,如下图所示,这样引入可能会导致编译失败。

2、添加dependencies依赖时,HSP不支持配置在工程级oh-package.json5被其他模块引用,需要配置在各自模块的oh-package.json5内,否则可能会编译运行报错。

【参考文档】

开发和引用动态共享包:开发及引用动态共享包参考

应用内HSP开发指导:应用内HSP开发指导参考

相关推荐
俩毛豆7 分钟前
【页面路由导航】三步实现页面跳转的完整示例
前端·harmonyos
羑悻的小杀马特2 小时前
探秘仓颉:当函数式编程遇见面向对象王国,当协程风暴席卷并发荒原——从基础语法到实战测试联动的多维编程奇遇记
华为·harmonyos·仓颉·仓颉征文·个人感受·标准库源码·语法剖析
LucianaiB2 小时前
【案例实战】基于分布式能力的跨设备任务协同应用开发
harmonyos·鸿蒙·1024程序员节·案例实战
摘星编程15 小时前
【成长纪实】HarmonyOS Next学习地图:新手避坑指南与核心知识点拆解
学习·华为·harmonyos·鸿蒙开发
文火冰糖的硅基工坊16 小时前
[人工智能-大模型-85]:大模型应用层 - AI/AR眼镜:华为智能眼镜、苹果智能眼镜、Google Glass智能眼镜的软硬件技术架构
人工智能·华为·ar
爱笑的眼睛1119 小时前
HarmonyOS生物识别认证深度解析:从指纹到人脸的安全实践
华为·harmonyos
流影ng21 小时前
【HarmonyOS】动画—转场动效
华为·harmonyos
cooldream20091 天前
项目实战复盘:基于仓颉语言的鸿蒙智能导航助手(HarmonyNav)
华为·harmonyos·仓颉
爱笑的眼睛111 天前
HarmonyOS ScrollBar深度定制:超越系统默认的滚动体验
华为·harmonyos
爱笑的眼睛111 天前
HarmonyOS 文件管理Kit 的应用场景深度解析
华为·harmonyos