调用 c++原生 dll ​

通常在很多时候使用 electron 中，我们不止只是使用了前端的一些东西，相对的包括我们可能有些代码不想使用 js 来处理，等种种原因，需要我们去调用 c++写的 dll 库。

npm install ffi-napi

npm install ffi-napi

首先安装 ffi-napi，由于原本的 node-ffi 已经一年没有更新了，导致无法和 electron 的新版本兼容，让很多人在使用它的时候，都只能被迫降级到 4.x，但是又不能享受新版 electron 带来的便利，这个库完美的解决了我们的问题。

• 如何使用？

  • 首先确保您已经生成正确的 dll 文件；并且已经安装了 ffi-napi。
  • 在 static 同级目录内创建一个文件夹，名字自取；然后修改config/index.js中的DllFolder对象，它接受字符串类型，是你刚刚创建的文件夹名称。
  • 然后放置你的 dll 文件到你新创建的文件夹内重启一次，然后就可以按照一下方法进行调用了
  • 打包前，请去 package.json 文件找到extraFiles数组，并且在内填入你刚刚创建的文件夹名称，同样也是字符串

主进程中使用 ​

// 主进程中调用
import ffi from "ffi-napi";

const dll = ffi.Library(`${process.env.libPath}/文件名.后缀`, {
  // 这里是c++中对js暴漏的方法，举个例子：
  // 这里是c++中暴漏了一个名为test的方法，它接受两个int类型，返回结果也是int类型
  test: ["int"[("int", "int")]],
});
// 假设该c++中的方法是相加并抛出结果，那么这里得出的结果应该是4
dll.test(1, 3);

// 主进程中调用
import ffi from "ffi-napi";

const dll = ffi.Library(`${process.env.libPath}/文件名.后缀`, {
  // 这里是c++中对js暴漏的方法，举个例子：
  // 这里是c++中暴漏了一个名为test的方法，它接受两个int类型，返回结果也是int类型
  test: ["int"[("int", "int")]],
});
// 假设该c++中的方法是相加并抛出结果，那么这里得出的结果应该是4
dll.test(1, 3);

渲染进程中使用（无非必要，不推荐） ​

// 渲染进程中调用
import ffi from "ffi-napi";

const dll = ffi.Library(`${__lib}/文件名.后缀`, {
  // 这里是c++中对js暴漏的方法，举个例子：
  // 这里是c++中暴漏了一个名为test的方法，它接受两个int类型，返回结果也是int类型
  test: ["int"[("int", "int")]],
});
// 假设该c++中的方法是相加并抛出结果，那么这里得出的结果应该是4
dll.test(1, 3);

// 渲染进程中调用
import ffi from "ffi-napi";

const dll = ffi.Library(`${__lib}/文件名.后缀`, {
  // 这里是c++中对js暴漏的方法，举个例子：
  // 这里是c++中暴漏了一个名为test的方法，它接受两个int类型，返回结果也是int类型
  test: ["int"[("int", "int")]],
});
// 假设该c++中的方法是相加并抛出结果，那么这里得出的结果应该是4
dll.test(1, 3);

此处假设我 dll 放置目录的名称叫 lib

"build": {
    "extraFiles": [
    "lib"
    ],
}

"build": {
    "extraFiles": [
    "lib"
    ],
}

• 但开发途中是绝对不会这么一帆风顺的，就我在摸索的时候，遇到的问题总结如下：
  • Q：控制台报错：Uncaught Error: Dynamic Linking Error: Win32 error 126
  • A：该报错是由于 dll 文件位置不对引起的，文件路径是否和上面一样，否则您需要使用绝对路径。
  • Q：控制台报错：Uncaught Error: Dynamic Linking Error: Win32 error 193
  • A：dll 位数不对导致的，32 位 dll 只能给 32 位程序使用，64 位只能给 64 位程序使用，二者不可混合使用。
  • Q：控制台报错：Uncaught Error: Dynamic Linking Error: Win32 error 127
  • A：该报错是由于在 js 中声明了 c++中没有的方法导致的，请注意 c++中暴漏的函数名；或者是当前 dll 引用了其他资源文件它没有加载成功。
  • Q：控制台报错：Uncaught Error: Dynamic Linking Error: Win32 error 1114
  • A：该报错是在打包时，dll 释放位置错误，导致程序去 c 盘查找后无果得到的 dll 丢失错误。（后面会谈这个打包之后的 dll 问题）
  • Q：控制台报错：Uncaught (in promise) Error: \\?\C:\Users\%userName%\Desktop\electron-vue-template\node_modules\ref-napi\build\Release\binding.node is not a valid Win32 application. \\?\C:\Users\%userName%\Desktop\electron-vue-template\node_modules\ref-napi\build\Release\binding.node
  • A：这种错误通常出现在你打包过一次之后发生，此时你只需要去你的 node_modules/ffi-napi 文件夹内重新执行一次 npm install 或者 yarn install 即可解决。