在寫這篇文章的時候,檢視了下electron最新穩定版本由幾天前24.4.0升級到了25了,不得不說electron團隊迭代速度之快!
前幾天有分享一篇electron24整合vite4全家桶技術構建桌面端vue3應用範例程式。
https://www.cnblogs.com/xiaoyan2017/p/17436076.html
這次繼續接著上次專案,主要介紹electron25結合vue3技術實現建立多開視窗及視窗間主/渲染程序通訊知識。
隨著electron快速更新,結合vite的高效構建執行速度,現在新開一個獨立視窗,開啟速度極快。
新建一個windows/index.js檔案。
/** * 封裝多視窗管理器 * @author YXY */ const { app, BrowserWindow, ipcMain } = require('electron') const { join } = require('path') process.env.ROOT = join(__dirname, '../../') const isDevelopment = process.env.NODE_ENV == 'development' // const winURL = isDevelopment ? 'http://localhost:3000/' : join(__dirname, 'dist/index.html') const winURL = isDevelopment ? process.env.VITE_DEV_SERVER_URL : join(process.env.ROOT, 'dist/index.html') // 設定引數 const defaultConfig = { id: null, // 視窗唯一id background: '#fff', // 背景色 route: '', // 路由地址url title: '', // 標題 data: null, // 傳入資料引數 width: '', // 視窗寬度 height: '', // 視窗高度 minWidth: '', // 視窗最小寬度 minHeight: '', // 視窗最小高度 x: '', // 視窗相對於螢幕左側座標 y: '', // 視窗相對於螢幕頂端座標 resize: true, // 是否支援縮放 maximize: false, // 最大化視窗 isMultiWin: false, // 是否支援多開視窗 isMainWin: false, // 是否主視窗 parent: '', // 父視窗(需傳入父視窗id) modal: false, // 模態視窗(模態視窗是浮於父視窗上,禁用父視窗) alwaysOnTop: false // 置頂視窗 } class MultiWindows { constructor() { // 主視窗 this.mainWin = null // 視窗組 this.winLs = {} // ... } winOpts() { return { // 視窗圖示 icon: join(process.env.ROOT, 'resource/shortcut.ico'), backgroundColor: '#fff', autoHideMenuBar: true, titleBarStyle: 'hidden', width: 1000, height: 640, resizable: true, minimizable: true, maximizable: true, frame: false, show: false, webPreferences: { contextIsolation: true, // 啟用上下文隔離(為了安全性)(預設true) // nodeIntegration: false, // 啟用Node整合(預設false) preload: join(process.env.ROOT, 'resource/preload.js'), // devTools: true, // webSecurity: false } } } // 建立新視窗 createWin(options) { const args = Object.assign({}, defaultConfig, options) console.log(args) // 判斷視窗是否存在 for(let i in this.winLs) { if(this.getWin(i) && this.winLs[i].route === args.route && !this.winLs[i].isMultiWin) { this.getWin(i).focus() return } } let opt = this.winOpts() if(args.parent) { opt.parent = this.getWin(args.parent) } if(typeof args.modal === 'boolean') opt.modal = args.modal if(typeof args.resize === 'boolean') opt.resizable = args.resize if(typeof args.alwaysOnTop === 'boolean') opt.alwaysOnTop = args.alwaysOnTop if(args.background) opt.backgroundColor = args.background if(args.width) opt.width = args.width if(args.height) opt.height = args.height if(args.minWidth) opt.minWidth = args.minWidth if(args.minHeight) opt.minHeight = args.minHeight if(args.x) opt.x = args.x if(args.y) opt.y = args.y console.log(opt) // 建立視窗物件 let win = new BrowserWindow(opt) // 是否最大化 if(args.maximize && args.resize) { win.maximize() } this.winLs[win.id] = { route: args.route, isMultiWin: args.isMultiWin } args.id = win.id // 載入頁面 let $url if(!args.route) { if(process.env.VITE_DEV_SERVER_URL) { // 開啟開發者偵錯工具 // win.webContents.openDevTools() $url = process.env.VITE_DEV_SERVER_URL }else { $url = winURL } }else { $url = `${winURL}#${args.route}` } win.loadURL($url) /*if(process.env.VITE_DEV_SERVER_URL) { win.loadURL($url) }else { win.loadFile($url) }*/ win.webContents.openDevTools() win.once('ready-to-show', () => { win.show() }) win.on('close', () => win.setOpacity(0)) // 初始化渲染程序 win.webContents.on('did-finish-load', () => { // win.webContents.send('win-loaded', '載入完成~!') win.webContents.send('win-loaded', args) }) } // 獲取視窗 getWin(id) { return BrowserWindow.fromId(Number(id)) } // 獲取全部視窗 getAllWin() { return BrowserWindow.getAllWindows() } // 關閉全部視窗 closeAllWin() { try { for(let i in this.winLs) { if(this.getWin(i)) { this.getWin(i).close() }else { app.quit() } } } catch (error) { console.log(error) } } // 開啟主程序監聽 ipcMainListen() { // 設定標題 ipcMain.on('set-title', (e, data) => { const webContents = e.sender const wins = BrowserWindow.fromWebContents(webContents) wins.setTitle(data) // const wins = BrowserWindow.getFocusedWindow() // wins.setTitle('啦啦啦') }) // 是否最大化(方法一) /*ipcMain.on('isMaximized', e => { const win = BrowserWindow.getFocusedWindow() e.sender.send('mainReplay', win.isMaximized()) })*/ // 是否最大化(方法二) ipcMain.handle('isMaximized', (e) => { const win = BrowserWindow.getFocusedWindow() return win.isMaximized() }) ipcMain.on('min', e => { const win = BrowserWindow.getFocusedWindow() win.minimize() }) ipcMain.handle('max2min', e => { const win = BrowserWindow.getFocusedWindow() if(win.isMaximized()) { win.unmaximize() return false }else { win.maximize() return true } }) ipcMain.on('close', (e, data) => { // const wins = BrowserWindow.getFocusedWindow() // wins.close() this.closeAllWin() }) // ... } } module.exports = MultiWindows
在主程序入口background.js檔案引入封裝視窗。
const { app, BrowserWindow, ipcMain } = require('electron') const { join } = require('path') const MultiWindows = require('./src/windows') // 遮蔽安全警告 // ectron Security Warning (Insecure Content-Security-Policy) process.env['ELECTRON_DISABLE_SECURITY_WARNINGS'] = 'true' const createWindow = () => { let window = new MultiWindows() window.createWin({isMainWin: true}) window.ipcMainListen() } app.whenReady().then(() => { createWindow() app.on('activate', () => { if (BrowserWindow.getAllWindows().length === 0) createWindow() }) }) app.on('window-all-closed', () => { if (process.platform !== 'darwin') app.quit() })
在主程序中做一個ipcMain監聽,用來建立獨立視窗。
ipcMain.on('win-create', (event, args) => this.createWin(args))
新建windows/action.js檔案,處理渲染器程序到主程序的非同步通訊,可以傳送同步或非同步的訊息到主程序,也可以接收主程序傳送的訊息。
/** * 建立新視窗 * @param {object} args | {width: 640, height: 480, route: '/home'} */ export function createWin(args) { window.electronAPI.send('win-create', args) } /** * 設定視窗 * @param {string} type | 'show'/'hide'/'close'/'min'/'max'/'max2min'/'restore'/'reload' * @param {number} id */ export function setWin(type, id) { window.electronAPI.send('win-' + type, id) } /** * 建立登入視窗 */ export function loginWin() { createWin({ isMainWin: true, title: '登入', route: '/login', width: 550, height: 320, resize: false, alwaysOnTop: true, }) }
在vue頁面中呼叫上面封裝的方法。
<template> <div class="home"> ... <Button type="success" @click="openWin">開啟Manage視窗(設定parent)</Button> <Button type="success" @click="openWin1">開啟Me視窗(設定resizable/isMultiWin)</Button> <Button type="success" @click="openWin2">開啟User視窗</Button> </div> </template> <script> import { winCfg, createWin } from '@/windows/action' export default { name: 'Home', setup() { const openWin = () => { MessageBox.confirm('提示', '確定開啟Manage頁面嗎? 【設定parent屬性】', { callback: action => { if(action == 'confirm') { createWin({ title: 'Manage.vue', route: '/manage', width: 600, height: 400, background: '#09f', parent: winCfg.window.id, // modal: true }) }else if(action == 'cancel') { Message.info('您已取消!') } } }) } const openWin1 = () => { // 左上角 // let posX = 0 // let posY = 0 // 右下角 let posX = window.screen.availWidth - 850 let posY = window.screen.availHeight - 600 MessageBox.confirm('提示', '確定開啟Me頁面嗎?', { callback: action => { if(action == 'confirm') { createWin({ title: 'Me.vue', route: '/me?name=Andy', width: 850, height: 600, x: posX, y: posY, background: 'yellow', resize: false, isMultiWin: true, maximize: true }) }else if(action == 'cancel') { Message.info('您已取消!') } } }) } const openWin2 = () => { MessageBox.confirm('提示', '確定開啟User頁面嗎?', { callback: action => { if(action == 'confirm') { createWin({ title: 'User.vue', route: '/user', width: 700, height: 550, minWidth: 300, minHeight: 300, data: { name: 'Andy', age: 20 }, background: 'green', isMultiWin: true }) }else if(action == 'cancel') { Message.info('您已取消!') } } }) } // ... return { openWin, openWin1, openWin2, // ... } } } </script>
設定 frame: false 建立無邊框視窗。
設定 -webkit-app-region: drag 來實現自定義拖拽區域。設定後的按鈕操作無法響應其它事件,只需設定 -webkit-app-region: no-drag 即可實現響應事件。
electron+vite提供的一些環境變數。
process.env.NODE_ENV
process.env.VITE_DEV_SERVER_URL
在開發環境,載入vite url,生產環境,則載入vite build出來的html。
Ok,綜上就是electron25+vite4結合構建跨端應用的一些分享,希望對大家有所幫助哈~~