鸿蒙HarmonyOS开发：一次开发，多端部署（工程级）三层工程架构

文章目录

- - 一、工程创建
  - - 1、先创建出最基本的项目工程。
    - [2、新建common、features、 products 目录](#2、新建common、features、 products 目录)
  - 二、工程结构
  - 三、依赖关系
  - - 1、oh-package.json5
    - 2、配置ohpm包依赖
  - 四、引用ohpm包中的代码

一、工程创建

1、先创建出最基本的项目工程。

新建项目，选择Empty Ability，然后 Next
填写项目基本信息
可以看到DevEco Studio创建出的默认工程，仅包含一个的entry类型的模块。

2、新建common、features、 products 目录

在根目录新建三个目录
在 common 下新建一个叫 base 公共模块

common设计为har包，新建module时选择Static Library, 内部存放全局通用的工具函数，公共配置等
在 features 下新建项目需要的业务模块，如home业务模块

feature设计为har包，新建module时选择 Static Library, 内部存放相对独立的业务单元，比如购物车、我的、分类、Home ，也就是首页底部Tab切换时的四个核心业务模块
把原本的 entry 模块重构到products目录下，然后重命名为 phone

products为产品层，里面放置phone模块，也就是入口模块，在phone中我们放置入口ability和所有页面级别的组件

二、工程结构

"一多"推荐在应用开发过程中使用如下的"三层工程结构"。

common（公共能力层）：用于存放公共基础能力集合（如工具库、公共配置等）。

common层不可分割，需编译成一个HAR包，其只可以被products和features依赖，不可以反向依赖。
features（基础特性层）：用于存放基础特性集合（如应用中相对独立的各个功能的UI及业务逻辑实现等）。

各个feature高内聚、低耦合、可定制，供产品灵活部署。不需要单独部署的feature通常编译为HAR包，供products或其它feature使用。需要单独部署的feature通常编译为Feature类型的HAP包，和products下Entry类型的HAP包进行组合部署。features层可以横向调用及依赖common层，同时可以被products层不同设备形态的HAP所依赖，但是不能反向依赖products层。
products（产品定制层）：用于针对不同设备形态进行功能和特性集成。

products层各个子目录各自编译为一个Entry类型的HAP包，作为应用主入口。products层不可以横向调用。

三、依赖关系

我们推荐在common目录中存放基础公共代码，features目录中存放相对独立的功能模块代码，product目录中存放完全独立的产品代码。这样在product目录中依赖features和common中的公共代码来实现功能，可以最大程度实现代码复用。

配置依赖关系可以通过修改模块中的oh-package.json5文件。

通过修改products模块中的oh-package.json5文件，使其可以使用common、features模块中的代码。

同样的，修改features模块中的oh-package.json5文件，使其可以使用common模块中的代码。

1、oh-package.json5

dependencies（生产依赖）：声明需要在代码中import的HarmonyOS三方库（参与编译/运行阶段使用的依赖）。
devDependencies（开发依赖）：参与项目的开发或测试阶段。
dynamicDependencies（动态依赖）：动态依赖的HSP模块。在开发者需要动态加载HSP的时候配置使用。

2、配置ohpm包依赖

ohpm包的依赖一般包括以下三种：ohpm原生三方包、ohpm三方共享包和ohpm本地共享模块。开发者可在工程或模块下的oh-package.json5中进行配置，配置依赖的示例如下所示：

ohpm原生三方包依赖示例如下：

"dependencies": {
"eslint": "^7.32.0",
...
}
三方包依赖示例如下：

"dependencies": {
"@ohos/lottie": "^2.0.0",
...
}
ohpm本地共享模块依赖示例如下

"dependencies": {
"library": "file:../library",
...
}

四、引用ohpm包中的代码

模块资源如何共享？

1、定义共享资源

在common模块中新建utils文件夹，下面创建Math.ets文件，新增Add函数，用于计算并返回两个数字的和。

// common/base/src/main/ets/utils/Math.ets

export function Add(numA:number,numB:number){
  return numA + numB
}

2、在common模块index文件中导出

在common模块中创建index.ets文件，申明需要export的类、函数的名称及在当前模块中的位置，否则其它模块无法使用。

// common/base/index.ets

export * from './src/main/ets/utils'

3、在phone模块oh-package.json5文件中引入依赖

// products/phone/oh-package.json5

"dependencies": {
   "base": "file:../../common/base"
 }

4、在phone模块中import和使用这些类和函数

// products/phone/src/main/ets/pages/Index.ets

import { Add } from 'base';

@Entry
@Component
struct Index {
  build() {
    Column() {
      Text('计算两数的和：')
        .fontSize(30)
      Text('2+3='+Add(12,3))
        .fontSize(30)
    }
    .height('100%')
    .width('100%')
  }
}