vue项目打包成桌面端exe应用(0-1保姆级教程)
主要 使用 Electron 和 Inno Setup 将 vue项目打包为 exe 可安装程序
1、Electron 下载安装方式
git clone https://github.com/electron/electron-quick-start
cd electron-quick-start
npm install
npm start
运行成功
2、 Inno Setup 下载安装方式 无脑下一步即可
下面开始正式的操作步骤
一、修改需要打包为 exe 项目的 vite.config.js 或 vue.config.js 配置文件
路径必须修改为 "./" ,不然可能造成页面空白或加载失败的情况
// vite.config.js
export default defineConfig({
base: "./",
})
或
// vue.config.js
module.exports = {
publicPath: "./",
}
如果你的项目使用了VueRouter,那么切记:VueRouter一定不能是History模式
/* 原代码 */
const router = new VueRouter({
mode: 'history',
base: process.env.BASE_URL,
routes
})
/* 修改后 */
const router = new VueRouter({
mode: 'hash',
routes: routes
})
二、 在我们前面 clone 下来的的 官方demo (electron-quick-start)中安装打包需要的依赖。
npm install electron-packager --save-dev
三、删除 electron-quick-start 根目录下的 index.html 文件
四、在 electron-quick-start 项目中 找到 main.js 文件修改其配置根据
按我设置这个即可,其他更多配置可以看官网。
完整代码:
// Modules to control application life and create native browser window
const { app, BrowserWindow } = require('electron');
const path = require('node:path');
function createWindow() {
// Create the browser window.
const mainWindow = new BrowserWindow({
resizable: true, //是否支持调整窗口大小
icon: './dist/favicon.ico', // 左上角图标
width: 800,
height: 600,
webPreferences: {
preload: path.join(__dirname, 'preload.js'),
},
});
// mainWindow.setMenu(null); // 隐藏顶部菜单栏
// and load the index.html of the app.
mainWindow.loadFile('./dist/index.html');
// Open the DevTools.
mainWindow.webContents.openDevTools();
// // 默认窗口最大化
// mainWindow.maximize();
// mainWindow.show();
}
// This method will be called when Electron has finished
// initialization and is ready to create browser windows.
// Some APIs can only be used after this event occurs.
app.whenReady().then(() => {
createWindow();
app.on('activate', function () {
// On macOS it's common to re-create a window in the app when the
// dock icon is clicked and there are no other windows open.
if (BrowserWindow.getAllWindows().length === 0) createWindow();
});
});
// Quit when all windows are closed, except on macOS. There, it's common
// for applications and their menu bar to stay active until the user quits
// explicitly with Cmd + Q.
app.on('window-all-closed', function () {
if (process.platform !== 'darwin') app.quit();
});
// In this file you can include the rest of your app's specific main process
// code. You can also put them in separate files and require them here.
五、在 electron-quick-start 项目 package.json 配置文件中,scripts 下添加 packager 指令
设置了icon图标,也可以不设置
"scripts": {
"start": "electron .",
"packager": "electron-packager ./ HumeErp --platform=win32 --icon=./dist/favicon.ico --arch=x64 --overwrite"
},
六、打包原 Vue 项目,将打包后生成的 dist 文件夹放在 electron-quick-start 项目中与node_modules 平级即可
在打包之前,我们需要修改一下基地址,不然后面有网络请求的接口是访问不了的
const service = axios.create({
baseURL: 'https://xxx.xxx.net' + apiBaseUrl,
timeout: 15000 // 请求超时时间
})
或者灵活一点 ,新增一个命令,通过使用不同的基地址来区分
// 创建axios实例
const service = axios.create({
baseURL: process.env.VUE_APP_BASE_API,
timeout: 600000,
});
七、输入打包命令 npm run packager 执行成功后,electron-quick-start 项目中会出现一个 App-win32-x64 的文件夹,该文件夹内 App.exe 即为项目的启动文件
npm run packager
八、exe 打包完成了, 接下来使用 Inno Setup 工具生成安装程序包
1.新建文件 ctrl + n
2.填写基本信息,最好都填,再下一步
- 下一步(Next):填写应用文件夹信息
- 下一步(Next):选择生成安装程序的文件
5.设置文件名
6.下一步即可
等待打包完成,完成了的话,最终的安装包文件就在output中,至此所有的打包工作都大功告成了✌️✌️。