napi

版本 & 兼容性

使用

#define NAPI_VERSION 3
#include <node_api.h>

version matrix
https://nodejs.org/api/n-api.html#n_api_n_api_version_matrix

Version 4 is an extension to version 3 in that it has all of the APIs from version 3 with some additions. This means that it is not necessary to recompile for new versions of Node.js which are listed as supporting a later version.

版本4有版本3的全部功能, 并添加了一些功能. 这意味着使用 NAPI_VERSION=3 编译的 addon, 没有必要为支持 NAPI_VERSION = 4/5/6 的 Node.js 版本重新编译.

例子

sharp

写死的 NAPI_VERSION=3, 目前正常版本都可以使用
https://github.com/lovell/sharp/blob/v0.25.1/binding.gyp#L51

ffi-napi

https://github.com/node-ffi-napi/node-ffi-napi/blob/v3.0.1/src/ffi.cc#L1-L2

#define NAPI_VERSION 6
#define NAPI_EXPERIMENTAL /* Until Node.js v12.17.0 is released */

~~只支持比较新的 node.js 版本.~~, 只支持这两个版本

prebuild

https://github.com/prebuild/prebuild

需要指定支持的 napi-version, 比如 sharp 写只支持 3, 无论当前 NAPI_VERSION 是多少, prebuild-install 都会去下载 napi-3 的版本.

gyp / node-gyp / napi / node-addon-api #67

Description

gyp & node-gyp

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions