Electron通过ffi-napi调用dll导出接口
Electron通过ffi-napi调用dll导出接口
本文将详细介绍如何在Electron环境中使用ffi-napi调用DLL接口。通过本文，你将学习到如何搭建Node.js环境、安装Electron和ffi-napi，以及如何在主进程和渲染进程中引用ffi-napi模块。
electron使用ffi-napi环境搭建
附打包好的ffi-napi可以直接放到项目目录下使用，避免以后麻烦
一、安装node.js
Node.js官网：https://nodejs.org/zh-cn/download，选择LTS长期稳定版本即可
需要注意Node.js 区分32和64位，32位版本只能加载32位的DLL，64位的版本只能加载64位的DLL。建议下载x64，nodejs的位数决定后续electron以及node-gyp的位数。
安装教程参考：https://www.runoob.com/nodejs/nodejs-install-setup.html
二、安装Electron
方法一：使用node原始包管理工具npm安装。-g 全局安装
npm install -g electron
方法二：使用淘宝提供的cnpm
npm install -g cnpm --registry=https://registry.npm.taobao.org
然后使用cnpm安装
cnpm install -g electron
安装报错：
CERT_HAS_EXPIRED 错误通常是指在使用 HTTPS 协议进行请求时，SSL 证书已过期，导致请求失败。解决方法是将https改为http。
注意：直接使用npm install electron他会下载npm包管理中的较新版本的electron（例如v34.2.0）。在electron20.3.8之后调用C++动态库会出现Error: Error in native callback错误。
原因：Electron 21 及更高版本将启用 V8 内存隔离区,这将对一些原生模块产生影响。
解决方案：降低electron版本，目前论坛大部分使用20.3.8（20.3.8版本太旧，使用cnpm安装成功的）。
cnpm install electron@20.3.8
三、安装ffi-napi
安装python
选择最新版本python3.13.2 64位
下载地址：https://devguide.python.org/versions/
安装时记得勾选写入环境变量
安装VS
VS2022 Community下载地址：https://visualstudio.microsoft.com/zh-hans/thank-you-downloading-visual-studio/?sku=Community
查看ffi-napi官网描述如下：
安装 Visual C++ 构建环境：
对于 Visual Studio 2019 或更高版本，请使用Visual Studio Community Desktop development with C++中的工作负载。对于 Visual Studio 2019 之前的版本，请使用选项安装Visual Studio 构建工具Visual C++ buildtools
论坛上看到的
我的系统时win10，并且我安装VS2017时已经安装了Windows 10 SDK, 所以我取消了默认的windows 11 SDK的安装
安装ffi-napi时会用到node-gyp编译工具，他对vs版本匹配非常严格
安装成功！！！！！
四、引用ffi-napi模块
- 主进程中：main.js
const { app, BrowserWindow, ipcMain} = require('electron');
const ffi = require('ffi-napi');
const ref = require('ref-napi');
const path = require('path');
const dllPath = path.join(__dirname, './test_api-x64.dll');
//test为dll中导出的接口，第一个int为返回值类型，第二、三个是参数类型
const libm = ffi.Library(dllPath, {
'test': ['int',[ 'int','int']]
});
// 处理 IPC 消息
ipcMain.on('call-test', (event, args) => {
const { a, b } = args;
console.log('调用DLL函数 test，参数:', a, b);
try {
const result = libm.test(a, b);
event.sender.send('test-result', { a, b, result });
} catch (error) {
console.error('DLL调用失败:', error);
event.sender.send('error', { message: 'DLL调用失败', details: error.message });
}
});
- 渲染进程render.js
const { ipcRenderer } = require('electron');
const button_test = document.getElementById('button_test');
const textBox_result = document.getElementById('textBox');
button_test.addEventListener('click', () => {
const a = 5;
const b = 6;
ipcRenderer.send('call-test', { a, b });
});
ipcRenderer.on('test-result', (event, data) => {
textBox_result.value = `test(${data.a}, ${data.b}) = ${data.result}`;
});
ipcRenderer.on('error', (event, data) => {
alert(`错误: ${data.message}`);
});
五、其他问题
在安装过程中遇到了各种各样的问题，这里记录一下：
- 安装ffi-napi报错。npm install ffi-napi
gyp ERR! find VS gyp ERR! find VS msvs_version not set from command line or npm config gyp ERR! find VS running in VS Command Prompt, installation path is: gyp ERR! find VS “C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\VC\Tools\MSVC” gyp ERR! find VS - will only use this version gyp ERR! find VS could not use PowerShell to find Visual Studio 2017 or newer gyp ERR! find VS looking for Visual Studio 2015 gyp ERR! find VS - not found gyp ERR! find VS not looking for VS2013 as it is only supported up to Node.js 8 gyp ERR! find VS gyp ERR! find VS ************** gyp ERR! find VS You need to install the latest version of Visual Studio including the “Desktop development with C++” workload. gyp ERR! find VS For more information consult the documentation at: gyp ERR! find VS https://github.com/nodejs/node-gyp#on-windows gyp ERR! find VS ************** gyp ERR! find VS gyp ERR! configure error gyp ERR! stack Error: Could not find any Visual Studio installation to use gyp ERR! stack at VisualStudioFinder.fail (D:\soft\nodejs\node_modules\npm\node_modules\node-gyp\lib\find-visualstudio.js:121:47) gyp ERR! stack at D:\soft\nodejs\node_modules\npm\node_modules\node-gyp\lib\find-visualstudio.js:74:16 gyp ERR! stack at VisualStudioFinder.findVisualStudio2013 (D:\soft\nodejs\node_modules\npm\node_modules\node-gyp\lib\find-visualstudio.js:351:14) gyp ERR! stack at D:\soft\nodejs\node_modules\npm\node_modules\node-gyp\lib\find-visualstudio.js:70:14 gyp ERR! stack at D:\soft\nodejs\node_modules\npm\node_modules\node-gyp\lib\find-visualstudio.js:372:16 gyp ERR! stack at D:\soft\nodejs\node_modules\npm\node_modules\node-gyp\lib\util.js:54:7 gyp ERR! stack at D:\soft\nodejs\node_modules\npm\node_modules\node-gyp\lib\util.js:33:16 gyp ERR! stack at ChildProcess.exithandler (child_process.js:390:5) gyp ERR! stack at ChildProcess.emit (events.js:400:28) gyp ERR! stack at maybeClose (internal/child_process.js:1088:16) gyp ERR! System Windows_NT 10.0.19045 gyp ERR! command “D:\soft\nodejs\node.exe” “D:\soft\nodejs\node_modules\npm\node_modules\node-gyp\bin\node-gyp.js” “rebuild” gyp ERR! cwd D:\DemoCode\electronFFI\node_modules\ffi-napi gyp ERR! node -v v14.21.3 gyp ERR! node-gyp -v v5.1.1 gyp ERR! not ok npm WARN enoent ENOENT: no such file or directory, open ‘D:\DemoCode\electronFFI\package.json’ npm WARN electronFFI No description npm WARN electronFFI No repository field. npm WARN electronFFI No README data npm WARN electronFFI No license field. npm ERR! code ELIFECYCLE npm ERR! errno 1 npm ERR! ffi-napi@4.0.3 install: node-gyp-build npm ERR! Exit status 1 npm ERR! npm ERR! Failed at the ffi-napi@4.0.3 install script. npm ERR! This is probably not a problem with npm. There is likely additional logging output above. npm ERR! A complete log of this run can be found in: npm ERR! C:\Users\weidongcao\AppData\Roaming\npm-cache_logs\2025-02-11T07_45_19_949Z-debug.log
这里是说node-gyp找不到vs build tools,先确认你是否安装了vs build tools，如果已经安装了，网上搜索会让你配置各种环境变量，都没什么用，其实就是当前node-gyp版本和vs版本不匹配
- 编译x86报错：‘“call”’ 不是内部或外部命令，也不是可运行的程序或批处理文件。
这个感觉是32位下的一个bug，目前没有找到解决方案
如果安装失败，管理员运行试一下
实在不行就官网拉ffi-napi源码，自己编译
源码地址：https://github.com/node-ffi-napi/node-ffi-napi
在ffi-napi目录下直接编译
node-gyp clean
node-gyp configure --msvs_version=2022
node-gyp build
提示安装addon
npm install node-addon-api