一、打包配置(desktop/installer/package.config.json) - 两个环境各自的域名:Development = http://127.0.0.1:7300,Production = 占位正式域名(发布前替换)。 - keepVersions = 5。 - build.ps1 -Environment Production 自动用生产域名打 exe 与下载地址;-ServerBaseUrl 可临时覆盖。 二、build.ps1 - 新增 -Environment / -Version / -Keep / -ReleaseNotes;版本默认取 csproj,可覆盖, 通过 -p:Version 注入程序集(AssemblyVersion/FileVersion 一起变)。 - 打完后:算 MD5、写 version.json(version/downloadUrl/md5/size/publishedAt/buildId/environment/releaseNotes), 复制 MSI → backend/app/public/download/,version.json → backend/app/public/version/。 - 本地 out/ 与后端目录各只保留最近 5 个安装包(按版本号排序清理)。 - 补丁版保护:后端已有更高版本时,不覆盖 version.json(避免补打旧版把版本降回去)。 三、后端静态分发 + 缓存(关键) - Egg 的 static 生产默认强缓存一年,version.json 若走静态会**永远检测不到更新**。 且实测 koa-static 命中文件后**不再 next()**,后置中间件改不了它的响应头(先写了 middleware 验证不可行,已删)。 → version.json 放到 app/public/version/(不在静态目录),由路由 GET /download/version.json 提供: Cache-Control: no-store, no-cache, must-revalidate, max-age=0 + Pragma/Expires,且不产生 ETag/Last-Modified。 - MSI 仍走 egg-static(prefix /download/,maxAge 31536000),文件名带版本号可长缓存。 - middleware/frontend.js 放行 /download/*,否则会被 SPA 入口接管。 - 实测响应头:version.json 无 ETag/Last-Modified、cache-control: no-store…; MSI cache-control: public, max-age=31536000。 四、桌面端自动更新(Services/UpdateChecker.cs + App) - 启动登录后后台请求 {后端}/download/version.json?t=毫秒时间戳(带 no-cache 头), 比较程序集版本;有新版则弹窗(版本/说明/大小),点是 → 浏览器打开 downloadUrl。 - 失败静默(网络问题不打扰);日志记录发现新版本/已打开下载。 - 实测:安装 1.0.1 → version.json 1.0.1 不提示;改成 1.0.2 后重启 → 日志「发现新版本 1.0.2(当前 1.0.1.0)→ 已打开下载」。 五、.gitignore - 忽略后端分发产物:backend/app/public/{download,version}/* 但保留 .gitkeep。 ⚠️ backend/config/config.default.js 本次提交同时带入了该文件里已有的未提交改动 (后端默认端口 7001 → 7300 及注释),因为 static 配置必须写在同一个文件里; 其它 backend/extension/frontend 的未提交 WIP 未包含在本次提交中。
427 lines
14 KiB
C#
427 lines
14 KiB
C#
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}");
|
||
|
||
var notes = string.IsNullOrWhiteSpace(info.Notes) ? string.Empty : $"\n\n更新内容:{info.Notes}";
|
||
var size = info.Size > 0 ? $"\n安装包大小:{info.Size / 1024.0 / 1024.0:0.0} MB" : string.Empty;
|
||
|
||
var answer = MessageBox.Show(
|
||
$"发现新版本 {info.Version}(当前 {current})。{notes}{size}\n\n现在下载安装包吗?",
|
||
"软件更新",
|
||
MessageBoxButton.YesNo,
|
||
MessageBoxImage.Information);
|
||
|
||
if (answer != MessageBoxResult.Yes) return;
|
||
|
||
if (string.IsNullOrWhiteSpace(info.DownloadUrl))
|
||
{
|
||
AppLog.Write("更新信息里没有下载地址(version.json 的 downloadUrl)");
|
||
return;
|
||
}
|
||
|
||
// 用默认浏览器打开下载(MSI 能直接下,也能交给用户自己跑)
|
||
Process.Start(new ProcessStartInfo(info.DownloadUrl) { UseShellExecute = true });
|
||
AppLog.Write($"已打开下载:{info.DownloadUrl}");
|
||
}
|
||
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> 参数 > <c>YUNCANG_SERVER</c> 环境变量 > 构建默认值)
|
||
///
|
||
/// 打包/联调时用:<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);
|
||
}
|
||
}
|