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

【鸿蒙HarmonyOS Next实战开发】实现ArkTS/JS和C/C++的交互-Node-API

news 来源：原创 2025/7/2 20:06:10

一、HarmonyOS Node-API简介

在HarmonyOS应用开发中，通常以ArkTS/JS语言为主，但在一些特殊场景下，例如游戏开发、物理模拟等，由于对性能、效率等有较高要求，需要借助现有的C/C++库来实现。为了满足这种需求，HarmonyOS引入了Node-API规范，通过封装I/O、CPU密集型、OS底层等能力，并对外暴露ArkTS/JS接口，从而实现了ArkTS/JS与C/C++之间的高效交互。

HarmonyOS Node-API是基于Node.js 12.x LTS的Node-API规范进行扩展开发的一种机制，它为开发者提供了ArkTS/JS与C/C++模块之间的交互能力。该机制提供了一组稳定且跨平台的API，能够在不同的操作系统上实现无缝使用。

在本文中，若无特别说明，后续提到的“Node-API”均指代HarmonyOS Node-API的相关能力。

关于HarmonyOS Node-API与Node.js 12.x LTS的Node-API规范在接口方面的异同点，可见Node-API参考。

其主要的应用场景包括但不限于以下几种：

系统功能开放：系统能够通过ArkTS/JS接口，将框架层丰富的模块功能开放给上层应用，方便开发者调用系统底层能力，实现更强大的功能扩展。
性能优化与核心功能封装：应用开发者可以将对性能要求较高或需要底层系统调用的核心功能，使用C/C++进行封装实现，然后通过ArkTS/JS接口在应用中调用，从而显著提高应用的执行效率。

1.Node-API的组成架构

图1 Node-API的组成架构

Native Module：开发者使用Node-API开发的模块，用于在ArkTS侧导入使用。
Node-API：实现ArkTS与C/C++交互的逻辑。
ModuleManager：Native模块管理，包括加载、查找等。
ScopeManager：管理napi_value的生命周期。
ReferenceManager：管理napi_ref的生命周期。
NativeEngine：ArkTS引擎抽象层，统一ArkTS引擎在Node-API层的接口行为。
ArkCompiler ArkTS Runtime：ArkTS运行时。

2.Node-API的关键交互流程

图2 Node-API的关键交互流程

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

初始化阶段：当ArkTS侧在import一个Native模块时，ArkTS引擎会调用ModuleManager加载模块对应的so及其依赖。首次加载时会触发模块的注册，将模块定义的方法属性挂载到exports对象上并返回该对象。
调用阶段：当ArkTS侧通过上述import返回的对象调用方法时，ArkTS引擎会找到并调用对应的C/C++方法。

二、使用Node-API实现跨语言交互开发流程

使用Node-API实现跨语言交互，首先需要按照Node-API的机制实现模块的注册和加载等相关动作。

ArkTS/JS侧：实现C++方法的调用。代码比较简单，import一个对应的so库后，即可调用C++方法。
Native侧：.cpp文件，实现模块的注册。需要提供注册lib库的名称，并在注册回调方法中定义接口的映射关系，即Native方法及对应的JS/ArkTS接口名称等。

此处以在ArkTS/JS侧实现add()接口、在Native侧实现Add()接口，从而实现跨语言交互为例，呈现使用Node-API进行跨语言交互的流程。

1.创建Native C++工程

在DevEco Studio中New > Create Project，选择Native C++模板，点击Next，选择API版本，设置好工程名称，点击Finish，创建得到新工程。
创建工程后工程结构可以分两部分，cpp部分和ets部分，工程结构具体介绍可见C++工程目录结构。

2.Native侧方法的实现

设置模块注册信息

ArkTS侧import native模块时，会加载其对应的so。加载so时，首先会调用napi_module_register方法，将模块注册到系统中，并调用模块初始化函数。

napi_module有两个关键属性：一个是.nm_register_func，定义模块初始化函数；另一个是.nm_modname，定义模块的名称，也就是ArkTS侧引入的so库的名称，模块系统会根据此名称来区分不同的so。

// entry/src/main/cpp/napi_init.cpp// 准备模块加载相关信息，将上述Init函数与本模块名等信息记录下来。
static napi_module demoModule = {
.nm_version = 1,
.nm_flags = 0,
.nm_filename = nullptr,
.nm_register_func = Init,
.nm_modname = "entry",
.nm_priv = nullptr,
.reserved = {0},
};// 加载so时，该函数会自动被调用，将上述demoModule模块注册到系统中。
extern "C" __attribute__((constructor)) void RegisterDemoModule() {
napi_module_register(&demoModule);
}

注：以上代码无须复制，创建Native C++工程以后在napi_init.cpp代码中已配置好。

模块初始化

实现ArkTS接口与C++接口的绑定和映射。

// entry/src/main/cpp/napi_init.cpp
EXTERN_C_START
// 模块初始化
static napi_value Init(napi_env env, napi_value exports) {
// ArkTS接口与C++接口的绑定和映射
napi_property_descriptor desc[] = {
// 注：仅需复制以下两行代码，Init在完成创建Native C++工程以后在napi_init.cpp中已配置好。
{"callNative", nullptr, CallNative, nullptr, nullptr, nullptr, napi_default, nullptr},
{"nativeCallArkTS", nullptr, NativeCallArkTS, nullptr, nullptr, nullptr, napi_default, nullptr}
};
// 在exports对象上挂载CallNative/NativeCallArkTS两个Native方法
napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
return exports;
}
EXTERN_C_END

在index.d.ts文件中，提供JS侧的接口方法。

// entry/src/main/cpp/types/libentry/index.d.ts
export const callNative: (a: number, b: number) => number;
export const nativeCallArkTS: (cb: (a: number) => number) => number;

在oh-package.json5文件中将index.d.ts与cpp文件关联起来。

// entry/src/main/cpp/types/libentry/oh-package.json5
{
"name": "libentry.so",
"types": "./index.d.ts",
"version": "",
"description": "Please describe the basic information."
}

在CMakeLists.txt文件中配置CMake打包参数。

# entry/src/main/cpp/CMakeLists.txt
cmake_minimum_required(VERSION 3.4.1)
project(MyApplication2)set(NATIVERENDER_ROOT_PATH ${CMAKE_CURRENT_SOURCE_DIR})include_directories(${NATIVERENDER_ROOT_PATH}
${NATIVERENDER_ROOT_PATH}/include)# 添加名为entry的库
add_library(entry SHARED napi_init.cpp)
# 构建此可执行文件需要链接的库
target_link_libraries(entry PUBLIC libace_napi.z.so)

实现Native侧的CallNative以及NativeCallArkTS接口。具体代码如下：

// entry/src/main/cpp/napi_init.cpp
static napi_value CallNative(napi_env env, napi_callback_info info)
{
size_t argc = 2;
// 声明参数数组
napi_value args[2] = {nullptr};// 获取传入的参数并依次放入参数数组中
napi_get_cb_info(env, info, &argc, args, nullptr, nullptr);// 依次获取参数
double value0;
napi_get_value_double(env, args[0], &value0);
double value1;
napi_get_value_double(env, args[1], &value1);// 返回两数相加的结果
napi_value sum;
napi_create_double(env, value0 + value1, &sum);
return sum;
}static napi_value NativeCallArkTS(napi_env env, napi_callback_info info)
{
size_t argc = 1;
// 声明参数数组
napi_value args[1] = {nullptr};// 获取传入的参数并依次放入参数数组中
napi_get_cb_info(env, info, &argc, args , nullptr, nullptr);// 创建一个int，作为ArkTS的入参
napi_value argv = nullptr;
napi_create_int32(env, 2, &argv );// 调用传入的callback，并将其结果返回
napi_value result = nullptr;
napi_call_function(env, nullptr, args[0], 1, &argv, &result);
return result;
}

3.ArkTS侧调用C/C++方法实现

ArkTS侧通过import引入Native侧包含处理逻辑的so来使用C/C++的方法。

// entry/src/main/ets/pages/Index.ets
// 通过import的方式，引入Native能力。
import nativeModule from 'libentry.so'@Entry
@Component
struct Index {
@State message: string = 'Test Node-API callNative result: ';
@State message2: string = 'Test Node-API nativeCallArkTS result: ';
build() {
Row() {
Column() {
// 第一个按钮，调用add方法，对应到Native侧的CallNative方法，进行两数相加。
Text(this.message)
.fontSize(50)
.fontWeight(FontWeight.Bold)
.onClick(() => {
this.message += nativeModule.callNative(2, 3);
})
// 第二个按钮，调用nativeCallArkTS方法，对应到Native的NativeCallArkTS，在Native调用ArkTS function。
Text(this.message2)
.fontSize(50)
.fontWeight(FontWeight.Bold)
.onClick(() => {
this.message2 += nativeModule.nativeCallArkTS((a: number)=> {
return a * 2;
});
})
}
.width('100%')
}
.height('100%')
}
}

4.Node-API的约束限制

1）SO命名规则

导入使用的模块名和注册时的模块名大小写保持一致，如模块名为entry，则so的名字为libentry.so，napi_module中nm_modname字段应为entry，ArkTS侧使用时写作：import xxx from 'libentry.so'。

2）注册建议

nm_register_func对应的函数（如上述Init函数）需要加上static，防止与其他so里的符号冲突。
模块注册的入口，即使用__attribute__((constructor))修饰的函数的函数名（如上述RegisterDemoModule函数）需要确保不与其它模块重复。

3）多线程限制

每个引擎实例对应一个JS线程，实例上的对象不能跨线程操作，否则会引起应用crash。使用时需要遵循如下原则：

Node-API接口只能在JS线程使用。
Native接口入参env与特定JS线程绑定只能在创建时的线程使用。

【鸿蒙HarmonyOS Next实战开发】实现ArkTS/JS和C/C++的交互-Node-API

一、HarmonyOS Node-API简介在HarmonyOS应用开发中，通常以ArkTS/JS语言为主，但在一些特殊场景下，例如游戏开发、物理模拟等，由于对性能、效率等有较高要求，需要借助现有的C/C库来实现。为了满足这种需求，…...

编程日记 2025/7/2 20:06:10

QT笔记——多语言翻译

文章目录 1、概要2、多语言切换2.1、结果展示2.2、创建项目2.2、绘制UI2.2、生成“.st”文件2.4、生成“.qm”文件2.5、工程demo 1、概要借助QT自带的翻译功能，实现实际应用用进行 “多语言切换” 2、多语言切换 2.1、结果展示多语言切换 2.2、创建项目 1、文件…...

编程日记 2025/6/27 23:43:19

JPG、PNG、GIF有什么区别？

JPG、PNG、GIF是三种常见的数字图像格式，它们各自具有不同的特点和适用场景。以下是它们之间的主要区别以及如何进行选择： 一、JPG与PNG、GIF的区别 1. JPG（JPEG）： 特点：JPG是一种有损压缩的图像格式&…...

编程日记 2025/6/30 20:07:35

效果展示代码实现 Function QhBaiDuYunAIReq(question, _Optional Authorization "Bearer ", _Optional Qhurl "https://qianfan.baidubce.com/v2/chat/completions")Dim XMLHTTP As ObjectDim url As Stringurl Qhurl 这里替换为你实际的URLDim postD…...

编程日记 2025/7/1 1:24:03

机器学习在环境科学中的应用

机器学习在环境科学中的应用第一节机器学习的基本概念什么是机器学习机器学习是一种通过对大量数据的学习和分析，让计算机系统能够逐渐改善其性能和行为的技术。它通过建立数学模型来识别数据中的模式和规律，进而进行预测和决策。机器学习在环境科学…...

编程日记 2025/7/1 1:22:27

【AIGC魔童】DeepSeek v3推理部署：vLLM/SGLang/LMDeploy

【AIGC魔童】DeepSeek v3推理部署：vLLM/SGLang/LMDeploy （1）使用vLLM推理部署DeepSeek（2）使用SGLang推理部署DeepSeek（3）使用LMDeploy推理部署DeepSeek （1）使用vLLM推理部…...

编程日记 2025/6/30 16:30:52

Monorepo保姆级教程

Monorepo是一种将多个项目或组件存储在一个统一的代码仓库中的策略，旨在提高代码复用性和团队协作效率。以下是一个详细的Monorepo管理多个项目的保姆级教程： 1. 初始化项目首先，创建一个新的项目目录并初始化为Git仓库： mkdi…...

编程日记 2025/7/2 19:29:24

【蓝桥杯—单片机】第十一届省赛真题代码题解题笔记 | 省赛 | 真题 | 代码题 | 刷题 | 笔记

第十一届省赛真题代码部分前言赛题代码思路笔记竞赛板配置内部振荡器频率设定键盘工作模式跳线扩展方式跳线建立模板明确设计要求和初始状态显示功能部分数据界面第一部分第二部分第三部分调试时发现的问题参数设置界面第一部分第二部分和第四部分第三部分和第五部分按键功…...

编程日记 2025/7/2 19:26:55

hive的几种复杂数据类型

Hive的几种复杂数据类型 Hive 提供了几种复杂数据类型，能够支持更灵活和多样的数据存储。这些复杂数据类型对于处理嵌套数据或不规则数据特别有用。主要包括以下几种： 文章目录 Hive的几种复杂数据类型1. 数组（ARRAY）2. 结构体&a…...

编程日记 2025/7/2 19:18:19

使用 `WITH` 子句优化复杂 SQL 查询

使用 WITH 子句优化复杂 SQL 查询在 SQL 中，处理复杂的查询需求时，代码往往会变得冗长且难以维护。为了解决这个问题，SQL 提供了 WITH 子句（也称为公用表表达式，Common Table Expression，CTE）…...

编程日记 2025/7/1 1:23:11

k8s网络插件及基础命令

一、k8s的cni网络插件 1.k8s的内部网络模式 pod内的容器与容器之间的通信。一个节点上的pod之间的通信，docker0网桥直接通信。不同节点上的pod之间的通信：通过物理网卡的ip地址和其他节点上的物理网卡的设备进行通信，然后把流量转发到指定的…...

编程日记 2025/7/2 11:31:05

组合总和II(力扣40)

这道题的难点就在于题目所给的集合中有重复的数字，我们需要进行去重操作。首先明确去重指的是去重哪一部分。注意并不是对递归的集合去重，而是对当前集合的遍历进行去重。这么说可能有点抽象，举个例子：假设集合为1,1,2,3,4&#x…...

编程日记 2025/7/2 17:39:41

【vue3 入门到实战】7. 标签中的 ref

目录 1. ref 的作用 2. 如何使用 1. ref 的作用用于注册模板引用用在普通DOM标签上，获取的是DOM节点。用在组件标签上，获取的是组件的实例对象。 2. 如何使用代码如下 <template><div class"app"><h2 ref"titl…...

编程日记 2025/6/30 12:09:55

MAC OS安装Homebrew

文章目录 1.下载Homebrew2.完成安装3.验证安装4.更新 Homebrew作为一个包管理器，提供了一种简便的方式来安装、更新和卸载各种命令行工具和应用程序。相比于手动下载和编译源代码，或者从不同的网站下载安装包，使用Homebrew可以显著减少这些操…...

编程日记 2025/6/30 8:54:35

数据结构之栈和队列(超详解)

文章目录概念与结构栈队列代码实现栈栈是否为空，取栈顶数据、栈的有效个数队列入队列出队列队列判空，取队头、队尾数据，队列的有效个数算法题解有效的括号用队列实现栈用栈实现队列复用设计循环队列数组结构实现循环队列构造、销毁循环队…...

编程日记 2025/7/2 18:57:41

[Deepseek-自定义Ollama 安装路径+lmStudio 简易安装]

ollama 先下载 https://ollama.org.cn/download 使用发现报错检查路径自己的路径! 再用 .\OllamaSetup.exe /DIRE:\MySoftware\Ollama 删除掉多余模型 ollama delete <model_name> 例如 ollama delete deepseek-r1:1.5b 下载 ollama run deepseek-r1:1.5b…...

编程日记 2025/7/1 1:38:10

uniapp mqttjs 小程序开发

在UniApp中集成MQTT.js开发微信小程序时，需注意平台差异、协议兼容性及消息处理等问题。以下是关键步骤与注意事项的综合指南： 一、环境配置与依赖安装安装MQTT.js 推荐使用兼容性较好的版本：mqtt4.1.0（H5和小程序兼容性最佳&…...

编程日记 2025/7/2 5:12:09

LabVIEW位移测量系统

本文介绍了一种基于LabVIEW的位移测量系统，结合先进的硬件设备与LabVIEW平台的强大功能，能够实现对位移的精确测量和高效数据处理。该系统具备高精度、实时性和良好的可扩展性，适用于工程与科学实验中对位移测量的多种需求。项目背景位移…...

编程日记 2025/7/1 2:32:07

VMware下Linux和macOS遇到的一些问题总结

1.解决.NET程序通过网盘传到Linux和macOS不能运行的问题这是文件权限的问题。当你通过U盘将文件传输到虚拟机的macOS和Linux系统时，文件的权限和所有权可能得到了保留或正确设置。但如果你通过网盘上传，文件的权限或所有权可能没有正确设置&#xff0c…...

编程日记 2025/7/2 19:31:38

Mac: docker安装以后报错Command not found: docker

文章目录前言解决办法（新的）解决步骤（原来的）不推荐总结前言本操作参考 http://blog.csdn.net/enhenglhm/article/details/137955756 原作者，更详细请，查看详细内容请关注原作者。一般，…...

编程日记 2025/7/2 18:44:02

深度学习里面的而优化函数 Adam，SGD，动量法，AdaGrad 等 | PyTorch 深度学习实战

前一篇文章，使用线性回归模型逼近目标模型 | PyTorch 深度学习实战本系列文章 GitHub Repo: https://github.com/hailiang-wang/pytorch-get-started 本篇文章内容来自于强化学习必修课：引领人工智能新时代【梗直哥瞿炜】深度学习里面的而优化函数 …...

编程日记 2025/7/1 2:31:50

C++自研3D教程OPENGL版本---动态批处理的基本实现

又开始找工作了，借机休息出去旅行两个月，顺便利用这段时间整理下以前写的东西。以下是一个简单的动态批处理实现： #include <GL/glew.h> #include <GLFW/glfw3.h> #include <iostream> #include <vector>// 顶点结…...

编程日记 2025/7/2 19:46:18

如何使用deepseek开发一个翻译API

什么是deepseek Deepseek 是一个基于人工智能技术的自然语言处理平台，提供了多种语言处理能力，包括文本翻译、语义分析、情感分析等。它通过深度学习模型和大规模语料库训练，能够实现高质量的文本翻译和多语言理解。Deepseek 的核心优势在于…...

编程日记 2025/7/1 17:46:38

Java使用aspose实现pdf转word

Java使用aspose实现pdf转word 一、下载aspose-pdf-21.6.jar包【下载地址】，存放目录结构如图；配置pom.xml。  <dependency><groupId>com.aspose</groupId><artifactId>aspose-pdf</artifactId>…...

编程日记 2025/7/2 19:08:42

fs 文件系统模块

在 Node.js 中，fs（File System）模块提供了与文件系统进行交互的能力。无论是读取、写入还是操作文件和目录，fs 模块都提供了丰富的 API 支持。本文将详细介绍 fs 模块的基本用法、异步与同步方法的区别以及一些高级功能&#xff0…...

编程日记 2025/7/2 19:35:24

正激变换器拓扑

正激变换器拓扑是一种常见的DC-DC电源拓扑结构，以下是关于它的详细介绍： 基本组成 - 主开关：通常为MOSFET，用于控制输入电压的通断。 - 变压器：实现电压隔离和电压变换，传递能量。 - 续流二极管&#x…...

编程日记 2025/6/30 20:40:10

Rsyslog omhttp（HTTP输出模块）

个人博客地址：Rsyslog omhttp（HTTP输出模块） | 一张假钞的真实世界使用Rsyslog的omhttp模块可以将收集的日志数据以HTTP请求的方式输出。该模块支持单条/批量发送数据，支持GZIP压缩，支持HTTPS。 Rsyslog默认未包含o…...

编程日记 2025/7/2 19:45:32

防火墙与Squid代理服务器

服务器的安装、搭建与配置准备前期虚拟机版本：redhat Enterprise Linux Server release 7.2(Maipo)系统架构：x86虚拟机服务器地址：192.168.195.3Window地址：192.168.195.237进行ISO挂载操作进入root模式[yonghu@localhost 桌面]#su 返回上级目录文件进入media文件中，创建…...

编程日记 2025/7/2 18:44:02

为何实现大语言模型的高效推理以及充分释放 AI 芯片的计算能力对于企业级落地应用来说，被认为具备显著的研究价值与重要意义？

🍉 CSDN 叶庭云：https://yetingyun.blog.csdn.net/ AI 芯片：为人工智能而生的 “大脑” AI 芯片，又称人工智能加速器或计算卡，是专为加速人工智能应用，特别是深度学习任务设计的专用集成电路（A…...

编程日记 2025/7/2 15:34:38

【教程】docker升级镜像

转载请注明出处：小锋学长生活大爆炸[xfxuezhagn.cn] 如果本文帮助到了你，欢迎[点赞、收藏、关注]哦~ 目录自动升级手动升级无论哪种方式，最重要的是一定要通过-v参数做数据的持久化！ 自动升级使用watchtower，可…...

编程日记 2025/6/30 20:38:24

k8s常见面试题2

k8s常见面试题2 安全与权限RBAC配置如何保护 Kubernetes 集群的 API Server？如何管理集群中的敏感信息（如密码、密钥）？如何限制容器的权限（如使用 SecurityContext）？如何防止容器逃逸&#xff0…...

编程日记 2025/6/30 20:39:16

mysql运维

1、msyqlLinux通用二进制安装 1. MySQL :: Download MySQL Community Server (Archived Versions)https://downloads.mysql.com/archives/community/https://downloads.mysql.com/archives/community/https://downloads.mysql.com/archives/community/https://downloads.mysql…...

编程日记 2025/6/30 20:38:07