Electron自动更新失效报错Error: Object has been destroyed的问题解决
作者:翔子丶
Electron 自动更新失败
在 Electron 应用某次更新,出现了如下循环更新的问题:
此时,查询日志,发现报错如下 Error: Object has been destroyed
:
问题原因
首先,通过查阅资料得知:在 Electron 中,当一个窗口被销毁后,与该窗口相关联的 JavaScript 对象也会被销毁,如果再次尝试访问已被销毁的窗口对象时,就会发出上图所示的错误。
通过日志可以很好的找到问题发生的地方(幸好我们主进程中关键点都添加了明显的日志信息,方便问题查找),很明显是在 autoUpdater.on('update-available'
检测到自动更新后的报错,那就着重排查下这里。
autoUpdater.on('update-available', () => { mainLogger.info('自动更新 有新版本') disableStopMainWindowClose() win.show() mainWindow.destroy() })
通过日志可以分析应该是在 disableStopMainWindowClose
方法中的产生的问题:
export function disableStopMainWindowClose() { mainWindow.off('close', onMainClose) systemStatus.off() } function onMainClose(e: Electron.Event) { if (isQuit) return if (mainWindow.isFullScreen()) { ... }
如何解决
为了避免这个错误,需要在窗口对象被销毁时取消订阅所有与该窗口相关的事件,并在需要访问窗口对象时先检查窗口对象是否已经被销毁。
所以需要在调用窗口方法前,先判断窗口是否已被销毁
function onMainClose(e: Electron.Event) { if (isQuit) return if (!mainWindow?.isDestroyed()) return ...
重新打包,上传成功后,再次出发自动更新,即可正常了。顺便说一下我们 Electron 应用的更新流程。
打包
首先是打包,打包时需要更新 package.json 中的版本和说明
{ "version": "2.2.7", "versionNotes": "发现新版本 v2.2.7!\n\n1. 修复客服已知问题" }
修改完后,Mac 和 Windows 各自打包,并上传到服务器。
自动更新流程
关于 Electron 应用的自动更新,官方提供了更新应用程序处理自动更新过程。
因为我们使用的 electron-builder 打包应用,所以使用的是它内置的更新程序Auto Update。
相比 Electron 中自带的更新,它有以下优势:
- 不需要搭建专用的发布服务器,可上传到任意服务器;
- 代码签名验证可以在 macOS 和 Windows 上进行;
- 支持下载进度提示;
- 代码简单,工作量少。
实现过程
安装依赖
yarn add electron-updater
主窗口调用
当主窗口被激活显示时,通过 checkLatestVersion
方法检查是否有版本更新
mainWindow.on('show', checkLatestVersion)
检测是否有更新
checkLatestVersion
方法定义在主进程的 update.ts 文件中
// update.ts ... export const checkLatestVersion = () => { getLatestVersionInfo().then((version: any) => { if (!version) return mainLogger.info('检查最新版本', version) dialog .showMessageBox(mainWindow, { defaultId: 0, cancelId: 3, message: version.notes, buttons: version.isCurrVersionAvailable ? ['更新', '取消'] : ['更新'], }) .then(({ response }) => response === 0) .then((isUpdate) => { if (isUpdate) IS_MAC ? checkMacUpdate() : checkWinUpdate() }) .finally(() => (isDialogOpen = false)) }) }
getLatestVersionInfo
方法用于检测更新,主要通过比对服务器的安装包版本是否大于本地版本,在本地打完包后,会将本地的包上传到服务器上,同时会有一份 RELEASE.json
文件,就是通过比对 RELEASE.json
文件中的 currentRelease
字段。
{ "currentRelease": "2.2.7", "notes": "发现新版本 v2.2.7!\n\n1. 修复客服已知问题。" }
当大于本地版本即需要更新时,显示更新窗口(包含更新版本、更新说明等),当用户点击更新
后,调用 Mac 或 Windows 的更新方法。
检查更新前奏——创建更新窗口
const checkMacUpdate = () => { const win = createAutoUpdateWindow() ... }
首先通过 createAutoUpdateWindow
创建更新窗口
const createAutoUpdateWindow = () => { const win = new BrowserWindow({ width: 560, height: 120, titleBarStyle: 'hidden', webPreferences: { preload: path.join(__dirname, 'preload.js'), }, }) win.loadURL(getLocalUrl('/auto-update')) return win }
上面代码中创建了一个浏览器窗口,并加载 /auto-update
路由:
<template> <section style="padding: 42px 32px"> <a-progress :show-info="false" :stroke-color="{ '0%': '#108ee9', '100%': '#87d068' }" :percent="percent" status="active" /> <center style="padding-top: 16px">正在更新中,更新完成后会自动重启,请耐心等待。</center> </section> </template> <script setup> import { onMounted, ref } from 'vue' const percent = ref(0) const timer = setInterval(() => { percent.value += 2 if (percent.value >= 95) clearInterval(timer) }, 300) </script>
页面显示一个假的进度条即可,新版本下载完成后会自动关闭并安装。
autoUpdater 自动更新
const checkMacUpdate = () => { const win = createAutoUpdateWindow() // 监听升级失败事件 autoUpdater.on('error', (message) => { mainLogger.error('自动更新', message) }) // 监听发现可用更新事件 autoUpdater.on('update-available', () => { mainLogger.info('自动更新 有新版本') isUpdating = true disableStopMainWindowClose() win.show() mainWindow.destroy() }) // 监听没有可用更新事件 autoUpdater.on('update-not-available', () => { mainLogger.info('自动更新 没有新版本') win.close() }) // 监听下载完成事件 autoUpdater.on('update-downloaded', () => { mainLogger.info('自动更新 新版本下载完成') // 重新启动并安装更新包 只有update-downloaded事件中可调用 autoUpdater.quitAndInstall() }) mainLogger.info('自动更新 开始检查', AUTO_UPDATE_JSON_URL) // 设置安装包所在服务器地址 autoUpdater.setFeedURL({ url: AUTO_UPDATE_JSON_URL, serverType: 'json' }) // 请求服务器是否有更新。 在使用此API之前,您必须调用setFeedURL autoUpdater.checkForUpdates() }
通过 autoUpdater Events 绑定相应的事件,通过setFeedURL
方法设置安装包的地址,最后通过checkForUpdates
检查是否有更新,触发绑定的各种事件。
当检测到有新版本时,显示更新窗口,假进度条冒充下载中,自动下载安装包
总结
本文主要讲解如何解决 Error: Object has been destroyed
这个 Electron 中最常见的问题,以及 Electron 自动更新的流程。通过解决这个问题,意识到需要在 Electron 主进程中,要为代码的关键点添加一些重要的日志信息,这样在遇到问题时,能让我们更加方便的定位问题。
以上就是Electron自动更新失效报错Error: Object has been destroyed的问题解决的详细内容,更多关于Electron自动更新失效的资料请关注脚本之家其它相关文章!