应用/元服务支持通过包管理工具ohpm来安装、共享、分发代码,管理项目的依赖关系。本文介绍了在您的项目中如何配置依赖项,以及不同的配置方式在编译期间的处理逻辑和编译结果。
您可在工程或模块下的oh-package.json5文件中的dependencies(生产依赖)/devDependencies(开发依赖)字段中指定依赖项,以上两种依赖字段均支持引用远程三方包、本地模块和本地HAR/HSP三种方式。oh-package.json5文件中的dynamicDependencies(动态依赖)仅限于动态依赖HSP的使用场景。以下配置以dependencies为例,更多关于依赖的设置方式请参考oh-package.json5。
在模块的oh-package.json5文件中设置本地模块依赖,有两种方式:
"dependencies": {
"folder": "file:../folder"
} "dependencies": {
"moduleA": "@module:moduleA"
} "dependencies": {
"package": "file:../package.har"
} "dependencies": {
"package": "file:../package.tgz"
} 依赖设置完成后,需要执行ohpm install命令安装依赖包,依赖包会存储在对应模块的oh_modules目录下。
根据当前的依赖配置规格,您可以在以下字段中指定依赖项:
虽然以上字段都可以指定依赖项,但使用不同的字段,在编译期间的处理逻辑和编译结果是不同的。举个例子:
"dependencies": {
"har": "file:../har"
} "devDependencies": {
"har": "file:../har"
} 对比步骤2和3的构建日志,您会发现,步骤2会打印HAR相关的日志,如下图红框所示,步骤3并没有任何关于HAR的日志打印。

以上仅仅是日志的差异,为了确保编译正常,不建议将依赖项配置在工程级oh-package.json5中,下文将通过表格说明编译时具体的处理逻辑和可能造成的异常结果。
为方便后续说明,需要了解以下名词,仅在本文内有效:
依赖项 | 编译HAP | 编译HSP | 编译未开启 bundledDependencies 的字节码HAR | 编译开启 bundledDependencies 的字节码HAR | ||
|---|---|---|---|---|---|---|
源码HAR | 三方包依赖 | devDependencies | 1 | 1 | 2 | 1 |
工程级的dependencies | / | / | 3 | 3 | ||
本地依赖 | devDependencies | 1 | 1 | 2 | 1 | |
工程级的dependencies | / | 1 | 2 | 1 | ||
字节码HAR | 三方包依赖 | devDependencies | 2 | 2 | 2 | 2 |
工程级的dependencies | / | / | 3 | 3 | ||
HSP | 三方包依赖 | devDependencies | 1 | 1 | 2 | 1 |
工程级的dependencies、dynamicDependencies | / | / | / | / | ||
本地依赖 | devDependencies | 1 | 1 | 2 | 1 | |
工程级的dependencies、dynamicDependencies | / | 1 | 2 | 1 | ||
表格中各符号的含义如下:
针对以上几类编译/运行时可能异常的场景,从DevEco Studio 5.1.1 Beta1版本开始,hvigor-config.json5文件提供一个字段ohos.byteCodeHar.integratedOptimization,开启后,可以优化表格中加粗符号对应的场景。
但该开关只是优化了依赖收集的逻辑,并没有优化依赖项的自身配置收集的逻辑,因此,加粗符号对应的场景中,只有编译字节码HAR,并且依赖配置在工程级的dependencies或dynamicDependencies对应的场景才能完全优化,其他场景无法保证编译/运行时无异常。
"properties": { "ohos.byteCodeHar.integratedOptimization": true }
依赖包提供方和集成方都需要配置该字段。
综上所述,我们建议您: