鸿蒙 NDK开发：Node-API（五）

一、Node-API

HarmonyOS Node-API是基于Node.js 18.x LTS的Node-API规范扩展开发的机制，提供了ArkTS/JS与C/C++模块之间的交互能力。它提供了一组稳定的、跨平台的API，可以在不同的操作系统上使用。

适用场景

Node-API规范封装了I/O、CPU密集型、OS底层等能力并对外暴露C接口，使用C/C++模块的注册机制，向ArkTS/JS对象上挂载属性和方法的方式来实现ArkTS/JS和C/C++的交互。

二、Node-API的组成架构

Node-API的组成架构主要包括以下组件：

三、Node-API的交互流程

ArkTS和C++之间的交互流程主要分为两步：

3.1 初始化阶段

当ArkTS侧在import一个Native模块时：

1. ArkTS引擎调用ModuleManager加载模块对应的SO及其依赖

2. 首次加载时触发模块的注册

3. 将模块定义的方法属性挂载到exports对象上

4. 返回该对象

3.2 调用阶段

当ArkTS侧通过上述import返回的对象调用方法时：

ArkTS引擎会找到并调用对应的C/C++方法。

3.3 流程示意图

ArkTS侧 import Native模块
    ↓
ModuleManager加载so及依赖
    ↓
首次加载触发模块注册
    ↓
方法属性挂载到exports对象
    ↓
ArkTS侧调用方法
    ↓
ArkTS引擎找到并调用对应C/C++方法

四、核心点

4.2 关键组件

   鸿蒙Node-API是基于Node.js 18.x LTS扩展的ArkTS/JS与C/C++交互机制，通过ModuleManager加载so并注册模块，将方法挂载到exports对象供ArkTS侧调用，适用于系统框架层暴露C/C++能力和应用层实现性能敏感功能两大场景。