一、工具链 - 本机没有 .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 返回字段更新。
102 lines
4.0 KiB
C#
102 lines
4.0 KiB
C#
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);
|
||
}
|
||
}
|