packServer/desktop/App.xaml.cs
liufumingren 680fff84df desktop:新增 WPF 本机软件(本机 HTTP 服务 + yuncang:// 启动协议)
给前端 `/local` 公共页与 Chrome 插件对接的本机软件(net8.0-windows + UseWPF):

- Services/LocalHttpServer.cs:HttpListener 监听 localhost:17311(同时注册 127.0.0.1 前缀)
  - GET /api/health      探活(2xx 即认为已启动)
  - GET /api/query/{code} 按运单号查信息,成功时字段平铺返回
  - CORS 全量响应头 + Access-Control-Allow-Private-Network(公网 https 页面访问 localhost 的
    PNA 预检),预检 OPTIONS 直接 204
  - 根路径给一个说明页,方便浏览器里手工排查
- Services/OrderQueryService.cs:★ 接真实数据源的位置(现为演示数据)
- Services/ProtocolHelper.cs:HKCU\Software\Classes\yuncang 注册/反注册、解析
  yuncang://open?code=xxx(免管理员)
- Services/SingleInstance.cs:互斥体 + 命名管道,被协议再次拉起时把参数转给已运行窗口,
  不会去抢 17311 端口
- MainWindow:运行状态、服务地址(复制/浏览器打开)、注册启动协议、测试查询、运行日志
- App.xaml.cs:单实例判断 + 协议参数处理;启动即自动起服务

README 里写了编译/发布命令、接口契约、协议注册(含 reg 命令与打包工具做法)、
接真实数据的示例,以及端口权限(netsh http add urlalloc)/端口占用等常见问题。

⚠️ 本机没装 .NET SDK,无法在这里编译验证;XAML/manifest/csproj 已做 XML 良构校验。
2026-10-17 10:13:09 +08:00

65 lines
2.0 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.Windows;
using YuncangTrace.LocalService.Services;
namespace YuncangTrace.LocalService;
/// <summary>
/// 应用入口
///
/// 两件事:**单实例**(协议被点开时系统会再启动一次本程序,要把参数转给已运行的实例)
/// 和**把窗口拉起来**。
/// </summary>
public partial class App : Application
{
private SingleInstance? _single;
private MainWindow? _window;
protected override void OnStartup(StartupEventArgs e)
{
base.OnStartup(e);
_single = new SingleInstance("YuncangTrace.LocalService", OnSecondInstanceArgs);
// 已经有一个实例在跑:把自己的参数(可能是 yuncang://open?code=xxx)转过去,然后退出
if (!_single.IsFirstInstance)
{
_single.SendArgs(e.Args);
Shutdown();
return;
}
_window = new MainWindow();
MainWindow = _window;
_window.Show();
// 起命名管道监听(接收后续「再次启动」带来的参数)
_single.StartListening();
// 本次就是被协议拉起来的:直接进入「按 code 查信息」
var launchUrl = ProtocolHelper.FirstLaunchUrl(e.Args);
if (launchUrl is not null) _window.HandleLaunchUrl(launchUrl);
}
/// <summary>另一个实例把参数送过来了(工作线程回调,切回 UI 线程)</summary>
private void OnSecondInstanceArgs(string[] args)
{
Dispatcher.Invoke(() =>
{
if (MainWindow is MainWindow window)
{
if (window.WindowState == WindowState.Minimized) window.WindowState = WindowState.Normal;
window.Activate();
var url = ProtocolHelper.FirstLaunchUrl(args);
if (url is not null) window.HandleLaunchUrl(url);
}
});
}
protected override void OnExit(ExitEventArgs e)
{
_single?.Dispose();
base.OnExit(e);
}
}