当前位置： 首页 > news >正文

HarmonyOS】鸿蒙应用开发中常用的三方库介绍和使用示例

news 2025/8/3 9:45:11

 🌟 鸿蒙应用开发常用三方库指南（2025 最新版）

适用版本：HarmonyOS NEXT / API 12+
参考来源：HarmonyOS 三方库中心
截止至 2025 年 8 月 1 日，本文整理了当前社区中下载量高、稳定性强、生态完善的热门三方库，涵盖网络请求、UI 组件、状态管理、数据存储、工具函数及媒体处理等核心模块，帮助开发者快速构建高效、现代化的鸿蒙应用。

一、网络与数据交互

1. @ohos/axios —— 熟悉的 HTTP 客户端

@ohos/axios 是 Axios 在 HarmonyOS 平台的适配版本，支持 Promise 风格的异步请求，语法与 Web 端保持一致，极大降低迁移成本。

✅ 特性
  • 支持 GET/POST/PUT/DELETE 请求
  • 自动 JSON 序列化
  • 拦截器（请求/响应）
  • 超时控制、取消请求
  • HTTPS 安全通信
🔧 安装
{"dependencies": {"@ohos/axios": "1.3.2"}
}
💡 使用示例
import axios from '@ohos/axios';// 全局配置
axios.defaults.baseURL = 'https://api.example.com';
axios.defaults.timeout = 5000;// 添加请求拦截器（如鉴权）
axios.interceptors.request.use((config) => {const token = 'your-jwt-token';if (token) {config.headers.Authorization = `Bearer ${token}`;}return config;},(error) => Promise.reject(error)
);// GET 请求
async function fetchUser(id: number) {try {const response = await axios.get('/user', {params: { id }});console.info('用户数据:', response.data);return response.data;} catch (error: any) {console.error('请求失败:', error.message);}
}// POST 请求
async function createUser(userData: object) {const res = await axios.post('/user', userData);console.log('创建成功:', res.data);
}

⚠️ 注意：在 module.json5 中需声明网络权限：

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

2. @ohos/websocket —— 实时通信支持

适用于聊天、通知推送、实时监控等场景，提供稳定的 WebSocket 客户端能力。

✅ 特性
  • 支持 wss:// 安全连接
  • 消息监听与发送
  • 断线重连机制（需自行实现或使用扩展）
🔧 安装
{"dependencies": {"@ohos/websocket": "2.1.0"}
}
💡 使用示例
import WebSocket from '@ohos/websocket';const ws = new WebSocket('wss://echo.websocket.org');ws.onopen = () => {console.log('WebSocket 连接成功');ws.send('Hello, HarmonyOS!');
};ws.onmessage = (event) => {console.log('收到消息:', event.data);
};ws.onerror = (event) => {console.error('WebSocket 错误:', event);
};ws.onclose = (code, reason) => {console.log(`连接关闭: code=${code}, reason=${reason}`);
};

✅ 建议封装为 Service 类，并集成心跳保活机制。

二、UI 组件与交互

1. @tdesign/arkui-harmonyos —— 企业级 UI 解决方案

由腾讯 TDesign 团队维护，专为 HarmonyOS 设计的企业级 UI 组件库，风格统一、文档完善、支持暗黑模式。

✅ 特性
  • 覆盖按钮、弹窗、表单、列表、导航等 50+ 组件
  • 支持主题定制
  • TypeScript 类型提示完善
  • 开箱即用，适配 ArkUI
🔧 安装
{"dependencies": {"@tdesign/arkui-harmonyos": "0.8.5"}
}
💡 使用示例
import { Button, Dialog } from '@tdesign/arkui-harmonyos';
import { Column } from '@arkui-x/components';@Entry
@Component
struct TDesignDemo {@State showDialog: boolean = false;build() {Column() {Button({ type: 'primary', content: '打开弹窗' }).onClick(() => this.showDialog = true)Dialog({title: '提示',content: '这是 TDesign 弹窗组件',visible: this.showDialog,onClose: () => this.showDialog = false})}.width('100%').padding(20)}
}

📌 推荐用于中后台、管理类应用。

2. @ohos/calendar —— 高性能日历组件

支持单选、范围选择、节假日标注、自定义样式等功能，适用于日程、打卡、预约类应用。

🔧 安装
{"dependencies": {"@ohos/calendar": "3.2.1"}
}
💡 使用示例
import { Calendar } from '@ohos/calendar';
import { Column } from '@arkui-x/components';@Entry
@Component
struct CalendarDemo {@State selectedDate: Date = new Date();build() {Column() {Calendar({startDate: new Date(2024, 0, 1),endDate: new Date(2025, 11, 31),selectedDate: this.selectedDate,onSelect: (date: Date) => {this.selectedDate = date;console.log(`选中日期: ${date.toLocaleDateString()}`);}}).width('90%').height(400)}}
}

✅ 支持农历、节气显示（需启用对应配置）。

三、状态管理

1. @ohos/pinia —— 轻量级状态管理库

灵感来自 Vue 的 Pinia，专为 HarmonyOS 设计的状态管理方案，API 简洁，支持模块化和类型推导。

✅ 特性
  • 模块化 Store 设计
  • 支持 actions、getters、state
  • 与 TypeScript 深度集成
  • 无 mutations，代码更简洁
🔧 安装
{"dependencies": {"@ohos/pinia": "2.2.3"}
}
💡 使用示例
import { createPinia, defineStore } from '@ohos/pinia';// 创建全局状态容器
const pinia = createPinia();// 定义用户模块
const useUserStore = defineStore('user', {state: () => ({name: 'HarmonyOS',age: 3}),getters: {doubleAge: (state) => state.age * 2},actions: {incrementAge() {this.age++;},updateName(newName: string) {this.name = newName;}}
});// 在组件中使用
@Component
struct UserInfo {private userStore = useUserStore(pinia); // 注入 storebuild() {Column() {Text(`姓名: ${this.userStore.name}`).fontSize(18)Text(`年龄: ${this.userStore.age}`)Text(`双倍年龄: ${this.userStore.doubleAge}`)Button('增加年龄').onClick(() => this.userStore.incrementAge())}.padding(20)}
}

✅ 推荐用于中大型应用的状态集中管理。

四、数据存储

1. @ohos/sqlite-orm —— ORM 数据库操作

基于 SQLite 的对象关系映射库，支持实体类注解、自动建表、CRUD 操作，适合结构化数据持久化。

🔧 安装
{"dependencies": {"@ohos/sqlite-orm": "4.1.0"}
}
💡 使用示例
import { Database, Entity, Column, PrimaryGeneratedColumn } from '@ohos/sqlite-orm';@Entity('user')
class User {@PrimaryGeneratedColumn()id: number;@Column()name: string;@Column()age: number;
}// 初始化数据库
const db = new Database({name: 'myApp.db',entities: [User],version: 1
});// 数据操作
async function dbOperations() {const repo = db.getRepository(User);// 插入const user = new User();user.name = 'Alice';user.age = 25;await repo.save(user);// 查询全部const users = await repo.find();console.log('用户列表:', users);// 条件查询const adultUsers = await repo.find({ where: { age: { $gte: 18 } } });
}

✅ 适合存储用户信息、日志、缓存等复杂数据结构。

五、工具类

1. @ohos/lodash —— 实用工具函数库

Lodash 的 HarmonyOS 移植版，提供大量数组、对象、函数操作工具，提升编码效率。

🔧 安装
{"dependencies": {"@ohos/lodash": "4.17.21"}
}
💡 常用方法示例
import _ from '@ohos/lodash';// 数组去重
const unique = _.uniq([1, 2, 2, 3, 3, 3]); // [1, 2, 3]// 深拷贝
const obj = { a: 1, b: { c: 2 } };
const copy = _.cloneDeep(obj);// 防抖（适用于搜索框）
const search = _.debounce((query: string) => {console.log('执行搜索:', query);
}, 300);// 节流（适用于滚动事件）
const scrollHandler = _.throttle(() => {console.log('滚动中...');
}, 100);// 对象取值安全
const name = _.get(user, 'profile.info.name', '默认名称');

✅ 推荐用于处理复杂数据结构或性能优化场景。

六、媒体与图形

1. @ohos/glide —— 图片加载与缓存

仿 Android Glide 设计，支持网络/本地图片加载、内存+磁盘缓存、占位图、错误图、圆角裁剪等。

🔧 安装
{"dependencies": {"@ohos/glide": "2.3.0"}
}
💡 使用示例
import { Glide } from '@ohos/glide';
import { Image } from '@arkui-x/components';@Component
struct ImageDemo {build() {Column() {Image().width(300).height(200).onAppear(() => {// 图片加载Glide.with(this).load('https://picsum.photos/300/200').placeholder($r('app.media.placeholder')) // 占位图资源.error($r('app.media.error'))           // 加载失败图.circleCrop()                            // 圆形裁剪.into(this);                             // 绑定到当前 Image})}}
}

✅ 支持 GIF、WebP 等格式（需系统支持）。

✅ 总结：推荐组合方案

功能模块推荐库优势说明
网络请求@ohos/axios语法熟悉，功能完整
实时通信@ohos/websocket原生封装，稳定可靠
UI 组件@tdesign/arkui-harmonyos企业级，开箱即用
状态管理@ohos/pinia轻量、类型友好
数据库@ohos/sqlite-ormORM 提升开发效率
工具函数@ohos/lodash开发提效神器
图片加载@ohos/glide缓存优化，体验佳

📚 学习建议

  1. 优先使用官方推荐库：通过 OHPM 三方库中心 查看最新版本与兼容性。
  2. 注意权限声明：网络、存储、相机等功能需在 module.json5 中申请对应权限。
  3. 结合 ArkUI 使用：所有 UI 库均基于 ArkUI 构建，建议掌握 @Component、@State 等基础语法。
  4. 关注 TypeScript 支持：现代鸿蒙开发推荐使用 TS，提升类型安全。

📢 更新提示：本文内容基于 2025 年 8 月 1 日 的生态现状整理，三方库版本可能持续更新，请以 OHPM 官网 为准。

✅ 立即开始你的高效鸿蒙开发之旅吧！
📌 收藏本文，作为日常开发的“三方库速查手册”。

http://www.dtcms.com/a/309267.html

相关文章：

  • 代码随想录算法训练营第三十八天
  • NLP 和 LLM 区别、对比 和关系
  • MT Photos图库部署详解：Docker搭建+贝锐蒲公英异地组网远程访问
  • 卸油作业安全设施漏检率↓76%！陌讯多模态融合算法实战解析
  • [AI8051U入门第十二步]W5500-Modbus TCP从机
  • 浏览器【详解】内置Observer（共五种，用于前端监控、图片懒加载、无限滚动、响应式布局、生成安全报告等）
  • 算法26. 删除有序数组中的重复项
  • 宝塔网站如何禁止使用IP访问
  • Shell脚本批量检测IP的443端口联通性
  • ai项目多智能体
  • 【从0开始学习Java | 第11篇】String、StringBuilder与StringBuffer
  • 微信小程序转Vue2组件智能提示词
  • 隧道安全监测哪种方式好？精选方案与自动化监测来对比！
  • 11.Layout-Pinia优化重复请求
  • C++赋值运算符重载
  • PHP Zip 文件操作详解
  • 汽车供应链PPAP自动化审核指南：如何用AI实现规则精准匹配与文件智能校验
  • MyBatis核心
  • MySQL——视图
  • C++对象访问有访问权限是不是在ide里有效
  • StarRocks vs. Trino
  • JavaWeb（苍穹外卖）--学习笔记16（定时任务工具Spring Task,Cron表达式）
  • RAGFLOW~Enable RAPTOR
  • 【云计算】云主机的亲和性策略（二）：集群节点组
  • [ java 网络 ] TPC与UDP协议
  • 微波（Microwave）与毫米波（Millimeter wave）简介
  • 动态域名解析（DDNS）到底有什么用？
  • OSPF综合大实验
  • 下次接好运~
  • Oracle EBS 缺少adcfgclone.pl文件