HarmonyOS鸿蒙Next中本地的har包如何导入依赖?
HarmonyOS鸿蒙Next中本地的har包如何导入依赖? 本地的har包如何导入依赖?
引用本地HAR包,有如下两种方式:
方式一:在Terminal窗口中,切换到需要引入本地HAR包的模块,如entry模块,执行如下命令进行安装,并会在oh-package.json5中自动添加依赖。以HAR包在工程根目录下为例,配置示例如下:
cd path/to/your/project/entry
ohpm install path/to/package.har
方式二:在需要引入三方包的模块的oh-package.json5中设置本地HAR包。以HAR包在工程根目录下为例,配置示例如下:
"dependencies": {
"package": "file:path/to/package.har" // 此处也可以是以当前oh-package.json5所在目录为起点的相对路径。
}
【背景知识】
更多关于HarmonyOS鸿蒙Next中本地的har包如何导入依赖?的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html
引用本地HAR/HSP包,有如下两种方式:
方式一:在Terminal窗口中,切换到需要引入本地HAR/HSP包的模块,如entry模块,执行如下命令进行安装,并会在oh-package.json5中自动添加依赖。以HAR/HSP包在工程根目录下为例,配置示例如下(实际配置时请以HAR/HSP包实际目录为准):
cd path/to/your/project/entry
ohpm install path/to/package.har
方式二:在需要引入三方包的模块的oh-package.json5中设置本地HAR/HSP包。以HAR/HSP包在工程根目录下为例,配置示例如下(实际配置时请以HAR/HSP包实际目录为准):
"dependencies": {
"package": "file:path/to/package.har" // 此处也可以是以当前oh-package.json5所在目录为起点的相对路径。
}
依赖设置完成后,需要执行ohpm install命令安装依赖包,依赖包会安装在该模块的oh_modules目录下。
ohpm install
更多引用共享包的方式详见开发文档:
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-har-import
在HarmonyOS Next中导入本地har包依赖,需在模块级build-profile.json5的dependencies中添加路径引用。格式为:"{name}": "file://{路径}",其中name为包名,路径指向本地har文件目录。配置后同步工程即可完成依赖导入。
在HarmonyOS Next中,导入本地HAR包依赖的步骤如下:
-
放置HAR包:将.har文件放入项目的libs目录中(如未存在可手动创建)。
-
配置依赖:
- 在模块级build-profile.json5文件的dependencies中添加:
"dependencies": [ { "har": "./libs/your-package.har" } ] - 或使用绝对路径(如
"har": "/your-path/package.har")。
- 在模块级build-profile.json5文件的dependencies中添加:
-
同步项目:执行
File > Sync Project with Gradle Files(或点击Sync Now)同步依赖。 -
使用依赖:在代码中通过import语句引用HAR包中的类或方法。
注意事项:
- 确保HAR包与当前项目架构兼容(如ARM64)。
- 若HAR包依赖其他模块,需一并配置。
- 路径错误或版本不匹配可能导致构建失败,请检查文件路径与完整性。
完成配置后即可正常使用本地HAR包的功能。

