Repository navigation
v2.0.2
📋 版本概述
v2.0.2 是 v2.0.1 的紧急修复版本,针对桌面端自动更新通知中发布说明显示为空的问题。
🐛 Bug 修复
📥 桌面端更新通知 releaseNotes 为空
问题描述:桌面端检测到新版本后弹出更新通知,但发布说明区域显示「暂无详细更新说明」,用户无法了解更新内容。
根因分析:electron/main.cjs 中 fetchReleaseNotes() 使用 net.fetch(Electron net 模块的 fetch API)向 GitHub Releases API 发起 HTTPS 请求获取发布说明。该 API 对 Electron net.fetch 的支持不稳定,请求静默失败(无报错/无日志),返回空字符串,导致更新弹窗无法渲染 releaseNotes。
修复方案:
- 将
fetchReleaseNotes中的网络请求从net.fetch替换为node:https - 增加完整的错误处理链路:
- HTTP 状态码检查(非 200 时打印错误日志)
- JSON 解析异常捕获
- 请求超时保护(8 秒)
- 网络错误捕获
- 关键节点打印
console.error日志,便于后续通过 DevTools / 日志文件排查
修复前:net.fetch → 静默失败 → 空 releaseNotes
修复后:node:https → 状态码检查/JSON解析/超时保护 → 正常显示发布说明
📊 变更统计
v2.0.1 → v2.0.2: 2 files changed, +38 −6
| 文件 | 变更 |
|---|---|
electron/main.cjs |
fetchReleaseNotes 重写:net.fetch → node:https,增加日志和错误处理 |
package.json |
版本号 2.0.1 → 2.0.2 |
📥 Assets 说明
| 文件 | 说明 |
|---|---|
🖥️ zsb-study-tracker-setup-2.0.2.exe |
Windows NSIS 安装包(x64),支持自定义安装目录 |
📦 latest.yml |
electron-updater 自动更新清单,桌面端启动自动检测 |
🔄 zsb-study-tracker-setup-2.0.2.exe.blockmap |
增量更新块映射,减少更新下载量 |
Web 端用户:访问 演示站点 即可自动使用最新版本,无需手动更新。
🔗 相关链接
- Full Changelog: v2.0.1...v2.0.2
- 项目主页: https://github.com/Han050912/zsb-study-tracker
- 问题反馈: https://github.com/Han050912/zsb-study-tracker/issues
v2.0.1 → v2.0.2 升级无破坏性变更,已安装桌面端应用启动后会自动检测并提示更新。建议所有用户升级。