Nodeのnative moduleをRustで書いてみる(Neon)

2020-02-01 2 min read

RustプログラムのGUIにElectronを使うことを考えています。

その前調査としてNodeのネイティブモジュールとしてRustプログラムを利用できるようにする Neon というツールを使ってHello, worldしてみることにしました。

インストール

今回、先立ってインストールしていた関連プロダクトは次のとおりです。

その他、意識していませんが、Python2.7(not 3.x)、GCCなども必要なようです。詳しくは Getting Started参照。

yarn global add neon-cli

neon new thread-count
cd thread-count
neon build --release

これでテンプレートのビルドができました。

実行するには、これまたリファレンスの通りですが、

node

コマンドを実行して起動するREPLで

require('.')

と入力します。あるいは、 neon new thread-count コマンドを打ったときに出ていたメッセージの通り、 node コマンドに -e オプションで実行文を渡す、つまり

node -e 'require(".")'

でもOKです。

さてここで require('.') は何をやっているんだ、ということなんですが、これはNodeのリファレンス Modules > All Together…の "LOAD_AS_DIRECTORY(X)"セクションに書いてあることのようです。

具体的には、引数に指定したパスを所定のルールで解釈していって、今回の場合はカレントディレクトリにある package.json の main フィールドに指定されているファイル lib/index.js を実行しているようです。そこで、このファイルを見てみます。

lib/index.js

var addon = require('../native');

console.log(addon.hello());

ここでも require が出てきました。今度は ../native が指定されています。ここでは先程のリファレンスの、 "LOAD_INDEX(X)" の3番、 native/index.node がバイナリアドオンとしてロードされる、ということのようです。

Neonのリファレンスに戻ると、次のように説明があります:

native/index.node: the native module itself, which is loaded by lib/index.js.

native ディレクトリをRustプロジェクトルートディレクトリとみなして作業すれば良さそうです。

1点注意があるとすれば、自動生成された Cargo.toml に edition の指定が無かったため、自分の見慣れない exrern が現れたりして？？？となってしまいました。 edition = "2018" は即追加しておきましょう。