作者:手机用户2502897625 | 来源:互联网 | 2023-10-13 13:32
NAN引见NAN的全称为NativeAbstractionforNode.js,其表现上是一个Node.js包。装置后,就获得一堆C++头文件,内里是一堆宏。它主要为Node.js
NAN引见
NAN的全称为Native Abstraction for Node.js, 其表现上是一个Node.js包。装置后,就获得一堆C++头文件,内里是一堆宏。它主要为Node.js和V8跨版本供应了封装的宏,使得开辟者不必体贴各个版本之间的API的差别。(from 《nodejs来一打C++扩大》)
NAN的上风在于能够屏障差别版本Node的API,使得C++扩大能够wirte once, compile anywhere
,一份C++扩大能够适用于差别版本的Node.js。这里的c++扩大完成的功用是一个乞降的扩大(hello world太多了,写个不一样的)
扩大地点为:https://www.npmjs.com/package…,
项目代码地点:https://github.com/warjiang/d…
运用体式格局以下:
项目目次以下:
在开辟之前我们起首须要装置nan包(npm install nan -S
)。扩大开辟分红两个层面,c++层面和JS层面。src目次中主如果c++代码,也是扩大的完成部份。index.js援用c++扩大,暴露出要领供上层运用。
首次开辟nodejs扩大的用户须要注意下项目目次中的binding.gyp文件(node-gyp会读取项目中的binding.gyp):
target_name为sum,示意末了天生的扩大文件名为sum.node
。include_dirs示意除了nodejs基本的依靠以外,我们还须要nan的头文件, 中示意背面是敕令,node -e "require('nan')"
就是应用nodejs的require才能,寻觅nan的目次,实行效果以下:
sources项指清楚明了c++扩大须要编译的源文件。
c++部份开辟
先直接上代码(src/init.cc):
#include
#include
#include
using v8::Local;
using v8::Object;
using v8::Number;
NAN_METHOD(sum){
Nan::HandleScope scope;
uint32_t sum = 0;
for(int i = 0; i sum += info[i]->NumberValue();
}
info.GetReturnValue().Set(Nan::New(sum));
}
void init (Local exports)
{
Nan::HandleScope scope;
Nan::SetMethod(exports, "sum", sum);
}
NODE_MODULE(memwatch, init);
扩大的进口从NODE_MODULE(memwatch, init);
最先,当js层面实行了require('path/to/xxx.node')
的时刻,就会实行init函数。
init函数的入参能够类比module.exports对象,这里我们给exports对象增添了一个名为sum的要领,其对应的完成为NAN_METHOD(sum)
部份。
NAN_METHOD(sum)
经由过程宏定义对sum函数举行包装,sum函数的入参为info数组,我们再这里遍历info数组,经由过程info[i]->NumberValue
要领将每一个入参对应的number范例的值取出来,加到sum中去。累加完成后经由过程info.GetReturnValue().Set(Nan::New(sum))
将sum效果返回出去。如许实在我们的c++部份扩大就已开辟终了了,能够经由过程实行node-gyp configure && node-gyp build
编译项目,在build/Release
目次下会天生sum.node
的文件。我们能够启动一个node的敕令行举行考证:
// node cli
> let addon = require('./build/Release/sum')
> addon.sum(1) // 1
> addon.sum(1,2) // 3
援用build/Release/sum
的体式格局现实开辟中非常不方便,我们能够用js对这行代码举行封装,在js内部援用build/Release/sum
,暴露出来要领给外部举行挪用。
js部份开辟
有了上面的铺垫,这里我们开辟js部份就显得非常天然。直接上代码
const addon = require('./build/Release/sum')
module.exports = addon.sum
一共就两行代码,逻辑清楚简朴,就援用编译好的扩大,将sum要领暴露出去。
宣布
nodejs扩大宣布的时刻须要在package.json的scripts部份增添install钩子的处置惩罚,以下:
用户装置扩大的时刻,会在install的钩子上,协助用户实行node-gyp rebuild
来在用户的机械上天生对应的扩大文件。如许我们的开辟就终了了,实行npm publish
将npm包宣布出去