packServer/desktop/App.xaml.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

421 lines
14 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.Diagnostics;
using System.Net;
using System.Threading.Tasks;
using System.Windows;
using YuncangTrace.LocalService.Services;
namespace YuncangTrace.LocalService;
/// <summary>
/// 应用入口,负责五件事:
///
/// 1. **防多开**:全局互斥体;第二个实例把参数(可能是 `yuncang://open?code=xxx`)送给第一个实例后自己退出;
/// 2. **本机 HTTP 服务**(127.0.0.1:17300):登录前就起来,关窗口也不停(托盘里继续跑);
/// 3. **托盘图标**:关窗口 = 缩到托盘;只有从托盘菜单「退出」才真正退出;
/// 4. **登录**:有本地令牌先验证(`/api/web/me`),失效就弹登录窗;登录成功再开主窗口。
/// </summary>
public partial class App : Application
{
private const string AppName = "YuncangTrace.LocalService";
private SingleInstance? _single;
private AppSettings _settings = new();
private LocalHttpServer? _server;
private TrayIconService? _tray;
private MainWindow? _main;
private LoginWindow? _loginWindow;
private Session? _session;
private string? _pendingLaunchUrl;
private bool _exiting;
private bool _trayHintShown;
protected override void OnStartup(StartupEventArgs e)
{
base.OnStartup(e);
// WinForms 控件的视觉样式(否则托盘右键菜单是 Win95 风格)
System.Windows.Forms.Application.EnableVisualStyles();
// ① 防多开
_single = new SingleInstance(AppName, OnSecondInstanceArgs);
if (!_single.IsFirstInstance)
{
_single.SendArgs(e.Args);
Shutdown();
return;
}
_settings = AppSettings.Load();
ApplyServerOverride(e.Args);
_pendingLaunchUrl = ProtocolHelper.FirstLaunchUrl(e.Args);
// ② 本机服务先起来(和登录状态无关)
_server = new LocalHttpServer(new OrderQueryService());
_server.Log += AppLog.Write;
// 网页靠 /api/health 里的 loggedIn 判断要不要唤起登录,靠 /api/activate-login 把登录窗叫到前台
_server.IsLoggedInProvider = () => _session is not null;
_server.UserNameProvider = () => _session?.DisplayName;
_server.ServerBaseUrlProvider = () => _settings.ServerBaseUrl;
_server.LoginRequested += OnLoginRequested;
StartLocalServer();
// 启动协议永远指向「当前这个 exe」:换目录/从 Debug 换成发布版/重新安装后,
// 旧注册表项会指向一个不存在的或依赖开发环境的 exe(网页“启动本机软件”会直接报错)。
EnsureProtocolRegistered();
// 单实例监听要**在登录之前**起来:用户卡在登录窗时被协议唤起,参数也要能进来。
_single.StartListening();
// ③ 托盘
var version = GetType().Assembly.GetName().Version?.ToString() ?? "1.0.0";
_tray = new TrayIconService(_server.BaseUrl, version);
_tray.ShowRequested += ShowAppWindow;
_tray.ExitRequested += ExitApplication;
UpdateTrayStatus();
AppLog.Write($"本机服务:{_server.BaseUrl}({(_server.IsRunning ? "运行中" : "未启动")})");
AppLog.Write($"环境:{BuildInfo.EnvironmentLabel},后端:{_settings.ServerBaseUrl}");
// ④ 登录 → 主窗口
if (!ShowLogin())
{
ExitApplication();
return;
}
ShowMainWindow();
// ⑤ 检查更新(后台;失败静默,不影响使用)
_ = CheckUpdatesAsync();
}
/// <summary>
/// 检查更新:后端静态 <c>GET /download/version.json</c>,比当前程序集版本新就弹窗问要不要下载。
/// 网络失败 / 后端没放 version.json 都静默(这不该打扰用户)。
/// </summary>
private async Task CheckUpdatesAsync()
{
try
{
var current = GetType().Assembly.GetName().Version ?? new Version(1, 0, 0, 0);
var info = await UpdateChecker.CheckAsync(_settings.ServerBaseUrl, current);
if (info is null) return;
AppLog.Write($"发现新版本 {info.Version}(当前 {current}):{info.DownloadUrl}");
// 软件内弹窗 + 进度条下载 + 自动安装(不跳浏览器)
AppLog.Write("准备显示更新窗口…");
var update = new UpdateWindow(info, current)
{
// 回归测试用:YUNCANG_AUTO_UPDATE=1 时不点按钮直接开始下载
AutoStart = Environment.GetEnvironmentVariable("YUNCANG_AUTO_UPDATE") == "1",
};
var result = update.ShowDialog();
AppLog.Write($"更新窗口返回:{result}");
if (result == true)
{
AppLog.Write("更新已开始安装,退出本程序以释放 exe");
ExitApplication();
}
}
catch (Exception ex)
{
AppLog.Write($"检查更新失败:{ex.Message}");
}
}
/// <summary>
/// 把 <c>yuncang://open?code=xxx</c> 的注册表项校正到当前 exe。
/// 已经指向当前 exe 时什么都不做(幂等,每次启动都能安全调用)。
/// </summary>
private void EnsureProtocolRegistered()
{
try
{
var exe = Environment.ProcessPath;
if (string.IsNullOrEmpty(exe)) return;
var want = $"\"{exe}\" \"%1\"";
var current = ProtocolHelper.RegisteredCommand();
if (string.Equals(current, want, StringComparison.OrdinalIgnoreCase)) return;
ProtocolHelper.Register();
AppLog.Write(current is null
? $"已注册启动协议 {ProtocolHelper.Scheme}:// → {exe}"
: $"启动协议已改指向当前程序:{exe}(原来是 {current})");
}
catch (Exception ex)
{
AppLog.Write($"注册启动协议失败:{ex.Message}");
}
}
// ---------------- 登录 ----------------
/// <summary>
/// 后端地址的运行时覆盖(优先级:<c>--server=xxx</c> 参数 &gt; <c>YUNCANG_SERVER</c> 环境变量 &gt; 构建默认值)
///
/// 打包/联调时用:<c>YuncangTrace.LocalService.exe --server=http://192.168.1.10:7300</c>
/// </summary>
private void ApplyServerOverride(string[] args)
{
string? url = null;
for (var i = 0; i < args.Length; i++)
{
var arg = args[i];
const string prefix = "--server=";
if (arg.StartsWith(prefix, StringComparison.OrdinalIgnoreCase))
{
url = arg[prefix.Length..];
}
else if ((arg == "--server" || arg == "-s") && i + 1 < args.Length)
{
url = args[i + 1];
}
}
if (string.IsNullOrWhiteSpace(url))
{
url = Environment.GetEnvironmentVariable("YUNCANG_SERVER");
}
_settings.UseServer(url);
}
/// <summary>显示登录窗;返回 false = 用户取消(应退出程序)</summary>
private bool ShowLogin()
{
var saved = SessionStore.Load();
// 换了服务器地址就别复用旧令牌了
if (saved is not null
&& !string.Equals(saved.ServerBaseUrl, _settings.ServerBaseUrl, StringComparison.OrdinalIgnoreCase))
{
AppLog.Write("服务器地址已变更,需要重新登录");
saved = null;
}
var login = new LoginWindow(_settings, saved);
_loginWindow = login;
var accepted = login.ShowDialog() == true && login.Session is not null;
_loginWindow = null;
if (accepted)
{
_session = login.Session;
return true;
}
return false;
}
/// <summary>
/// 网页请求唤起登录(`POST /api/activate-login`):来自 HTTP 线程,切回 UI 线程处理
/// </summary>
private void OnLoginRequested()
{
Dispatcher.Invoke(() =>
{
// 已登录:把主界面叫到前台就够了
if (_session is not null)
{
ShowAppWindow();
return;
}
BringLoginWindowToFront();
});
}
/// <summary>把登录窗弹到最前(没登录时网页/协议/第二次双击都走这里)</summary>
private void BringLoginWindowToFront()
{
if (_loginWindow is null) return;
if (_loginWindow.WindowState == WindowState.Minimized) _loginWindow.WindowState = WindowState.Normal;
_loginWindow.Activate();
_loginWindow.Topmost = true;
_loginWindow.Topmost = false;
_loginWindow.Focus();
}
/// <summary>退出登录:清令牌 → 关主窗口 → 重新登录(取消则退出程序)</summary>
private void OnLogoutRequested()
{
AppLog.Write("已退出登录");
SessionStore.Clear();
_session = null;
if (_main is not null)
{
_main.AllowClose = true;
_main.Close();
_main = null;
}
if (!ShowLogin())
{
ExitApplication();
return;
}
ShowMainWindow();
}
// ---------------- 窗口 ----------------
private void ShowMainWindow()
{
var server = _server;
var session = _session;
if (server is null || session is null) return;
if (_main is null)
{
_main = new MainWindow(server, _settings, session);
_main.LogoutRequested += OnLogoutRequested;
_main.HiddenToTray += OnHiddenToTray;
_main.ServiceStateChanged += UpdateTrayStatus;
}
ShowAppWindow();
// 被协议带过来的 code:登录完再查
if (_pendingLaunchUrl is not null)
{
var url = _pendingLaunchUrl;
_pendingLaunchUrl = null;
_main.HandleLaunchUrl(url);
}
}
/// <summary>把窗口显示出来(托盘双击 / 第二个实例启动时也走这里)</summary>
private void ShowAppWindow()
{
if (_main is null) return;
if (!_main.IsVisible) _main.Show();
if (_main.WindowState == WindowState.Minimized) _main.WindowState = WindowState.Normal;
_main.Activate();
_main.Topmost = true;
_main.Topmost = false;
_main.Focus();
}
private void OnHiddenToTray()
{
if (_trayHintShown) return;
_trayHintShown = true;
_tray?.ShowBalloon("云仓视频溯源软件仍在运行",
$"本机服务在 {_server?.BaseUrl} 继续提供,双击托盘图标可重新打开窗口。");
}
// ---------------- 本机服务 ----------------
private void StartLocalServer()
{
if (_server is null) return;
try
{
_server.Start();
}
catch (HttpListenerException ex)
{
var hint = ex.ErrorCode switch
{
5 => "没有绑定端口的权限。用管理员执行一次:netsh http add urlacl url=http://localhost:17300/ user=%USERNAME%",
32 => "端口 17300 已被占用(可能还有一个本程序实例在跑)。",
_ => $"启动本机服务失败:{ex.Message}",
};
AppLog.Write(hint);
MessageBox.Show(hint, "本机服务启动失败", MessageBoxButton.OK, MessageBoxImage.Warning);
}
catch (Exception ex)
{
AppLog.Write($"启动本机服务失败:{ex.Message}");
MessageBox.Show(ex.Message, "本机服务启动失败", MessageBoxButton.OK, MessageBoxImage.Warning);
}
UpdateTrayStatus();
}
private void UpdateTrayStatus()
{
_tray?.UpdateStatus(_server?.IsRunning == true ? $"运行中 · {_server.BaseUrl}" : "本机服务未启动");
}
// ---------------- 单实例 / 退出 ----------------
/// <summary>另一个实例把参数送过来了(工作线程回调,切回 UI 线程)</summary>
private void OnSecondInstanceArgs(string[] args)
{
Dispatcher.Invoke(() =>
{
var url = ProtocolHelper.FirstLaunchUrl(args);
if (url is not null)
{
AppLog.Write($"另一个实例请求打开:{url}");
if (_main is null)
{
// 还在登录界面:先把登录窗叫到前面,参数留着登录完再查
if (url is not null) _pendingLaunchUrl = url;
BringLoginWindowToFront();
return;
}
ShowAppWindow();
_main.HandleLaunchUrl(url);
return;
}
// 第二次双击 exe(没带 URL):有主窗口就显示,还在登录就把登录窗叫到前面
if (_main is null) BringLoginWindowToFront();
else ShowAppWindow();
});
}
/// <summary>真正退出(托盘菜单 / 登录取消 / 退出登录后取消登录)</summary>
private void ExitApplication()
{
if (_exiting) return;
_exiting = true;
try
{
_tray?.Dispose();
}
catch
{
// 退出路径忽略
}
try
{
_server?.Dispose();
}
catch
{
// 退出路径忽略
}
Shutdown();
}
protected override void OnExit(ExitEventArgs e)
{
_tray?.Dispose();
_server?.Dispose();
_single?.Dispose();
base.OnExit(e);
}
}