私の電子チュートリアルシリーズ

入門

Node.jsの+電子環境、使用方法この1は、説明しますnode-ffi/ffi-napi書かれたコールC / C ++のダイナミックリンクライブラリ（すなわちDLL）が、実装はC / C ++コードを呼び出します。

このチュートリアルでは、電子の4.x-6.xのバージョンのです。

このような電子4.2.10バージョン、電子5.0.6バージョン、電子6.0.10バージョンとして。

FFI

この機能を実現するために、主に使用プラグffi。

ノードFFIは、純粋なJavaScriptは、プラグインをロードすることで、Node.jsの動的ライブラリを呼び出します。任意のC ++のコードを記述することなく、結合ローカルDLLライブラリを作成するために使用することができます。同時にそれは、JavaScriptとC.間で型変換を処理します

node-ffi共有メモリを介してコールを完了するために、CコードとJSコードを接続し、内部を通過しref、ref-arrayそしてref-struct変換を達成します。

インストールFFI-NAPI

ffi-napiそれはに従って著者（ノード-FFI-NAPI）であるnode-ffiとのリリースを変更するnpm仓库には、NPM、およびNode.jsの12高電子版のサポートを経由して直接インストールすることができます。

ffi-napi詳細については、以下を参照してください。FFI-NAPIのgithubのページを

node-ffiFFIが公式バージョンですが、あなたは、障害の原因、それに興味があるならば、私たちのプロジェクトで使用することはできません、私はこの記事の最後のセクションに書いています。

+電子環境1.デプロイのNode.js

Node.jsの+電子コース（A）：インストールと電子nodejs

2.インストールFFI-NAPI

実行コマンド：

yarn add ffi-napi

使用ffi-napi

中には、main.js次のコードを追加します。

const ffi = require('ffi-napi');
/**
 * 先定义一个函数, 用来在窗口中显示字符
 * @param {String} text
 * @return {*} none
 */
function showText(text) {
  return new Buffer(text, 'ucs2').toString('binary');
};
// 通过ffi加载user32.dll
const myUser32 = new ffi.Library('user32', {
  'MessageBoxW': // 声明这个dll中的一个函数
    [
      'int32', ['int32', 'string', 'string', 'int32'], // 用json的格式罗列其返回类型和参数类型
    ],
});

// 调用user32.dll中的MessageBoxW()函数, 弹出一个对话框
const isOk = myUser32.MessageBoxW(
    0, showText('I am Node.JS!'), showText('Hello, World!'), 1
);
console.log(isOk);

このコードは、user32.dllののメインウィンドウを呼び出して、具体的な手順は、コードのコメントに書かれています。

プログラムを起動します。

標高開始

ポップな外観、Hello Worldの！

自分のDLLを生成します

0明確にするための最初の事はこれです：

FFIのみではなく、それは標準のC関数に応じてコンパイルされ、純粋なC関数を受け入れます

これは、以下の特定の理由をこう述べています。

DLL FFIによって導入されたとき、私たちは、このような宣言があります：

const myUser32 = new ffi.Library('user32', {
  'MessageBoxW': // 声明这个dll中的一个函数
    [
      'int32', ['int32', 'string', 'string', 'int32'], // 用json的格式罗列其返回类型和参数类型
    ],
});

ではuser32.dll真ん中、という名前を探しているMessageBoxW機能。

しかし、CやC ++の関数名が異なる場合、私は、コンパイルされた関数の名前を意味します

Cのために、機能がint func(int n)類似にコンパイルされる_funcような名前。

C ++のために、機能がint func(int n)類似したにコンパイルされます?func@@YAHH@Zこのような名前。

同じ機能は、C ++であり、int func(int double)同様のにコンパイルされる?func@@YAHN@Z（異なるとに）そのような名前。

名前は、次のようなより多くの情報が、含まれています。

描画モードパラメータは
のタイプを返す
パラメータの種類と数を

C ++を持っているので、これはある函数重载機能が命名されているが、特性をfunc、しかし、int func(int n)そしてint func(int double)全く異なる機能、それらに異なる名前を割り当てることによって、それらを区別するためのコンパイラです。

あなたが興味を持っている場合は、ここではより詳細な説明です

戻るFFIは、それが時間内にDLL内の関数の名前を探し、それがC-のスタイルを見つけることです。

C ++コンパイラでは、あなたの関数のであれば、このDLL内のFFLがエラーでこの機能を見つけることができませんLINK 126！

1.プロジェクトを作成します。

VSを使用して、名前myAddDll例に中に突出せるには、空のC ++プロジェクトを作成します。

もちろん、あなたも直接ダイナミックリンクライブラリDLLを作成することができます。

2.タイプの.dll動的ライブラリの設定を変更

図：

プロジェクト構成では、動的ライブラリを選択した.dll

あなたはx64の環境で発生することを保証しながら、あなたは、デバッグとリリースを設定していることを確認します。

3.関数の宣言

创建一个myAdd.h头文件

声明一个函数:

extern "C"
{
    __declspec(dllexport) int funAdd(int a, int b);
}

extern "C"意味着:

被 extern "C" 修饰的变量和函数是按照 C 语言方式编译和链接的

__declspec(dllexport)意味着:

__declspec(dllexport)用于Windows中的动态库中，声明导出函数、类、对象等供外面调用，省略给出.def文件。即将函数、类等声明为导出函数，供其它程序调用，作为动态库的对外接口函数、类等。

4. 函数定义

创建一个myAdd.cpp文件

定义funAdd函数:

#include "myAdd.h"
int funAdd(int a, int b)
{
  return (a + b);
}

函数的内容很简单, 接受两个int类型参数, 返回它们的和.

5. 生成dll

右键项目选择生成即可, 生成的myAddDll.dll位于项目目录下的x64/Debug中.

(根据你项目的配置去找, x64或x86, Debug或Release)

6. 测试dll

将myAddDll.dll拷贝至你的electron项目的根目录下的dll文件夹内

在main.js中添加如下代码:

const ffi = require('ffi-napi'); // 如果前面已经定义过ffi, 就注释掉这一行
// 通过ffi加载myAddDll.dll
const myAddDll = new ffi.Library('./dll/myAddDll', {
  'funAdd': // 声明这个dll中的一个函数
    [
      'int', ['int', 'int'], // 用json的格式罗列其返回类型和参数类型
    ],
});

// 调用函数, 参数1和2, 将返回值直接打印出来, 预计为3
const result = myAddDll.funAdd(1, 2);
console.log(`the result of 1 + 2 is: `+ result);

这段代码中, 主要调用了myAddDll.dll中的int funAdd(int, int), 具体的步骤都写在了代码的注释中.

启动程序:

npm start

查看cmd中的日志:

the result of 1 + 2 is: 3

6.1 可能的错误

LINK 126

这个错误, 意味者electron无法使用你的dll.

在这行代码中

const myAddDll = new ffi.Library('./dll/myAddDll', {

ffi.Library的第一个参数, 不光指定了dll的名字, 还指定了dll的路径.

出现LINK 126有两个常见原因:

没有这个目录, 或这个目录下没有myAddDll.dll
myAddDll.dll还依赖了其他的一些dll, 但是electron无法找到这个dll.

LINK 127

出现LINK 127的可能原因:

electron找到了你的dll, 但是在dll中找不到你声名的函数(funAdd).这通常是由于函数名字错误, 或者是返回值类型/参数的个数及类型不一致导致的.

node-ffi为什么会安装失败

如果我们按照node-ffi的github链接中介绍的方法来安装ffi, 即

npm install ffi

然后尝试在main.js中加上一句代码来导入这个模块,

const ffi = require('ffi');

运行一下

npm start

你会得到, 一个错误!

仔细看看提示:

The module xxxxxx was compiled against a different Node.js version using
NODE_MODULE_VERSION 69. This version of Node.js requires
NODE_MODULE_VERSION 73

简单地说:

这个模块是用一个NODE_MODULE_VERSION 69的node.js版本进行编译的,
而当前的版本的Node.js需要NODE_MODULE_VERSION 73(来进行编译).

那么NODE_MODULE_VERSION是什么意思? 后面的数字又是什么意思?

我们在这里可以查询到, 各个NODE_MUODULE_VERSION对应的node.js版本或electron版本, 也叫做node_abi.

再翻译一下错误提示:

这个模块是用一个electron 4.0.4 版本进行编译的,
而当前的版本需要electron 6(来进行编译).

目前为止, 我们的问题解决方案:

重新编译.

重新编译, 指定electron版本, 执行指令:

npm rebuild --runtime=electron --target=6.0.10 --disturl=https://atom.io/download/atom-shell --abi=73

注: 从https://atom.io/download/atom-shell下载会比较慢, 请自备梯子, 或者使用淘宝库来下载.

日志中打印出了多条error, 原因是:

node-ffi里面会调用v8或其他依赖模块的接口, 而这些接口已经更新了, 有的接口改了名字, 有的接口改了参数数量. 但是node-ffi的调用接口语句并没有更新, 所以编译不过.

进一步的问题解决方案:

修改node-ffi的代码, 以适应新版本的v8, 和其他依赖模块.

一般而言, 我建议翻阅github中该项目的的issues, 在关于编译和electron的话题中, 你会找到其他人已经修改好的代码, 通常是一个该项目的fork版本. 你需要下载这个fork版本的源码, 将它拷贝至你的项目node_modules文件夹中, 使用上面的编译指令编译安装.

而前文介绍的ffi-napi是一个特殊情况, 作者不光修改了node-ffi. 还把它修改后的代码上传到了npm仓库, 所以我们可以通过npm install ffi-napi来进行安装, 不必按照下载-拷贝-编译的流程来安装它.

電子チュートリアル（III）：Cに導入されたDLL FFI-NAPIを使用++