▒ 目录 ▒
-
- [🛫 导读](#🛫 导读)
- [1️⃣ FFI](#1️⃣ FFI)
- [2️⃣ 【废弃】node-ffi](#2️⃣ 【废弃】node-ffi)
- [3️⃣ node-ffi-napi](#3️⃣ node-ffi-napi)
- [4️⃣ node-win32-api](#4️⃣ node-win32-api)
- [5️⃣ hmc-win32](#5️⃣ hmc-win32)
- [🛬 文章小结](#🛬 文章小结)
- [📖 参考资料](#📖 参考资料)
🛫 导读
需求
C++开发中经常遇到使用脚本语言，如lua、python等，提供更为灵活的更新操作。而脚本调用dll，又得导出接口。为了不更新二进制代码，往往通过ffi的形式，为脚本语言增加调用dll的功能。
electron同样支持js调用原生模块的功能（参考 Node 原生模块 https://www.electronjs.org/zh/docs/latest/tutorial/using-native-node-modules）。然而为了更加丰富electron的功能，我们是否可以提供类似lua等脚本语言调用原生dll的接口能力呢？这就是今天我们要讲的
FFI。
开发环境
| 版本号 | 描述 | |
|---|---|---|
| 文章日期 | 2023-12-10 | |
| 操作系统 | Win11 - 21H2 - 22000.1335 | |
1️⃣ FFI
概念
Foreign Function Interface（外语函数接口，FFI）是指一种在不同编程语言之间调用函数的方式。FFI 可以使语言 A 的程序能调用由语言 B 编写的函数，从而实现两种语言之间的交互。FFI 可以使用用户态库或者内核态库实现，并且可以在不同的操作系统上使用。FFI 的一般实现方式是通过在目标语言（如 C）中编写一个封装函数，然后在调用方语言中使用该封装函数来调用目标函数。
优点
使用 FFI 有以下几个优势：
- 跨语言调用：FFI 使得在不同编程语言之间进行函数调用成为可能。
- 使用外部库：FFI 使得可以调用外部库中的函数，而不需要将其代码集成到程序中。
- 提高效率：FFI 使得可以调用由其他编程语言编写的高效函数，提高程序的效率。
- 利用已有的库资源：FFI 使得可以利用已有的由其他语言编写的库资源，避免重复开发。
总之，FFI 是一种很灵活的技术，可以帮助程序员在不同编程语言之间进行函数调用，提高程序的效率和扩展性。
注意事项
尽管FFI有大量优势，我们依然需要注意：
- 如调用方和被调用方的类型
- 参数和返回值的转换
- 调用方与被调用方的内存管理等问题。
2️⃣ 【废弃】node-ffi
网上搜索node ffi，会出现大量的关于库
node-ffi的文章，其git地址为https://github.com/node-ffi/node-ffi。从git上可以看到，该库已经从19年不再更新了，而node和electron的版本日新月异，经过测试，该库在新版本的node中已经无法正常运行，可以完全放弃了。
3️⃣ node-ffi-napi
通过github，小编发现了替代库node-ffi-napi： https://github.com/node-ffi-napi/node-ffi-napi，该库在node16及node18下测试均正常。
安装（windows系统下）
步骤一：确保您已安装所有
必要的构建适合您平台的工具node-gyp
步骤二：然后调用下面语句
npm install ffi-napi注意这里，会发现不是
node-ffi-napi，而是ffi-napi。
示例：MessageBoxA、NtSuspendProcess
node-ffi-napi提供了对象
Library，其构造函数生成dll对应的接口集合。参数一为dll名称
参数二为对象，表示所有要用到的api接口。
下面分别通过MessageBoxA演示UI能力，以及NtSuspendProcess挂起某进程。
js
import ffi from 'ffi-napi'
function 测试ffi_napi() {
var current = ffi.Library('user32.dll', {
'MessageBoxA': [ 'int', [ 'int', 'int' , 'int' , 'int' ] ]
});
current.MessageBoxA(0,0,0,0); // 1234
// NTSTATUS NTAPI NtSuspendProcess(HANDLE ProcessHandle)
var ntdll = ffi.Library('ntdll.dll', {
'NtSuspendProcess': [ 'int', [ 'int' ] ]
});
ntdll.NtSuspendProcess(-1);
}
测试ffi_napi()4️⃣ node-win32-api
node-win32-api是基于node-ffi-napi的一个
纯js库，封装了部分接口和数据结构，方便用户调用。
安装
npm install win32-api
示例：查找窗口并设置窗口标题
js
// **Find calc's hWnd, need running a calculator program manually at first**
/**
* Exposed modules:
* Comctl32: Comctl32 from lib/comctl32/api
* Kernel32: kernel32 from lib/kernel32/api
* User32: user32 from lib/user32/api
*/
import { Kernel32, User32 } from 'win32-api/promise'
import ref from 'ref-napi'
const knl32 = Kernel32.load()
const user32 = User32.load()
// const user32 = load(['FindWindowExW']) // load only one api defined in lib/{dll}/api from user32.dll
const title = 'Calculator\0' // null-terminated string
// const title = '计算器\0' // null-terminated string 字符串必须以\0即null结尾!
const lpszWindow = Buffer.from(title, 'ucs2')
const hWnd = await user32.FindWindowExW(0, 0, null, lpszWindow)
assert((typeof hWnd === 'string' && hWnd.length > 0) || hWnd > 0)
console.log('buf: ', hWnd)
// Change title of the Calculator
const res = await user32.SetWindowTextW(hWnd, Buffer.from('Node-Calculator\0', 'ucs2'))
if ( ! res) {
console.log('SetWindowTextW failed')
}
else {
console.log('window title changed')
}5️⃣ hmc-win32
hmc-win32 是中国香港的小哥写的库，实现了各种常用的函数的封装，貌似对标自动化库autoitX。
该库通过C++实现的，功能十分丰富，作者自己说自测完善，可放心使用。
github地址：https://github.com/kihlh/hmc-win32
安装
npm i hmc-win32
示例
枚举进程列表：
js
import hmc from 'hmc-win32';
function 测试hmc() {
// console.log(hmc)
let procList = hmc.Process.getDetailsList()
console.log(procList)
}
测试hmc()🛬 文章小结
上述是对electron使用ffi扩展的各种尝试，如若不满足需求。
可通过
Node 原生模块开发自己需要的功能。其实ffi也是原生模块的一个应用而已。
📖 参考资料
- Node 原生模块 https://www.electronjs.org/zh/docs/latest/tutorial/using-native-node-modules
- 调用 c++原生 dll https://zh-sky.gitee.io/electron-vue-template-doc/Overview/advanced/ffi.html
- node-win32-api https://github.com/waitingsong/node-win32-api
- hmc-win32 https://github.com/kihlh/hmc-win32
ps： 文章中内容仅用于技术交流，请勿用于违规违法行为。