using System; using System.Net.Http; using System.Text.Json; using System.Threading; using System.Threading.Tasks; namespace YuncangTrace.LocalService.Services; /// 发现的新版本(来自后端静态 `version.json`) /// 新版本号(如 1.0.1) /// 安装包地址(一般是后端 `/download/YuncangTraceSetup-x.y.z.msi`) /// 安装包 MD5(可用于下载后校验) /// 安装包字节数(0 = 未知) /// 更新说明(可为空) public sealed record UpdateInfo(string Version, string? DownloadUrl, string? Md5, long Size, string? Notes); /// /// 自动更新检查:请求后端的静态 `GET /download/version.json`,与当前程序版本比对。 /// /// `version.json` 由 `desktop/installer/build.ps1` 生成,内容形如: /// /// { "version": "1.0.1", "downloadUrl": "https://站点/download/YuncangTraceSetup-1.0.1.msi", /// "md5": "…", "size": 56712345, "publishedAt": "…", "buildId": "…", "releaseNotes": "…" } /// /// /// ⚠️ 缓存是这里最容易踩的坑(Egg 的 static 生产默认强缓存一年): /// - URL 带 `?t=毫秒时间戳`; /// - 请求头带 `no-cache`; /// - 后端 `middleware/download.js` 对 version.json 回 `no-store` 并去掉 ETag/Last-Modified。 /// 三层都做,是为了兼容中间可能存在的代理 / CDN。 /// public static class UpdateChecker { /// 版本信息地址(跟当前构建环境的后端地址走) public static string VersionUrl(string serverBaseUrl) => serverBaseUrl.TrimEnd('/') + "/download/version.json"; /// /// 检查是否有更新。 /// /// 有新版本返回它;已是最新 / 请求失败 / 数据不合法都返回 null public static async Task 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; return new UpdateInfo( text.Trim(), root.TryGetProperty("downloadUrl", out var d) ? d.GetString() : null, 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); } }