《探索 HarmonyOS NEXT(5.0)：开启构建模块化项目架构奇幻之旅 —— 构建公共能力层》

2024-10-30 07:14:38

上一篇大概说了《探索 HarmonyOS NEXT(5.0)：开启构建模块化项目架构奇幻之旅 —— 构建基础特性层》，这一篇继续开发 构建公共能力层。

公共能力层

主要针对公共能力层的各子目录将被编译成HAR包，而他们只能被产品定制层和基础特性层所依赖，不允许存在反向依赖。比如网络请求模块、公共UI模块、工具模块。

1.这次创建命名为 commons的目录，用于存放公共的

2.目前先创建三个模块，分别是网络请求模块、公共UI模块、工具模块,分别对应network、uicomponents、utils。
如何创建HAR模块，这里不再详细说，请看上一篇文章https://juejin.cn/post/7429590344205418523 。

features目录下的几个模块分别导入公共能力层三个依赖(非必须，需要什么导入什么)，导入后就可以使用公共能力层里面的东西了。

"dependencies": {
  "network": 'file:../../commons/network',
  "uicomponents": 'file:../../commons/uicomponents',
  "utils": 'file:../../commons/utils'
}

创建项目级lib、plugins

libs 本地三方依赖库，以第三方库zrouter举例

1.创建libs目录，把第三方库放到目录里，本地依赖放到项目级的oh-package.json5里，RouterApi文件在源码里

"dependencies": {
  // 本地依赖
  "@hzw/zrouter": "file:libs/RouterApi.har",
  // 远程依赖
  // "@hzw/zrouter": "^1.0.7"
},

2.Sync Now 后，项目级oh_modules里并没有这个依赖，鼠标放到"file:libs/RouterApi.har" 上提示，点Run ‘ohpm instal’ 后报错了（图2），报有些依赖项名称与实际包名称不一致，想到了上一篇讲的，name要和HAR模块里的name保持一致，根据错误信息给了提示，我们把"routerApi" 改成 “@hzw/zrouter”，成功了(图3)。

plugins 本地插件依赖库

1.和上面的大差不差，在项目根目录的hvigor目录的hvigor-config.json5文件中配置安装。此时不用太关注hvigor的作用，后期会持续介绍。

"dependencies": {
// 本地依赖
"router-register-plugin":"file:../plugins/router-register-plugin-1.0.9.tgz"
// 远程依赖
// "router-register-plugin":"1.0.9"

},

工程目录,请看README.md

https://gitee.com/jiaojiaoone/explore-harmony-next/blob/master/README.md

以往系列文章

《探索 HarmonyOS NEXT(5.0)：开启构建模块化项目架构奇幻之旅 —— 模块化基础篇》
《探索 HarmonyOS NEXT(5.0)：开启构建模块化项目架构奇幻之旅 —— 构建基础特性层》

若本文对您稍有帮助，诚望您不吝点赞，多谢。

有兴趣的同学可以点击查看源码

gitee：https://gitee.com/jiaojiaoone/explore-harmony-next.git
github：https://github.com/JasonYinH/ExploreHarmonyNext.git

结语

经过以上三篇文章的阐述，想必您对模块化已经有了一定程度的认识和理解。然而，如果您想要更加深入地探究模块化的奥秘，获取更全面、更详尽的知识，还是需要多多查阅官方文档。官方文档作为权威的参考资料，能够为您提供最准确、最前沿的信息和指导，帮助您在模块化的学习和实践道路上走得更远、更稳。希望您在探索的过程中不断积累经验，取得更大的进步。祝您学习顺利！

码农公寓