OH_TPC的博客

原创 OpenHarmony平台RN三方库适配情况

如果你在找如何搭建环境的文档，请移步开发文档的搭建开发环境章节。该文档旨在帮助开发者在 HarmonyOS 平台使用 React Native OpenHarmony 的第三方库，并呈现每个三方库的信息。

原创 OpenHarmony平台Flutter三方库适配情况

本文档汇总了OpenHarmony平台适配的三方库情况，包括已适配的三方库、已适配的纯dart库以及正在适配中的三方库。这些库覆盖了权限管理、UI组件、设备信息、位置服务、媒体处理等多个功能领域，为开发者提供了丰富的选择。

原创 OpenHarmony平台原生三方库适配情况

本文档汇总了OpenHarmony平台适配的三方库情况，包括已适配的三方库。这些库覆盖了工具管理、UI组件、通信网络、文件存储、媒体处理等多个功能领域，为开发者提供了丰富的选择。1、OpenHarmony平台已适配三方库本部分列出了已成功适配到OpenHarmony平台的三方库，这些库经过了适配和测试，能够在OpenHarmony设备上正常运行。

原创 HarmonyOS APP开发---“云客服“远程视频客服App，需要用到这个库

客服场景还有个隐藏要求。

原创 【鸿蒙优选三方库】@ohos/pulltorefresh：给列表加上刷新，只需一个回调

原创 HarmonyOS APP开发---“好物清单“购物清单App，需要用到这个库

需求自己手写下拉刷新手势 + 动画 + 状态机✅onRefresh一个回调上拉加载滚动监听 + 触底判断✅onLoadMore一个回调五大容器每个容器各写一套✅ 通用组件自定义动画手写✅customLoad需自行适配✅ 完美兼容BindSheet 弹窗更复杂✅ 同样支持// ...})@BuilderText('正在查最新价格...').fontSize(13).fontColor('#FF6B6B')

原创 【鸿蒙优选三方库】@ohos/mqtt：设备与云之间那条一直在线的通道

IoT 消息为什么都走 MQTT？因为它的发布订阅模型天生适合"一对多、随时推、允许离线"。@ohos/mqtt基于 Eclipse paho.mqtt.c，，遗嘱机制让设备掉线自动上报，不用你写一行心跳检测代码。📦。

原创 HarmonyOS APP开发---“蜂巢“工业设备运维监控App，需要用到这个库

需求HTTP 轮询WebSocketMQTT千级设备❌ 每秒千次请求⚠️ 需自建路由✅ 主题订阅可靠性分级❌❌掉线检测❌❌ 手写心跳✅ 遗嘱机制一对多下发❌⚠️ 手写分发✅ 通配符主题离线消息❌❌✅ retained + 会话保持报文开销大中✅ 极小。

原创 【鸿蒙优选三方库】@ohos/mpchart：几十行代码画出专业图表

自己用 Canvas 画一个柱状图：坐标轴、网格、图例、数据标签、手势缩放、点击高亮……三百行起步，还不好看。覆盖七大图表类型，。📦。

原创 HarmonyOS APP开发---“理财通“个人记账理财App，需要用到这个库

需求自研 Canvas堆叠柱状图300+ 行✅ 30 行渐变折线图400+ 行✅ 30 行饼图250+ 行✅ 20 行手势缩放手写✅ 内置点击高亮 Marker手写✅ 内置预算警戒线手写。

原创 【鸿蒙优选三方库】@ohos/lottie-turbo：让 AE 动画在鸿蒙上飞起来

设计师在 After Effects 里做的动画，Bodymovin 导出 JSON，前端一行代码渲染——这是 Lottie 的魔力。但一代鸿蒙 Lottie 库多动画同屏会卡死主线程。用解决了这个问题，实测性能提升 30%+。📦。

原创 HarmonyOS APP开发---“动效君“UI动效素材库App，需要用到这个库

需求20 个动画同屏❌ 主线程卡死✅ 子线程渲染多动画加载⚠️ 排队✅ 并行加载滑回已看过的❌ 重新解析✅ 内存缓存滑出屏幕的⚠️ 继续渲染✅ 自动跳过绘制逐帧/片段播放⚠️✅ 完整控制。

原创 【鸿蒙优选三方库】@ohos/imageknifepro：能插手的图片加载库

图片加载库很多，但能让你的不多。用责任链-拦截器模式重构了图片管线——CDN 加签名、自定义解码、改缓存策略，加个拦截器就行，业务代码零改动。📦。

原创 HarmonyOS APP开发---“旅图“旅行摄影社区App，需要用到这个库

需求一代 ImageKnifeCDN 签名鉴权❌ 只能整体换下载实现✅ 拦截器一行加弱网重试❌✅ 拦截器实现WebP/Heic 省内存❌✅ 解码优化退后台清理❌✅ 自动释放精确降采样⚠️ 按屏幕密度✅ 指定期望尺寸维护状态⚠️ 已停止演进✅ 活跃。

原创 【鸿蒙优选三方库】@ohos/ijkplayer：B 站同源播放器，啥格式都能播

系统AVPlayer播不了的 FLV、拉不动的 RTMP、给不出的无级倍速——全都有。它是 B 站开源播放器 ijkplayer 在鸿蒙上的官方移植，。📦。

原创 HarmonyOS APP开发---“云课堂“在线教育App，需要用到这个库

需求系统 AVPlayerFLV 老课程❌✅ FFmpeg 内核HLS 直播答疑⚠️ 部分✅RTMP 直播❌✅无级倍速⚠️ 档位有限✅ 0.5x~2x+录制重点❌截图板书❌✅ capture⚠️✅ API 22+

原创 【鸿蒙优选三方库】@ohos/grpc：像调本地方法一样调远程服务

原创 HarmonyOS APP开发---“云诊室“在线问诊App，需要用到这个库

医疗场景的决定性因素是 Protobuf 契约。

原创 【鸿蒙优选三方库】@ohos/ffmpeg-kit：把 FFmpeg 的全部能量带进鸿蒙

FFmpeg 是音视频领域的瑞士军刀，但要在鸿蒙里用它，得自己编译源码、写 NAPI 桥接、处理异步回调。把这些活全干了——。📦。

原创 @ohos/axios 源码解读（三）：给普通请求加进度回调，需要付出什么代价

是 Axios v1.3.4 在 OpenHarmony 上的适配版本，对外保持与 Web 端一致的 API，底层把请求交给鸿蒙的执行。，此前进度回调只在文件上传下载时生效。这个版本的更新说明只有一句话——“Support progress callbacks for regular HTTP requests”。

原创 @ohos/axios 源码解读（二）：适配层是一场翻译，而翻译要处理四类错位

是 Axios v1.3.4 在 OpenHarmony 上的适配版本，对外保持与 Web 端一致的 API，底层把请求交给鸿蒙的执行。它的core/目录与 Web 版几乎一致，——axios 的 config 有几十个字段，鸿蒙的又是另一套命名和取值，中间这层转换才是适配工作的主体。这层转换的本质是翻译，而翻译不是逐字对照。两套 API 之间存在四类错位，每一类的处理方式都不同。：按这四类错位逐一展开——哪些字段只是改了名、哪些需要语义转换、哪些能力鸿蒙侧根本不存在只能降级、哪些新特性要先查系统版本；

原创 @ohos/axios 源码解读（一）：跟着一次 axios.get() 走完整个调用链

是 Axios v1.3.4 在 OpenHarmony 上的适配版本：对外保持与 Web 端一致的 API——Promise 链式调用、请求响应拦截器、文件上传下载、取消请求，底层则把请求交给鸿蒙的执行。因为调用方式和前端 axios 完全一致，它成了鸿蒙应用网络层的主流选择。core/目录基本沿用 Web 版实现，是为鸿蒙重写的适配层。理解这个库，最好的切入点是看清一次请求在这两部分之间如何流动。：跟着一次从业务代码走到原生 HTTP 调用，中间经过六个站点。

原创 HarmonyOS APP开发---“铃声工坊“音频剪辑App，需要用到这个库

ss -t。

原创 【鸿蒙优选三方库】@ohos/dataorm：注解定义实体，告别手写 SQL

手写 SQL 的痛：建表语句拼字符串、JOIN 查询拼字符串、结果集手动映射成对象、字段改名要全局搜替换。用注解定义实体，。📦。

原创 HarmonyOS APP开发---“习惯猫“习惯打卡App，需要用到这个库

需求原生 relationalStore建表手写 CREATE TABLE✅ 注解自动生成查询拼 SQL 字符串✅ 链式 API一对多关联手写 JOIN + 映射✅@ToMany自动带出类型安全❌ 字符串无约束✅ 编译期检查迁移手写 ALTER，无回滚代码量100%✅ ~30%@Index() @Column({ columnName: 'HABIT_ID' }) habitId: number = 0 // ✅ 高频查询字段加索引。

原创 【鸿蒙优选三方库】@ohos/coap：让鸿蒙设备说上 IoT 的母语

传感器跑在电池供电的 MCU 上，HTTP 的 TCP 握手加几百字节 header 太奢侈，MQTT 还得部署 Broker。——这才是受限设备的原生语言。@ohos/coap让鸿蒙手机直接说这门语言。📦。

原创 HarmonyOS APP开发---“智泊“智能停车App，需要用到这个库

维度HTTPMQTTCoAP传输层TCPTCP✅ UDP报文头几百字节2 字节✅ 4 字节组播发现❌❌✅ 原生支持中间服务器需要需要 Broker✅ 点对点直连设备当服务端难难✅ 原生支持传感器功耗高中✅ 低组播是决定性优势：一次广播拿到全部车位状态，比 200 次单播省两个数量级的流量和电量。

原创 【鸿蒙优选三方库】@ohos/axios：前端转鸿蒙，网络层几乎不用改

鸿蒙原生的没有 Promise、没有拦截器，鉴权和错误处理要在每个请求里重写一遍。把大家熟悉的 Axios 原样搬了过来——。📦。

原创 HarmonyOS APP开发---“菜谱汇“美食菜谱App，需要用到这个库

axios.all。

原创 【鸿蒙优选三方库】@ohos/aki：一行代码让 ArkTS 调 C++

裸写 NAPI 绑定一个add(a, b)，要写三十行。绑定一个 C++ 类？更是一场噩梦。@ohos/aki把它压缩成一行——。📦。

原创 HarmonyOS APP开发---“算力引擎“科学计算App，需要用到这个库

维度裸写 NAPI@ohos/aki绑定一个函数40+ 行样板✅ 1 行绑定一个类极其繁琐✅类型转换手写 napi_get/set✅ 全自动返回 Promise手写 AsyncWorker✅代码量100%✅ ~40%

原创 HarmonyOS APP开发---“智泊“智能停车App，需要用到这个库

"智泊"的核心场景：停车场有 200 个车位，每个车位装一个 CoAP 传感器（地磁或红外检测有无车辆）。用户打开 App，要看到整个停车场的空位分布，点某个车位看详细信息。为什么不用 HTTP？传感器是电池供电的低功耗 MCU，HTTP 的 TCP 三次握手 + 几百字节 header 太浪费200 个车位逐个 HTTP 轮询，网络和电量都扛不住停车场是局域网环境，不需要走公网CoAP基于 UDP，报文头只有 4 字节，复用 REST 语义，还支持组播——一次广播请求，所有传感器各自响应。

原创 【鸿蒙优选三方库】@ohos/axios：从 Issue 看一个网络库的实战打磨

451 个已关闭的 Issue，不只是 bug 修复记录，更是一部"从踩坑到填坑"的实战指南。基于 Axios v1.3.4 适配 OpenHarmony，社区活跃度在鸿蒙三方库中名列前茅。

原创 HarmonyOS APP开发---“菜谱汇“美食菜谱App，需要用到这个库

"菜谱汇"要从三个美食数据源聚合菜谱，每个菜谱有封面图需要下载到本地缓存。多源并发请求，合并后按评分排序菜品封面图下载带进度条统一鉴权头（每个源 Token 不同）如果用原生，每个请求都要手写 header、手写回调嵌套、手写文件流处理——三个源就是三份重复代码。的axios.all并发 + 拦截器统一鉴权 +进度回调，三件事一把梭。而且 API 和前端 axios 完全一致，写过前端的人零学习成本。"菜谱汇"这个场景里，多源聚合——axios.all并发拉三个源，allSettled。

原创 【鸿蒙优选三方库】@ohos/aki：从 Issue 看 ArkTS FFI 框架的跨线程与崩溃治理

303 个已关闭 Issue，是一部 Native 跨语言开发的踩坑史。@ohos/aki用极简语法糖让 ArkTS 调 C/C++ 像调本地方法，但跨线程的aki::Value、release 包的符号表、空指针兼容——这些 Native 特有的坑，Issue 里都有答案。

原创 HarmonyOS APP开发---“算力引擎“科学计算App，需要用到这个库

矩阵运算：乘法、求逆、特征值分解FFT 变换：信号处理的频域分析数值求解：微分方程（RK4）、非线性方程求根数据拟合：最小二乘、多项式拟合计算密集 + 已有成熟 C/C++ 实现（Eigen、FFTW、GSL 等开源库）。用 ArkTS 重写不现实——一个 1000×1000 矩阵乘法，ArkTS 可能要几十秒，C++ 用 Eigen 只要几百毫秒。C++ 复用现成库算，ArkTS 负责 UI 和参数输入，中间用 AKI 桥接。裸写 NAPI 的话，绑定一个矩阵乘法要写几十行；

原创 【鸿蒙优选三方库】@react-native-ohos/react-native-webview：高性能内嵌浏览器组件

userAgent。

原创 HarmonyOS APP开发---“快讯通“资讯阅读App，需要用到这个库

"快讯通"是一个资讯阅读 App，核心策略是混合开发信息流列表（RN 原生）：列表滑动要 60fps 流畅，用 RN FlatList + FastImage文章详情（H5）：文章排版复杂（富文本、图片、视频嵌入、代码高亮），CMS 输出的是 HTML，用 H5 渲染最灵活活动页/广告（H5）：运营频繁改内容，H5 热更新方便这就需要 RN 原生列表和 WebView 之间无缝协作用户在列表点击 → RN 导航到详情页 → WebView 加载文章 HTML。

原创 【鸿蒙优选三方库】@react-native-ohos/react-native-svg：SVG 矢量图形渲染组件

RN 鸿蒙应用里要用矢量图标、SVG 动画、自定义图表？基于 software-mansion 原库适配，Path/Circle/Rect/G/Text/LinearGradient 全套 SVG 元素开箱即用。

原创 HarmonyOS APP开发---“步道“运动数据可视化App，需要用到这个库

步数进度环：今日 8234/10000 步，圆环填充 82%心率折线图：最近 7 天静息心率趋势跑步轨迹：GPS 路径用 SVG Path 绘制在地图叠加层上卡路里仪表盘：半圆仪表盘 + 渐变填充随数据动态变化、需要矢量精度、要用渐变和动画。PNG 图方案直接出局——放大模糊、不能动态变化。用 react-native-chart 库又太重，定制困难。让你像写 HTML SVG 一样在 RN 里画矢量图形——Path/Circle/Rect/Line/LinearGradient 全套元素。