packServer/desktop/Services/UpdateChecker.cs
liufumingren 21e8c6a5ec 更新改为软件内下载(进度条)+ 下载完成自动安装;修复 version.json 与包版本不一致导致的无限提示
一、需求:更新不要跳浏览器
- 新增 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
- 「自动更新怎么工作」改为软件内下载+自动安装,补充下载位置、安装时机、版本一致性防护与测试开关。
2026-10-17 12:27:05 +08:00

96 lines
4.5 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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);
}
}