node.js调用C++的一种方案-Toy模板网

这篇具有很好参考价值的文章主要介绍了node.js调用C++的一种方案。希望对大家有所帮助。如果存在错误或未考虑完全的地方，请大家不吝赐教，您也可以点击"举报违法"按钮提交疑问。

nodejs官方维护了一套ABI（应用二进制接口），用于完成nodejs和C++的通信。

官网介绍的Node-API是C API，对应的node-addon-api是它的C++版本，更容易使用，本文介绍的也是这个C++的版本。

通过一个示例来说明如何使用node-addon-api

node-addon-api简单示例

1、初始化一个空项目（生成package.json文件）

npm init

2、安装node-addon-api

npm install node-addon-api

接下来，编写一个Calculate类，用于求两个数的和

3、src/Calculate.h

#ifndef __Calculate__
#define __Calculate__

class Calculate
{
public:
    static double add(double, double);
};

#endif

4、src/Calculate.cpp

#include "Calculate.h"

double Calculate::add(double a, double b)
{
    return a + b;
}

5、src/index.cpp，编写C++和nodejs的中间文件

node-addon-api在C++代码中使用，完成数据类型的统一和接口的暴露

通过 node-addon-api 暴露与 nodejs 通信的参数

#include <napi.h>
#include "Calculate.h"

Napi::Value Add(const Napi::CallbackInfo& info)
{
    Napi::Env env = info.Env();
    if (info.Length() < 2)
    {
        Napi::TypeError::New(env, "参数个数异常").ThrowAsJavaScriptException();
        return env.Null(); // 返回JavaScript的null
    }
    if (!info[0].IsNumber() || !info[1].IsNumber())
    {
        Napi::TypeError::New(env, "参数类型异常").ThrowAsJavaScriptException();
        return env.Null();
    }
    // Napi::Value -> Napi::Number
    double arg0 = info[0].As<Napi::Number>().DoubleValue();
    double arg1 = info[1].As<Napi::Number>().DoubleValue();
    double sum = Calculate::add(arg0, arg1);
    Napi::Number result = Napi::Number::New(env, sum);
    return result;
}

void About(const Napi::CallbackInfo& info)
{
    Napi::Env env = info.Env();
    Napi::Function cb = info[0].As<Napi::Function>();
    // C++中向JavaScript传过来的函数传递参数并执行它
    cb.Call(env.Global(), { Napi::String::New(env, "这是一个计算类") });
}

Napi::Object Init(Napi::Env env, Napi::Object exports)
{
    exports.Set(
        Napi::String::New(env, "add"),
        Napi::Function::New(env, Add)
    );

    exports.Set(
        Napi::String::New(env, "about"),
        Napi::Function::New(env, About)
    );

    return exports;
}

// 第一个参数为模块名称，与binding.gyp中target_name对应
NODE_API_MODULE(cal, Init);

上面的代码暴露给nodejs两个方法：

Add方法接收nodejs传过来的两个数值，返回它们的和给调用Add的nodejs程序。
About方法接收nodejs传过来的回调函数，在C++中传参并调用该函数。

Add方法的最后，C++的double转换成了Napi::Value，实现了不同语言间的转换。

CallbackInfo用于接收JavaScript传递给C++的参数，用中括号索引。

凡是用node-addon-api来混合开发的程序都需要这样一个中间文件。

6、binding.gyp，编译

安装编译工具node-gyp，把C++程序编译成后缀名为.node的Native Addon二进制文件（本质是动态链接库，只不过后缀是.node，而不是.dll）。

npm install -g node-gyp

node-gyp作用类似于CMake，需要有python环境，根据配置文件binding.gyp进行编译。

binding.gyp 作用相当于CMake的CMakeLists.txt，告诉node-gyp如何去构建

{
    "targets": [
        {
            # 全局唯一的目标文件名称。本例编译生成cal.node
            "target_name": "cal",
            # C++源文件
            "sources": [
                "./src/Calculate.cpp",
                "./src/index.cpp"
            ],
            # C++头文件目录
            "include_dirs": ["<!@(node -p \"require('node-addon-api').include\")"],
            "dependencies": ["<!(node -p \"require('node-addon-api').gyp\")"],
            "cflags!": [ "-fno-exceptions" ],
            "cflags_cc!": [ "-fno-exceptions" ],
            # 静态库
            "libraries": [],
            "msvs_settings": {
                "VCCLCompilerTool": { "ExceptionHandling": 1 },
            },
            # 预编译宏，禁用Node-API的C++异常处理和node-addon-api废弃的API
            "defines": ["NAPI_DISABLE_CPP_EXCEPTIONS", "NODE_ADDON_API_DISABLE_DEPRECATED"]
        }
    ]
}

7、生成构建文件

创建 binding.gyp 文件后，为当前平台生成项目构建文件。

node-gyp configure

新生成一个build文件夹，结构如下图。

js调用c++库,C++,node.js,c++,开发语言

8、构建并编译

根据需要选择生成Release或者Debug版本

Release版本：

node-gyp build

在build下生成一个Release文件夹

js调用c++库,C++,node.js,c++,开发语言

Debug版本：

node-gyp build --debug

在build下生成一个Debug文件夹

js调用c++库,C++,node.js,c++,开发语言

9、nodejs调用

在nodejs中以模块的方式（require）引入C++编译得到的二进制文件

根目录创建index.js

const addon = require("./build/Debug/cal.node");

const sum = addon.add(5, 3);
console.log("sum = " + sum);

addon.about(function (msg) {
    console.log(msg);
});

在控制台执行 node index.js 即可看到结果

调试配置

光把程序写出来还不够，走通调试流程也是必不可少的

创建VS Code的调试配置文件launch.json

{
    // Use IntelliSense to learn about possible attributes.
    // Hover to view descriptions of existing attributes.
    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "type": "node",
            "request": "launch",
            "name": "JS Debug Build",
            "console": "integratedTerminal",
            "program": "${workspaceFolder}/index.js"
        },
        {
            "name": "Windows Attach",
            "type": "cppvsdbg",
            "request": "attach",
            "processId": "${command:pickProcess}"
        }
    ]
}

configurations第一个花括号的内容是nodejs的调试启动项；第二个花括号是C++的调试启动项

request可以是"launch"（启动）或"attach"（附加）

console是终端选项，设置为integratedTerminal则使用VSCode内部集成终端显示调试结果

操作步骤：

1）js文件打好断点

js调用c++库,C++,node.js,c++,开发语言