鸿蒙第三方库有哪些引入的方法？

harmonyos

MakerStudio张涵兵

2025-03-30 22:24:27

997浏览

回答 1

已解决

回答 1

按赞同

按时间

前端视界

在鸿蒙（HarmonyOS）开发中，引入第三方库主要有以下方式，结合代码示例说明：

1. 通过 HPM（HarmonyOS Package Manager）引入步骤：在项目配置文件中声明依赖，使用 hpm install 安装。
示例：

在bundle.json 或hpm.json 中添加依赖：

{
  "dependencies": {
    "@ohos/lottie": "2.0.0"  // 引入Lottie动画库
  }
}1.
2.
3.
4.
5.

终端执行命令安装依赖：

hpm install1.

代码中引用：

import lottie from '@ohos/lottie';
// 使用Lottie加载动画
lottie.loadAnimation({
  container: this.animComponent, // 动画容器
  path: 'data.json'             // 动画资源路径
});1.
2.
3.
4.
5.
6.

2. 本地引入 HAR 包（Harmony Archive）步骤：将第三方库的 .har 文件放到项目目录，配置依赖路径。
示例：

在bundle.json 中声明本地依赖：

{
  "dependencies": {
    "my-library": "file:../libs/my-library.har"
  }
}1.
2.
3.
4.
5.

安装后直接导入：

import { CustomComponent } from 'my-library';
// 使用自定义组件
@Entry
@Component
struct MyPage {
  build() {
    Column() {
      CustomComponent() // 第三方库组件
    }
  }
}1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

3. 从 Git 仓库直接引入步骤：通过 hpm install 直接安装 Git 仓库中的库。
示例：

hpm install git+https://github.com/username/repo-name.git1.

配置bundle.json：

{
  "dependencies": {
    "repo-name": "git+https://github.com/username/repo-name.git"
  }
}1.
2.
3.
4.
5.

4. 引入动态共享库（Shared Package）步骤：在模块的 oh-package.json5 中声明动态库依赖。
示例：

// oh-package.json5
"dependencies": {
  "network": "1.0.0" // 网络库
}1.
2.
3.
4.

代码中动态加载（需声明权限）：

import network from 'network';
// 使用网络库发起请求
network.request({
  url: 'https://api.example.com/data',
  success: (data) => { /* 处理数据 */ }
});1.
2.
3.
4.
5.
6.

5. 使用 npm 包（需转译）步骤：通过 Web 兼容层间接使用 npm 包（如纯 JS 库）。
示例：

安装 npm 包：

npm install lodash1.

在js 文件中引用：

// utils.js
import _ from 'lodash';
export const debounce = _.debounce;1.
2.
3.

在 ArkTS 中调用：

import { debounce } from '../utils'; // 通过转译层引入
@Entry
@Component
struct MyComponent {
  private handleClick = debounce(() => {
    // 防抖逻辑
  }, 500);
}1.
2.
3.
4.
5.
6.
7.
8.

注意事项

依赖冲突：检查不同库的版本兼容性。
权限声明：部分库需要配置权限（如网络、设备信息等），需在module.json5 中添加：

"requestPermissions": [
  { "name": "ohos.permission.INTERNET" }
]1.
2.
3.

调试工具：使用DevEco Studio 的依赖分析功能检查依赖树。

以上是鸿蒙第三方库的主要引入方式，根据库的类型（HAR、HPM、Git 或 npm）选择合适方法。

2025-03-30 22:53:31

如何写精华回答，获更多曝光？

发布

51CTO

51CTO博客

51CTO学堂

鸿蒙第三方库有哪些引入的方法？

订阅鸿蒙技术特刊，精选内容抢先看