packServer/desktop/Services/ProtocolHelper.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

102 lines
4.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;
using System.Collections.Generic;
using System.Linq;
using Microsoft.Win32;
namespace YuncangTrace.LocalService.Services;
/// <summary>
/// 自定义协议(URL Scheme)——「网页叫醒本机应用」的唯一合法方式
///
/// 网页里写 <c>yuncang://open?code=123</c>,浏览器问一句「要打开云仓视频溯源软件吗?」,
/// 系统就会按注册表 <c>HKCU\Software\Classes\yuncang\shell\open\command</c> 找到本 exe 并拉起,
/// 形如:<c>"C:\...\YuncangTrace.LocalService.exe" "yuncang://open?code=123"</c>
///
/// 注意:
/// - 网页**不能**直接执行 exe,也不能拿到返回值(所以还要配合 127.0.0.1 上的 HTTP 服务);
/// - 协议注册在 HKCU,**不需要管理员权限**;
/// - 卸载时应该调用 <see cref="Unregister"/> 把注册表清掉。
/// </summary>
public static class ProtocolHelper
{
/// <summary>协议名(前端用 VITE_APP_PROTOCOL 对齐;改了这里要一起改)</summary>
public const string Scheme = "yuncang";
/// <summary>资源管理器 / 浏览器的提示名</summary>
public const string DisplayName = "云仓视频溯源软件";
/// <summary>拼出唤醒地址:<c>yuncang://open?code=xxx</c></summary>
public static string LaunchUrl(string? code)
{
return string.IsNullOrWhiteSpace(code)
? $"{Scheme}://open"
: $"{Scheme}://open?code={Uri.EscapeDataString(code)}";
}
/// <summary>从命令行参数里找出协议地址(被协议拉起时 Windows 会把它作为第一个参数)</summary>
public static string? FirstLaunchUrl(IEnumerable<string> args)
{
return args.FirstOrDefault(arg =>
arg.StartsWith($"{Scheme}://", StringComparison.OrdinalIgnoreCase));
}
/// <summary>从 <c>yuncang://open?code=xxx</c> 里取出 code(没有就返回 null)</summary>
public static string? ParseCode(string? url)
{
if (string.IsNullOrWhiteSpace(url)) return null;
var index = url.IndexOf('?');
if (index < 0 || index == url.Length - 1) return null;
foreach (var pair in url[(index + 1)..].Split('&', StringSplitOptions.RemoveEmptyEntries))
{
var parts = pair.Split('=', 2);
if (parts.Length == 2 && parts[0].Equals("code", StringComparison.OrdinalIgnoreCase))
{
var value = Uri.UnescapeDataString(parts[1].Replace('+', ' ')).Trim();
return value.Length == 0 ? null : value;
}
}
return null;
}
/// <summary>协议是否已注册</summary>
public static bool IsRegistered()
{
using var key = Registry.CurrentUser.OpenSubKey($@"Software\Classes\{Scheme}\shell\open\command");
return key?.GetValue(null) is string value && value.Length > 0;
}
/// <summary>当前注册的命令行(界面上展示,方便排查指向了哪个 exe)</summary>
public static string? RegisteredCommand()
{
using var key = Registry.CurrentUser.OpenSubKey($@"Software\Classes\{Scheme}\shell\open\command");
return key?.GetValue(null) as string;
}
/// <summary>注册协议(指向当前 exe;HKCU,免管理员)</summary>
public static void Register()
{
var exePath = Environment.ProcessPath
?? throw new InvalidOperationException("拿不到当前程序的路径,无法注册启动协议");
using (var scheme = Registry.CurrentUser.CreateSubKey($@"Software\Classes\{Scheme}"))
{
scheme.SetValue(null, $"URL:{DisplayName}");
scheme.SetValue("URL Protocol", string.Empty);
}
using (var command = Registry.CurrentUser.CreateSubKey($@"Software\Classes\{Scheme}\shell\open\command"))
{
command.SetValue(null, $"\"{exePath}\" \"%1\"");
}
}
/// <summary>取消注册(卸载时调用)</summary>
public static void Unregister()
{
Registry.CurrentUser.DeleteSubKeyTree($@"Software\Classes\{Scheme}", throwOnMissingSubKey: false);
}
}