返回

electron+react+vite项目部署白屏问题及部分部署记录

前端

前言

Electron + React + Vite 是一个非常流行的前端技术栈,可以用来构建跨平台的桌面应用程序。然而,在部署electron+react+vite项目时,经常会遇到一些问题,例如白屏问题、无法start问题等。本文将详细记录这些问题的解决方案,并提供一些有用的技巧和建议。

electron+react+vite项目部署白屏问题

问题

在部署electron+react+vite项目时,有时会出现白屏问题,即打开应用后只显示一个空白的窗口。

解决方法

  1. 确保electron-builder版本为23.1.2或以上。
  2. 在项目的package.json文件中添加以下依赖:
"cross-env": "^7.0.3"
  1. 在项目的根目录下创建cross-env.js文件,内容如下:
#!/usr/bin/env node
cross-env VITE_DEV_SERVER_URL=http://localhost:3000 electron-builder build
  1. 在项目的package.json文件中添加以下脚本:
"build:electron": "cross-env VITE_DEV_SERVER_URL=http://localhost:3000 electron-builder build",
  1. 运行以下命令构建项目:
npm run build:electron

electron+react+vite项目无法start问题

问题

在运行electron+react+vite项目时,有时会出现无法start问题,即运行项目后没有打开窗口。

解决方法

  1. 确保electron版本为19或以上。
  2. 在项目的package.json文件中添加以下依赖:
"electron-forge": "^6.2.3"
  1. 在项目的根目录下运行以下命令:
electron-forge init
  1. 选择"Custom"选项,然后选择"React"和"Vite"。

  2. 回答以下问题:

  • 项目名称:
  • 项目
  • 项目作者:
  • 项目版本:
  • 项目许可证:
  1. 安装必要的依赖:
npm install
  1. 构建项目:
npm run make
  1. 启动项目:
npm start

技巧和建议

  1. 在开发electron+react+vite项目时,可以使用以下命令启动项目:
npm run dev:electron
  1. 在部署electron+react+vite项目时,可以使用以下命令构建项目:
npm run build:electron
  1. 如果您想将electron+react+vite项目打包成dmg文件,可以使用以下命令:
electron-builder build --mac
  1. 如果您想将electron+react+vite项目打包成exe文件,可以使用以下命令:
electron-builder build --win

结语

本文详细记录了electron+react+vite项目在部署时的常见问题,并提供了详细的解决方案。此外,还提供了electron+react+vite项目的部署步骤,以及一些有用的技巧和建议。希望本文能够帮助您顺利部署electron+react+vite项目。