日常开发 Electron 应用的时候,习惯使用脚手架:electron-react-boilerplate 进行开发,今天开发遇到一个问题:
bash
A JavaScript error occurred in the main process
Uncaught Exception:
Error: No native build was found for platform=linux arch=x64 runtime=electron abi=116 uv=1 libc=glibc node=18.16.1 electron=26.6.3 webpack=true
loaded from: /tmp/.mount_sf-offjFWZOf/resources/app.asar/dist
at g.resolve.g.path (/tmp/.mount_sf-offjFWZOf/resources/app.asar/dist/main/main.js:14:433548)
at g (/tmp/.mount_sf-offjFWZOf/resources/app.asar/dist/main/main.js:14:431619)
at 6237 (/tmp/.mount_sf-offjFWZOf/resources/app.asar/dist/main/main.js:2:14858)
at n (/tmp/.mount_sf-offjFWZOf/resources/app.asar/dist/main/main.js:14:636823)
at 6269 (/tmp/.mount_sf-offjFWZOf/resources/app.asar/dist/main/main.js:2:6100)
at n (/tmp/.mount_sf-offjFWZOf/resources/app.asar/dist/main/main.js:14:636823)
at 176 (/tmp/.mount_sf-offjFWZOf/resources/app.asar/dist/main/main.js:2:9685)
at n (/tmp/.mount_sf-offjFWZOf/resources/app.asar/dist/main/main.js:14:636823)
at 9076 (/tmp/.mount_sf-offjFWZOf/resources/app.asar/dist/main/main.js:14:535247)
at n (/tmp/.mount_sf-offjFWZOf/resources/app.asar/dist/main/main.js:14:636823)
Maximum number of clients reached[84362:0530/141312.211021:ERROR:ozone_platform_x11.cc(241)] Missing X server or $DISPLAY
[84362:0530/141312.211053:ERROR:env.cc(255)] The platform failed to initialize. Exiting.
问题背景
出现这个问题没有任何头绪,在网上也查不到任何信息,但是问题步骤是很容易复现的:
- 开发环境没问题,正常运行
- 项目打包没问题,正常打包
- 打包之后启动应用程序出现上方的报错
并且这个问题也很容易定位,因为回滚到上一个 Commit 版本问题就消失了,因此可以确定是本次引入的,而本次开发过程中代码都是普通的业务代码,并且开发环境是没问题正常启动的,因此唯一确定的变量就是引入了一个新的依赖包 ------ serialport。
解决方案
根据上面的描述,解决方案大致也就清楚了,肯定是这个安装包的问题,但是我的需求就是要使用这个安装包,因此肯定不是包的问题,那么经过查找,发现了这个文档:Electron React Boilerplate Add Dependencies,根据文档描述大致确定了问题:对于 Electron 应用,尤其是需要访问底层系统资源(如串口设备)的库,应该确保它们安装在用于运行时的 package.json 文件中,也就是 ./app/package.json,而不是根目录的 package.json 文件中。
所以,我们只需要把对应的调用系统底层的相关依赖包,安装在 /release/app/package.json
里面就可以了,经过测试确实是这个问题,又浪费我大半天的时间,不过好在问题总算解决了~