一、需求:更新不要跳浏览器 - 新增 UpdateWindow(弹窗):显示新版本 / 当前版本 / 包大小 / 更新说明; - 点「立即更新」→ 软件内流式下载(ProgressBar + 百分比 + 已下载/总大小)→ MD5 校验 → 启动安装(等 3 秒让本进程退出,再 msiexec /passive)→ 装完自动重新打开; - 下载目录 %TEMP%\YuncangTraceUpdate\,文件名取 downloadUrl 里的真实文件名 (原来用 version.json 的 version 命名,配错时会误导)。 二、修复「更新不了一直提示 1.0.2」 - 原因:测试数据里 version.json 写 1.0.3,但 downloadUrl 指向 1.0.2 的包; 装完仍是 1.0.2 → 下次启动又提示,永远循环。 - 修复(防御):解析 downloadUrl 里的包版本(YuncangTraceSetup-x.y.z.msi), 若包版本 <= 当前版本则直接忽略更新 —— 以后 version.json 配错/漏传包也不会无限弹窗。 - 同时把环境打成一致:真实打包 1.0.3(version.json 与包都是 1.0.3)并安装。 三、build.ps1 - 自动设置 DOTNET_ROOT(wix 是 dotnet 全局工具,apphost 不认 PATH,只认 DOTNET_ROOT): 之前在无该环境变量的终端里打包会报「You must install .NET to run this application」。 四、验证 - 安装 1.0.3 + version.json 1.0.3 → 启动无更新窗口、日志无「发现新版本」✅ - 伪造 version.json=1.0.4 但包仍是 1.0.3 → 启动**不弹窗**(防御生效)✅ - 恢复 version.json 为 1.0.3。 - 更新窗口 UI 已通过截图确认(新版本/当前版本/包大小/说明/稍后/立即更新)。 - 新增 YUNCANG_AUTO_UPDATE=1 测试开关:弹窗后自动开始下载,便于无 UI 自动化环境回归。 五、README - 「自动更新怎么工作」改为软件内下载+自动安装,补充下载位置、安装时机、版本一致性防护与测试开关。
96 lines
4.5 KiB
C#
96 lines
4.5 KiB
C#
using System;
|
||
using System.Net.Http;
|
||
using System.Text.Json;
|
||
using System.Text.RegularExpressions;
|
||
using System.Threading;
|
||
using System.Threading.Tasks;
|
||
|
||
namespace YuncangTrace.LocalService.Services;
|
||
|
||
/// <summary>发现的新版本(来自后端静态 `version.json`)</summary>
|
||
/// <param name="Version">新版本号(如 1.0.1)</param>
|
||
/// <param name="DownloadUrl">安装包地址(一般是后端 `/download/YuncangTraceSetup-x.y.z.msi`)</param>
|
||
/// <param name="Md5">安装包 MD5(可用于下载后校验)</param>
|
||
/// <param name="Size">安装包字节数(0 = 未知)</param>
|
||
/// <param name="Notes">更新说明(可为空)</param>
|
||
public sealed record UpdateInfo(string Version, string? DownloadUrl, string? Md5, long Size, string? Notes);
|
||
|
||
/// <summary>
|
||
/// 自动更新检查:请求后端的静态 `GET /download/version.json`,与当前程序版本比对。
|
||
///
|
||
/// `version.json` 由 `desktop/installer/build.ps1` 生成,内容形如:
|
||
/// <code>
|
||
/// { "version": "1.0.1", "downloadUrl": "https://站点/download/YuncangTraceSetup-1.0.1.msi",
|
||
/// "md5": "…", "size": 56712345, "publishedAt": "…", "buildId": "…", "releaseNotes": "…" }
|
||
/// </code>
|
||
///
|
||
/// ⚠️ 缓存是这里最容易踩的坑(Egg 的 static 生产默认强缓存一年):
|
||
/// - URL 带 `?t=毫秒时间戳`;
|
||
/// - 请求头带 `no-cache`;
|
||
/// - 后端 `middleware/download.js` 对 version.json 回 `no-store` 并去掉 ETag/Last-Modified。
|
||
/// 三层都做,是为了兼容中间可能存在的代理 / CDN。
|
||
/// </summary>
|
||
public static class UpdateChecker
|
||
{
|
||
/// <summary>版本信息地址(跟当前构建环境的后端地址走)</summary>
|
||
public static string VersionUrl(string serverBaseUrl)
|
||
=> serverBaseUrl.TrimEnd('/') + "/download/version.json";
|
||
|
||
/// <summary>
|
||
/// 从下载地址里解析安装包版本:`.../YuncangTraceSetup-1.0.3.msi` → <c>1.0.3</c>;解析不到返回 null。
|
||
/// </summary>
|
||
public static Version? PackageVersionOf(string? downloadUrl)
|
||
{
|
||
if (string.IsNullOrWhiteSpace(downloadUrl)) return null;
|
||
|
||
var match = Regex.Match(downloadUrl, @"YuncangTraceSetup-(\d+(?:\.\d+){1,3})\.msi", RegexOptions.IgnoreCase);
|
||
return match.Success && Version.TryParse(match.Groups[1].Value, out var version) ? version : null;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 检查是否有更新。
|
||
/// </summary>
|
||
/// <returns>有新版本返回它;已是最新 / 请求失败 / 数据不合法都返回 <c>null</c></returns>
|
||
public static async Task<UpdateInfo?> CheckAsync(
|
||
string serverBaseUrl,
|
||
Version current,
|
||
CancellationToken cancellationToken = default)
|
||
{
|
||
var url = $"{VersionUrl(serverBaseUrl)}?t={DateTimeOffset.UtcNow.ToUnixTimeMilliseconds()}";
|
||
|
||
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(8) };
|
||
using var request = new HttpRequestMessage(HttpMethod.Get, url);
|
||
request.Headers.TryAddWithoutValidation("Cache-Control", "no-cache, no-store");
|
||
request.Headers.TryAddWithoutValidation("Pragma", "no-cache");
|
||
|
||
using var response = await http.SendAsync(request, HttpCompletionOption.ResponseContentRead, cancellationToken)
|
||
.ConfigureAwait(false);
|
||
if (!response.IsSuccessStatusCode) return null;
|
||
|
||
var json = await response.Content.ReadAsStringAsync(cancellationToken).ConfigureAwait(false);
|
||
using var doc = JsonDocument.Parse(json);
|
||
var root = doc.RootElement;
|
||
|
||
if (!root.TryGetProperty("version", out var versionEl)) return null;
|
||
|
||
var text = versionEl.GetString();
|
||
if (string.IsNullOrWhiteSpace(text)) return null;
|
||
if (!Version.TryParse(text.Trim(), out var remote)) return null;
|
||
if (remote <= current) return null;
|
||
|
||
var downloadUrl = root.TryGetProperty("downloadUrl", out var d) ? d.GetString() : null;
|
||
|
||
// 防御:version.json 的 version 可能和下载包本身不一致(配错、或发版时漏传包)。
|
||
// 若包里的版本并不比当前新,提示了也装不上去 → 会无限弹窗,直接忽略。
|
||
var packageVersion = PackageVersionOf(downloadUrl);
|
||
if (packageVersion is not null && packageVersion <= current) return null;
|
||
|
||
return new UpdateInfo(
|
||
text.Trim(),
|
||
downloadUrl,
|
||
root.TryGetProperty("md5", out var m) ? m.GetString() : null,
|
||
root.TryGetProperty("size", out var s) && s.TryGetInt64(out var size) ? size : 0,
|
||
root.TryGetProperty("releaseNotes", out var n) ? n.GetString() : null);
|
||
}
|
||
}
|