如何将自定义C++模块集成到自定义版本的 NodeJS 中?

How to Integrate Custom C++ Module into Custom Version of NodeJS?

本文关键字：自定义 版本 NodeJS 集成 C++ 模块      更新时间：2023-10-16

我希望创建一个使用 NodeJS 运行特定 JavaScript 文件的可执行文件。但是，这个 NodeJS 应该添加额外的"模块"，使用require向 JavaScript 范围公开C++类/函数。

到目前为止，我已经成功地将 NodeJS 编译为一个库，并将其链接到我的超级简单的C++程序：

#include <vector>
#include "node.h"
int main(int argc, char* argv[]) {
std::vector<char*> newArgs;
newArgs.push_back(argv[0]);
char file[] = "my_file.js";
newArgs.push_back(file);
return node::Start(2, &newArgs[0]);
}

如您所知，这只是在可执行文件的同一目录中执行名为"my_file.js"的JavaScript文件。

现在的问题是，我如何将我在此代码中创建的潜在C++类/函数公开给 JavaScript？

例如，我想做这样的事情：

#include <vector>
#include <iostream>
#include "node.h"
class Weather {
public:
Weather() {}
void makeItRain() {
std::cout << "It is rainingn";
}
};
int main(int argc, char* argv[]) {
std::vector<char*> newArgs;
newArgs.push_back(argv[0]);
char file[] = "my_file.js";
newArgs.push_back(file);
// hypothetical code
node::AddClass(Weather, "weather");
return node::Start(2, &newArgs[0]);
}

// my_file.js
var Weather = require("weather");
var w = new Weather();
w.makeItRain();

有什么建议吗？ 我发现的最接近的东西是 v8pp，但我不知道如何接收 v8：：Isolate 的实例。

你问的被称为"插件"，这里有很多官方文档：https://nodejs.org/api/addons.html

这并不像您问题中的假设代码那么容易，但基本原理是相同的。需要更多代码来桥接 C++ 和 JavaScript 的世界(请记住，其中一个是垃圾回收的，而另一个是手动内存管理的;一个是提前编译的，而另一个是作为源代码发布的(。

请注意"N-API"部分。默认情况下，您将针对 V8 的 C++ API 进行编程，该 API 有时会在版本之间发生变化。为了使您的插件与尽可能多的 Node/V8 版本兼容，N-API 提供了一个抽象层，该抽象层旨在随着时间的推移保持稳定。

相关文章：