基于electron-vite实现网页与PC客户端的双模式打包方案

在实际开发中，我们经常会遇到这样的需求：一个应用既需要作为网页应用在线运行，又需要打包成PC客户端支持离线使用。这种双模式打包的需求在electron-vite项目中可以通过合理的配置来实现。

需求背景分析

许多项目最初都是作为纯网页应用开发的，随着业务发展才产生了打包为PC客户端的需求。传统的vue-cli-plugin-electron-builder插件就很好地解决了这个问题，它允许开发者在同一个项目中既可以通过npm run serve运行网页版本，又可以通过npm run electron:serve运行electron版本。

electron-vite作为新一代的electron构建工具，同样可以实现这种双模式打包的功能，而且配置更加灵活高效。

实现方案详解

核心思路

实现双模式打包的关键在于：

1. 保持原有vite项目的结构不变
2. 通过环境变量区分打包模式
3. 为不同模式配置不同的入口和构建参数

具体配置方法

在electron-vite项目中，可以通过自定义配置来实现这一需求。主要需要关注以下几点：

1. 环境变量配置：使用.env文件定义不同的环境变量，区分网页模式和electron模式

2. 多入口配置：为网页模式和electron模式配置不同的入口文件

3. 构建参数调整：根据当前模式调整构建参数，如publicPath、资源加载方式等

通信方案设计

在双模式应用中，通信方案也需要特别设计：

• 网页模式：直接访问网络API与服务器通信
• PC客户端模式：通过本地网络API与内置的Node.js服务通信

这种设计可以通过环境变量来动态切换API端点，实现一套代码适应两种运行环境。

实践建议

对于从纯网页应用过渡到electron应用的项目，建议采用以下步骤：

1. 首先确保原有网页应用功能完整
2. 逐步引入electron相关依赖和配置
3. 通过环境变量控制功能开关
4. 最后实现完整的双模式打包

总结

electron-vite提供了灵活的配置选项，使得开发者可以在不破坏原有vite项目结构的前提下，轻松实现网页和PC客户端的双模式打包。通过合理利用环境变量和多入口配置，可以大大简化这类项目的开发和维护工作。

对于有类似需求的开发者，建议深入研究electron-vite的自定义配置功能，根据项目实际情况设计最适合的打包方案。