packServer/desktop/App.xaml.cs
liufumingren 30ad162c69 修复唤起:协议自动指向当前 exe + 单实例监听提前 + 自包含发布(不再依赖 DOTNET_ROOT)
现象:网页点「启动本机软件」/双击 exe 弹「You must install .NET Desktop Runtime」,
网页表现为唤起没反应、查询失败。

根因有两个:
1. 协议注册表指向的是 bin\Debug 的 framework-dependent exe,它靠 DOTNET_ROOT 找运行时;
   而浏览器/资源管理器/协议拉起的进程拿不到我们临时设的环境变量 → 直接弹安装提示。
   更糟的是协议只在主窗口手动点按钮才注册,换目录/换构建后注册表一直是旧路径。
2. 单实例的命名管道监听是在「登录完成、主窗口出现」之后才 StartListening,
   用户卡在登录窗期间被协议唤起 → 参数无人接收(第二个实例连不上管道就直接退出了)。

修复:
- App.EnsureProtocolRegistered():每次启动把 HKCU 的 command 校正到 Environment.ProcessPath,
  与当前 exe 一致时跳过(幂等);不一致时重注册并记日志(含原路径,方便排查)。
- _single.StartListening() 提前到启动服务之后、登录之前。
- 登录期间收到唤起:存 pending code 并把登录窗叫到前面,登录完成后自动查询(原有逻辑保留)。
- 抽出 BringLoginWindowToFront(),OnLoginRequested / 第二次双击(不带 URL)也走它——
  以前登录期间再双击 exe 是彻底没反应的。
- MainWindow 的协议状态改为显示「是否指向当前 exe」,指向旧路径时提示重启会自动校正。

分发形态改为自包含:
- desktop/nuget.config 指向华为云 NuGet 镜像(本机访问不了 api.nuget.org),
  自包含发布要下载 Microsoft.*.App.Runtime.win-x64;
- dotnet publish -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true
  -p:IncludeNativeLibrariesForSelfExtract=true -o publish → 单文件约 154 MB,双击/协议唤起都能直接跑。
- publish/ 已在 .gitignore 里。

实测(全程清掉 DOTNET_ROOT,模拟用户环境):
- 冷启动:yuncang://open?code=COLD123 → 进程起来 → 恢复登录 → 自动查询 COLD123;
- 已运行时:yuncang://open?code=TEST999 → 管道转发到原实例 → 主窗口前置并查询;
- 注册表自动从 bin\Debug 校正到 publish\...exe(日志有记录);
- 网页 /local?code=ABC123 → 已登录 → 正常展示查询结果(真实桌面端,非 mock)。
2026-10-17 10:58:03 +08:00

381 lines
12 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;
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();
}
/// <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);
}
}