【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

相关文章

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. 什么是空接

Android Kotlin 高阶函数详解及其在协程中的应用小结

《AndroidKotlin高阶函数详解及其在协程中的应用小结》高阶函数是Kotlin中的一个重要特性,它能够将函数作为一等公民(First-ClassCitizen),使得代码更加简洁、灵活和可... 目录1. 引言2. 什么是高阶函数?3. 高阶函数的基础用法3.1 传递函数作为参数3.2 Lambda

C++中::SHCreateDirectoryEx函数使用方法

《C++中::SHCreateDirectoryEx函数使用方法》::SHCreateDirectoryEx用于创建多级目录,类似于mkdir-p命令,本文主要介绍了C++中::SHCreateDir... 目录1. 函数原型与依赖项2. 基本使用示例示例 1:创建单层目录示例 2:创建多级目录3. 关键注

C++中函数模板与类模板的简单使用及区别介绍

《C++中函数模板与类模板的简单使用及区别介绍》这篇文章介绍了C++中的模板机制,包括函数模板和类模板的概念、语法和实际应用,函数模板通过类型参数实现泛型操作,而类模板允许创建可处理多种数据类型的类,... 目录一、函数模板定义语法真实示例二、类模板三、关键区别四、注意事项 ‌在C++中,模板是实现泛型编程

kotlin的函数forEach示例详解

《kotlin的函数forEach示例详解》在Kotlin中,forEach是一个高阶函数,用于遍历集合中的每个元素并对其执行指定的操作,它的核心特点是简洁、函数式,适用于需要遍历集合且无需返回值的场... 目录一、基本用法1️⃣ 遍历集合2️⃣ 遍历数组3️⃣ 遍历 Map二、与 for 循环的区别三、高

C语言字符函数和字符串函数示例详解

《C语言字符函数和字符串函数示例详解》本文详细介绍了C语言中字符分类函数、字符转换函数及字符串操作函数的使用方法,并通过示例代码展示了如何实现这些功能,通过这些内容,读者可以深入理解并掌握C语言中的字... 目录一、字符分类函数二、字符转换函数三、strlen的使用和模拟实现3.1strlen函数3.2st

如何用java对接微信小程序下单后的发货接口

《如何用java对接微信小程序下单后的发货接口》:本文主要介绍在微信小程序后台实现发货通知的步骤,包括获取Access_token、使用RestTemplate调用发货接口、处理AccessTok... 目录配置参数 调用代码获取Access_token调用发货的接口类注意点总结配置参数 首先需要获取Ac

讯飞webapi语音识别接口调用示例代码(python)

《讯飞webapi语音识别接口调用示例代码(python)》:本文主要介绍如何使用Python3调用讯飞WebAPI语音识别接口,重点解决了在处理语音识别结果时判断是否为最后一帧的问题,通过运行代... 目录前言一、环境二、引入库三、代码实例四、运行结果五、总结前言基于python3 讯飞webAPI语音

MyBatis-Plus中Service接口的lambdaUpdate用法及实例分析

《MyBatis-Plus中Service接口的lambdaUpdate用法及实例分析》本文将详细讲解MyBatis-Plus中的lambdaUpdate用法,并提供丰富的案例来帮助读者更好地理解和应... 目录深入探索MyBATis-Plus中Service接口的lambdaUpdate用法及示例案例背景