packServer/desktop/App.xaml.cs
liufumingren fb896272f4 桌面端接入 .NET 8 SDK 并首编译通过;服务地址改为构建期环境配置(开发/生产)
一、工具链
- 本机没有 .NET,微软域名又被网络阻断,改用 curl 从 builds.dotnet.microsoft.com 拉
  dotnet-sdk-8.0.426-win-x64.zip,解压到 %LOCALAPPDATA%\Microsoft\dotnet(免管理员),
  并写入用户 PATH / DOTNET_ROOT / DOTNET_CLI_TELEMETRY_OPTOUT。

二、首次编译暴露的两个真实缺陷(都已修复)
- ProtocolHelper.cs 缺 using System.Collections.Generic(ImplicitUsings=disable 后
  IEnumerable<string> 找不到)。
- App.xaml 少了 BgBrush,LoginWindow/MainWindow 用 StaticResource 引用它 → 编译期查不出,
  运行期一弹登录窗就 XamlParseException 直接退出(事件日志里能看到)。
  已补 BgBrush=#F5F7FA 并注明「缺一个就会运行时炸」。
- 顺带把 WFAC010(WinForms 建议 DPI 改走 ApplicationHighDpiMode)压掉并写明原因:
  本程序宿主是 WPF,走不到 WinForms 的 ApplicationConfiguration,DPI 只能由 manifest 决定。

三、服务地址 = 构建期环境(对齐前端 VITE_BACKEND 的思路)
- csproj:Debug → AppEnvironment=Development、ServerBaseUrl=http://127.0.0.1:7300;
  Release → Production、占位 https://packs.example.com;用 -p:ServerBaseUrl= 覆盖;
  两者通过 AssemblyMetadataAttribute 写进程序集,exe 自带「我是哪个环境」。
- 新增 Services/BuildInfo.cs 读元数据(带兜底,绝不抛)。
- AppSettings:默认值改为 BuildInfo.DefaultServer;等于内置默认值时不落盘(换构建能自动跟随),
  老版本已把默认值写进 settings.json 的也识别为"没改过";新增 UseServer() 支持运行时临时覆盖。
- App:解析 --server=xxx / -s xxx,其次 YUNCANG_SERVER 环境变量,写在构建默认值之前。
- 登录窗:「服务器地址」改叫「服务地址」,右侧显示"开发环境/生产环境"(只展示,由构建决定),
  输入框 ToolTip 说明留空即用当前环境默认地址。
- /api/health 增加 env(Development/Production)与 server(当前后端地址),排障一眼看出装错没有。

四、验证
- Debug / Release / Release+域名覆盖 三种构建均 0 警告 0 错误;
- Debug:health 返回 env=Development、server=http://127.0.0.1:7300;
- Release:env=Production、server=https://packs.example.com;
  Release 加 -p:ServerBaseUrl=https://trace.yuncang.cn 后 server 随之变化;
- 带 --server=http://10.0.0.9:7300 启动:server 被覆盖,settings.json 未被污染;
- health / 未登录 query(401) / activate-login(200,登录窗弹出) / OPTIONS 预检(204+CORS) 全部正常。
- 注意:改 -p: 属性必须 -t:Rebuild,否则 MSBuild 不会重新生成 AssemblyInfo。

五、README
- 新增「环境配置(开发 / 生产)」:构建矩阵、发布时覆盖域名、优先级、默认值不落盘的原因、
  settings.json/session.json 的行为;补了本机 SDK 装在用户目录、需要 DOTNET_ROOT 的说明;
  行为表新增「网页请求唤起登录」一行;health 返回字段更新。
2026-10-17 10:48:11 +08:00

346 lines
10 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();
// ③ 托盘
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();
_single.StartListening();
}
// ---------------- 登录 ----------------
/// <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;
}
// 没登录:登录窗是模态的,一直在,只要把它叫到最前面
if (_loginWindow is not null)
{
if (_loginWindow.WindowState == WindowState.Minimized) _loginWindow.WindowState = WindowState.Normal;
_loginWindow.Activate();
_loginWindow.Topmost = true;
_loginWindow.Topmost = false;
_loginWindow.Focus();
return;
}
// 兜底(正常不会走到):直接走一次登录流程
if (ShowLogin()) ShowMainWindow();
});
}
/// <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)
{
// 还在登录界面:等登录完再查
_pendingLaunchUrl = url;
return;
}
ShowAppWindow();
_main.HandleLaunchUrl(url);
return;
}
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);
}
}