特点

你可以从 package-template 开始，尝试使用 napi-rs

定义 JavaScript 函数

#[js_function(1)] // ------> arguments length
fn fibonacci(ctx: CallContext) -> Result<JsNumber> {
  let n = ctx.get::<JsNumber>(0)?.try_into()?;
  ctx.env.create_int64(fibonacci_native(n))
}

#[inline(always)]
fn fibonacci_native(n: i64) -> i64 {
  match n {
    1 | 2 => 1,
    _ => fibonacci_native(n - 1) + fibonacci_native(n - 2),
  }
}

注册模块

#[macro_use]
extern crate napi_derive;

use napi::{JsObject, Result};

/// `exports` is `module.exports` object in NodeJS
#[module_exports]
fn init(mut exports: JsObject) -> Result<()> {
  exports.create_named_method("fibonacci", fibonacci)?;
  Ok(())
}

同时，你还可以在注册模块时创建 JavaScript 值

#[macro_use]
extern crate napi_derive;

use napi::{JsObject, Result, Env};

#[module_exports]
fn init(mut exports: JsObject, env: Env) -> Result<()> {
  exports.create_named_method("fibonacci", fibonacci)?;
  exports.set_named_property("DEFAULT_VALUE", env.create_int64(100)?)?;
  Ok(())
}

构建

这个存储库是一个 Cargo 包。任何基于 napi 的插件都应该包含 Cargo.toml，使其成为一个 Cargo 包。

在你的 Cargo.toml 中，你需要将 crate-type 设置为 "cdylib"，这样 cargo 就会构建一个可以被 Node 可执行文件动态加载的 C 风格共享库。你还需要将此包作为依赖项添加。

[package]
name = "awesome"

[lib]
crate-type = ["cdylib"]

[dependencies]
napi = "1"
napi-derive = "1"

[build-dependencies]
napi-build = "1"

并在你自己的项目中创建 build.rs

// build.rs
extern crate napi_build;

fn main() {
  napi_build::setup();
}

到目前为止，napi 构建脚本只在 macOS Linux Windows x64 MSVC 和 FreeBSD 上进行了测试。

{
  "package": "awesome-package",
  "devDependencies": {
    "@napi-rs/cli": "^1.0.0"
  },
  "napi": {
    "name": "jarvis" // <----------- Config the name of native addon, or the napi command will use the name of `Cargo.toml` for the binary file name.
  },
  "scripts": {
    "build": "napi build --release",
    "build:debug": "napi build"
  }
}

require('./jarvis.node')

napi build [--release] ./dll
napi build [--release] ./artifacts

yarn build:test
yarn test