《Electron 跨平台应用开发：蓝牙模块实战（一套代码Windows/macOS/Linux 适配）》

原创

已于 2025-12-08 00:02:54 修改 · 463 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#electron #javascript #前端

于 2025-12-07 23:52:50 首次发布

接上篇《Electron + Vite 集成 Node 蓝牙开发实战》

因为上篇只介绍了noble-winrt只支持win10/win11,不支持其他系统，如linux（银河麒麟），macOS。那么我们要兼容多系统怎么办呢，办法有的朋友，我在我的项目中已经实战过了，同样抽取蓝牙部分拿出来做一个demo讲解，手把手喂饭给没有做过或正在为node蓝牙多系统适配焦头烂额的朋友，看的有用的，帮我github点个星星！！！！

https://github.com/Jadeite2/electron-vite--abandonware-noble

一、环境要求

node.js: 20.x.x
Python 3.11.9
node-gyp v9.4.1
VisualStudioSetup（选择使用c++的桌面开发）
windows安装依赖要注意，因为这次要用的node蓝牙属于是c++的开发扩展，所以要安装node-gyp、VisualStudioSetup并选择使用c++的桌面开发安装后，才能完成node_moudel的编译和安装。

本文的node蓝牙api设备发现、连接、服务/特征发现、数据收发流程与上一篇 noble 基本一致，如下。本次我们使用@abandonware/noble来作为蓝牙模块来开发功能。

二、目录结构

使用electron-egg v4官方结构

electorn-egg V4版本官方结构
project
├── package.json npm包配置
├── bulid 打包用的资源和脚本
    ├── icons 软件图标（打包用到）
    ├── extraResources 额外资源目录
├── cmd 脚本/打包 命令配置
    ├── bin.js 开发环境配置    
    ├── builder-xxx.json 打包配置
├── electron 主进程服务
    ├── main.js 入口文件 
    ├── config 配置文件
        ├── config.default.js 默认配置，都会加载
        ├── config.local.js dev环境加载
        ├── config.prod.js 生产环境加载
    ├── controller 控制器
    ├── service 业务层
    ├── preload 预加载
        ├── index.js 入口文件，在程序启动时加载，如托盘、自动升级等功能要提前加载代码
        ├── bridge.js 桥接文件
        ├── lifecycle.js 生命周期函数
    ├── jobs 任务
├── frontend 前端目录（demo是用vue编写的）  
├── go go目录(可选)
├── out 打包后生成的可执行文件
    ├── latest.yml 自动升级文件
    ├── xxx.exe window应用安装包
    ├── xxx.exe.blockmap window应用增量升级包
    ├── xxx.dmg mac应用安装包
    ├── xxx.deb linux应用安装包后缀有多种    
├── logs 日志 
├── public 资源目录
    ├── dist 前端资源会移动到这里，生产环境加载
    ├── electron 主进程代码，生产环境加载
    ├── html 一些模板
    ├── images 一些图片
├── data 内置数据库文件
    ├── sqlite-demo.db 示例sqlite数据库

我们主要关注electron 主进程服务controller 控制器和 service 业务层，frontend 前端目录的view的indx.vue