HarmonyOS鸿蒙Next中如何使用在ArkTS中使用(.js)库

HarmonyOS鸿蒙Next中如何使用在ArkTS中使用(.js)库 在Javascript生态里有许多第三方js库，想要在ArkTS中使用可以吗？应该怎么做？

6 回复

主要分为2步：

  1. 第1步参考文档移植JS/TS三方库检查兼容性并在目标设备（通常为HarmonyOS NEXT手机）上执行用例，确保三方库在目标设备上功能可用。 TS三方库通过DevEco Studio检查TS库的语法和兼容性。 JS三方库使用js-e2e工具扫描兼容性。
  2. 第2步使用ohpm convert把JS/TS转换成HAR包

具体可以参考如何在ArkTS中引入并使用TS/JS的三方库

【背景知识】

  • ohpm：ohpm作为OpenHarmony三方库的包管理工具，支持OpenHarmony共享包的发布、安装和依赖管理。
  • ohpm convert：将指定ohpm或npm仓库中的某个包或者本地node_modules目录下的包转换成满足ohpm格式要求的HAR包，并保存至当前工作目录，转换后的包将支持上传至ohpm-repo私仓或OpenHarmony三方库中心仓。
  • ohpm-repo私仓搭建工具：ohpm-repo是一个搭建轻量级的ohpm私仓服务的工具。它与ohpm包管理器兼容，并按需缓存所有依赖项，加速私有网络中的安装。
  • OpenHarmony三方库中心仓：用于检索、查看所需OpenHarmony三方库信息，也可管理关于ohpm的个人配置。
  • js-e2e：基于eslint进行封装、配置规则，分析出JS库代码对NodeJS和Web浏览器的内置模块、对象的依赖及兼容ES标准版本。支持检查指定源码目录和指定三方库的兼容性。

更多关于HarmonyOS鸿蒙Next中如何使用在ArkTS中使用(.js)库的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


关注，顶帖

总的来说，HarmonyOS是一款非常优秀的操作系统，期待它能在未来带给我们更多惊喜！

可以到 OpenHarmony三方库中心仓 里找。

或者自行移植：支持与tsjs的交互

在HarmonyOS Next中，ArkTS不支持直接使用.js库。ArkTS基于TypeScript，与JavaScript语法兼容但运行环境不同。若需使用.js库，需将其转换为ArkTS模块或使用FFI调用C++库间接实现。

在HarmonyOS Next的ArkTS中，可以直接使用部分纯JavaScript（.js）库，但存在关键限制和推荐方法。

核心机制：FFI（Foreign Function Interface） ArkTS通过FFI支持调用C API，而JavaScript库通常需要借助N-API（Node.js的C接口）来暴露函数。因此，使用.js库的前提是该库必须提供N-API接口或纯C风格的API导出。纯前端浏览器环境的JS库无法直接调用。

实现步骤：

  1. 确认库的兼容性：确保目标JavaScript库提供了N-API或C API（常见于加密、算法、底层工具等库）。
  2. 创建Native层：
    • 在HarmonyOS工程中创建Native C++模块。
    • 将库的C源码或N-API封装代码放入该模块。
    • 编写.cpp文件，使用napi.h头文件暴露必要的函数。
  3. 在ArkTS中调用：
    • 使用import napi from 'libnative.so'导入编译后的Native库。
    • 通过FFI声明函数签名，例如：
    const lib = napi.load('your_library');
const result = lib.yourFunction(...args);

注意事项：

  • 性能：频繁的FFI调用可能带来开销，建议将复杂逻辑放在Native侧处理。
  • 类型安全：FFI调用需手动确保ArkTS与C函数之间的类型匹配，避免内存错误。
  • 生态兼容：大多数前端JS库（如React、Vue相关）依赖浏览器DOM或Node.js特定模块，无法在ArkTS的纯UI渲染环境中使用。

替代方案：

  • 寻找功能对应的ArkTS/TS原生库。
  • 若库逻辑简单，可考虑用ArkTS重写核心算法。
  • 对于加密等底层操作，优先使用HarmonyOS提供的安全API。

总结：ArkTS可通过FFI调用具备N-API接口的JS库，但需经过Native层封装。对于常规Web生态库，直接移植不可行，需评估鸿蒙原生替代方案。

回到顶部