【electron】外语函数接口 FFI

2023-12-11 07:52

本文主要是介绍【electron】外语函数接口 FFI,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

▒ 目录 ▒

    • 🛫 导读
      • 需求
      • 开发环境
    • 1️⃣ FFI
      • 概念
      • 优点
      • 注意事项
    • 2️⃣ 【废弃】node-ffi
    • 3️⃣ node-ffi-napi
      • 安装(windows系统下)
      • 示例:MessageBoxA、NtSuspendProcess
    • 4️⃣ node-win32-api
      • 安装
      • 示例:查找窗口并设置窗口标题
    • 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挂起某进程。


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库,封装了部分接口和数据结构,方便用户调用。
github地址:https://github.com/waitingsong/node-win32-api

安装

npm install win32-api

示例:查找窗口并设置窗口标题

// **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.dllconst 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

示例

枚举进程列表:

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: 文章中内容仅用于技术交流,请勿用于违规违法行为。

这篇关于【electron】外语函数接口 FFI的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/479981

相关文章

Python正则表达式语法及re模块中的常用函数详解

《Python正则表达式语法及re模块中的常用函数详解》这篇文章主要给大家介绍了关于Python正则表达式语法及re模块中常用函数的相关资料,正则表达式是一种强大的字符串处理工具,可以用于匹配、切分、... 目录概念、作用和步骤语法re模块中的常用函数总结 概念、作用和步骤概念: 本身也是一个字符串,其中

usb接口驱动异常问题常用解决方案

《usb接口驱动异常问题常用解决方案》当遇到USB接口驱动异常时,可以通过多种方法来解决,其中主要就包括重装USB控制器、禁用USB选择性暂停设置、更新或安装新的主板驱动等... usb接口驱动异常怎么办,USB接口驱动异常是常见问题,通常由驱动损坏、系统更新冲突、硬件故障或电源管理设置导致。以下是常用解决

shell编程之函数与数组的使用详解

《shell编程之函数与数组的使用详解》:本文主要介绍shell编程之函数与数组的使用,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录shell函数函数的用法俩个数求和系统资源监控并报警函数函数变量的作用范围函数的参数递归函数shell数组获取数组的长度读取某下的

MySQL高级查询之JOIN、子查询、窗口函数实际案例

《MySQL高级查询之JOIN、子查询、窗口函数实际案例》:本文主要介绍MySQL高级查询之JOIN、子查询、窗口函数实际案例的相关资料,JOIN用于多表关联查询,子查询用于数据筛选和过滤,窗口函... 目录前言1. JOIN(连接查询)1.1 内连接(INNER JOIN)1.2 左连接(LEFT JOI

MySQL中FIND_IN_SET函数与INSTR函数用法解析

《MySQL中FIND_IN_SET函数与INSTR函数用法解析》:本文主要介绍MySQL中FIND_IN_SET函数与INSTR函数用法解析,本文通过实例代码给大家介绍的非常详细,感兴趣的朋友一... 目录一、功能定义与语法1、FIND_IN_SET函数2、INSTR函数二、本质区别对比三、实际场景案例分

C++ Sort函数使用场景分析

《C++Sort函数使用场景分析》sort函数是algorithm库下的一个函数,sort函数是不稳定的,即大小相同的元素在排序后相对顺序可能发生改变,如果某些场景需要保持相同元素间的相对顺序,可使... 目录C++ Sort函数详解一、sort函数调用的两种方式二、sort函数使用场景三、sort函数排序

C语言函数递归实际应用举例详解

《C语言函数递归实际应用举例详解》程序调用自身的编程技巧称为递归,递归做为一种算法在程序设计语言中广泛应用,:本文主要介绍C语言函数递归实际应用举例的相关资料,文中通过代码介绍的非常详细,需要的朋... 目录前言一、递归的概念与思想二、递归的限制条件 三、递归的实际应用举例(一)求 n 的阶乘(二)顺序打印

C/C++错误信息处理的常见方法及函数

《C/C++错误信息处理的常见方法及函数》C/C++是两种广泛使用的编程语言,特别是在系统编程、嵌入式开发以及高性能计算领域,:本文主要介绍C/C++错误信息处理的常见方法及函数,文中通过代码介绍... 目录前言1. errno 和 perror()示例:2. strerror()示例:3. perror(

Kotlin 作用域函数apply、let、run、with、also使用指南

《Kotlin作用域函数apply、let、run、with、also使用指南》在Kotlin开发中,作用域函数(ScopeFunctions)是一组能让代码更简洁、更函数式的高阶函数,本文将... 目录一、引言:为什么需要作用域函数?二、作用域函China编程数详解1. apply:对象配置的 “流式构建器”最

go中空接口的具体使用

《go中空接口的具体使用》空接口是一种特殊的接口类型,它不包含任何方法,本文主要介绍了go中空接口的具体使用,具有一定的参考价值,感兴趣的可以了解一下... 目录接口-空接口1. 什么是空接口?2. 如何使用空接口?第一,第二,第三,3. 空接口几个要注意的坑坑1:坑2:坑3:接口-空接口1. 什么是空接