Node.js_8.0_N-API_入门极简例子

全文链接

本文摘录自《Nodejs学习笔记》，更多章节及更新，请访问 github主页地址。欢迎加群交流，群号 197339705。

N-API简介

Node.js 8.0 在2017年6月份发布，升级的特性中，包含了N-API。编写过或者使用过 node扩展的同学，不少都遇到过升级node版本，node扩展编译失败的情况。因为node扩展严重依赖于V8暴露的API，而node不同版本依赖的V8版本可能不同，一旦升级node版本，原先运行正常的node扩展就编译失败了。

这种情况对node生态圈无疑是不利的，N-API的引入正是试图改善这种情况的一种尝试。它跟底层JS引擎无关，只要N-API暴露的API足够稳定，那么node扩展的编写者就不用过分担忧node的升级问题。

如何使用N-API

先强调一点，N-API并不是对原有node扩展实现方式的替代，它只是提供了一系列底层无关的API，来帮助开发者编写跨版本的node扩展。至于如何编写、编译、使用扩展，跟原来的差不多。

本文会从一个超级简单的例子，简单介绍N-API的使用，包括环境准备、编写扩展、编译、运行几个步骤。

备注：当前N-API还处于试验阶段，官方文档提供的例子都是有问题的，如用于生产环境需格外谨慎。

1、环境准备

首先，N-API是8.0版本引入的，首先确保本地安装了8.0版本。笔者用的是nvm，读者可自行选择安装方式。

nvm i 8.0
nvm use 8.0

然后，安装node-gyp，编译扩展会用到。

npm install -g node-gyp

创建项目目录，并初始化package.json。

mkdir hello & cd hello # 目录名随便起
npm init -f

 

转载于:https://my.oschina.net/u/3462387/blog/915482