前言

随着 HarmonyOS NEXT 生态不断完善，越来越多开发者开始从 Android、Flutter、UniApp 等平台迁移到鸿蒙开发。

在实际项目中，我们很少从零开始造轮子。网络请求、图片加载、动画播放、工具类封装、弹窗组件等功能，都可以通过成熟的第三方组件快速实现，大幅提升开发效率。

鸿蒙官方提供了 OHPM（OpenHarmony Package Manager） 作为统一的包管理工具，同时开放了三方库中心仓，开发者可以像使用 npm 一样管理依赖。

本文将带你掌握鸿蒙第三方组件的快速集成方式，并推荐项目开发中最常用的组件库。

---

一、鸿蒙第三方组件生态介绍

目前鸿蒙第三方库主要来源于：

1. OpenHarmony 三方库中心仓

官方维护的组件市场，支持：

• 组件搜索
• 版本管理
• 自动安装
• 依赖解析

开发者可直接通过 OHPM 安装使用。

2. 开源社区组件

包括：

• GitHub
• Gitee
• OpenHarmony-TPC

大量优秀组件已经完成 HarmonyOS NEXT 适配。

---

二、OHPM快速安装第三方组件

Step1 创建项目

使用 DevEco Studio 创建 ArkTS 项目。

---

Step2 配置依赖

打开：

oh-package.json5

添加依赖：

{
  "dependencies": {
    "@ohos/axios": "^2.2.4"
  }
}

---

Step3 安装组件

执行：

ohpm install

或者点击：

Sync Now

完成依赖下载。

OHPM提供了类似 npm 的依赖管理能力，可自动完成版本解析与安装。

---

三、项目最常用的五大第三方组件

---

1. Axios —— 网络请求神器

安装

ohpm install @ohos/axios

Axios 是目前鸿蒙项目中最常见的网络请求库之一，已适配 OpenHarmony。

---

使用示例

import axios from '@ohos/axios'

axios({
  url: 'https://api.demo.com/user',
  method: 'GET'
})
.then(res => {
  console.info(JSON.stringify(res.data))
})
.catch(err => {
  console.error(err)
})

---

适用场景

• REST API调用
• 文件上传
• Token管理
• 请求拦截器

---

2. Day.js —— 时间处理库

原生时间格式化比较繁琐。

推荐：

ohpm install dayjs

---

使用示例

import dayjs from 'dayjs'

let time = dayjs().format(
  'YYYY-MM-DD HH:mm:ss'
)

console.info(time)

---

优势

• 体积小
• API简单
• 替代Moment.js

---

3. Harmony Dialog —— 全局弹窗组件

在项目中经常需要：

• Loading
• Toast
• 确认框
• 自定义弹窗

官方三方库中心中的 Dialog 组件支持一行代码快速弹出。

---

安装

ohpm install @pura/harmony-dialog

---

使用

Dialog.show({
  content: '操作成功'
})

---

优势

• 零侵入
• 全局调用
• 支持主题定制

---

4. Lottie —— 高性能动画库

如果项目需要：

• 启动页动画
• 活动动画
• 礼物动画

推荐使用：

ohpm install @ohos/lottie

Lottie能够解析 After Effects 导出的 JSON 动画并进行本地渲染。

---

示例

LottieView({
  src: $rawfile('loading.json'),
  autoPlay: true,
  loop: true
})

---

效果优势

• 流畅
• 资源体积小
• 不占用大量内存

---

5. Harmony Utils —— 开发效率神器

这是鸿蒙生态中非常受欢迎的工具库。

功能覆盖：

• 字符串工具
• 日期工具
• 文件工具
• 权限管理
• Toast
• 日志管理
• 加密解密

等数十种常用能力。

---

安装

ohpm install @pura/harmony-utils

---

使用示例

import { StringUtil } from '@pura/harmony-utils'

let result = StringUtil.isEmpty('')

console.info(result)

---

四、第三方组件集成常见问题

---

问题1：ohpm install失败

检查：

ohpm -v

确认：

• OHPM版本正确
• 网络正常
• 仓库配置正常

---

问题2：组件导入报红

检查：

import xxx from 'xxx'

是否与文档一致。

重新执行：

ohpm install

---

问题3：ArkTS类型报错

部分 JS 库直接从 npm 安装后无法在 ArkTS 中使用。

建议：

• 优先选择已完成鸿蒙适配的组件
• 优先使用 OHPM 仓库组件
• 必要时自行封装 HAR 模块进行适配

OpenHarmony 对第三方 JS/TS 组件支持 HAR 形式集成，HAR 可包含 ArkTS、资源文件以及原生能力封装。

---

五、企业项目推荐组件清单

分类	推荐组件
网络请求	Axios
日期处理	Day.js
动画播放	Lottie
弹窗组件	Harmony Dialog
工具库	Harmony Utils
图片处理	RoundedImageView
富文本	TextLayoutBuilder

这些组件已经在大量鸿蒙项目中得到验证，能够覆盖80%以上的业务开发场景。

---

总结

对于鸿蒙开发者而言，掌握第三方组件的使用已经成为提升开发效率的必备技能。

推荐大家优先掌握以下组合：

Axios
+
Day.js
+
Harmony Dialog
+
Lottie
+
Harmony Utils

这一套组件基本可以覆盖：

✔ 网络请求
✔ 时间处理
✔ 页面交互
✔ 动画展示
✔ 工具能力封装

在实际企业级项目中，合理利用成熟组件往往比重复造轮子更重要。随着 HarmonyOS NEXT 生态持续壮大，未来会有更多高质量鸿蒙原生组件加入生态体系，开发效率也将进一步提升。