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

64 lines
2.7 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.Linq;
using System.Reflection;
namespace YuncangTrace.LocalService.Services;
/// <summary>
/// 构建期注入的环境信息 —— 和前端 <c>VITE_BACKEND</c> 一个思路:
/// 开发 / 生产由**构建**决定,不靠用户手填。
///
/// - Debug 构建 :环境 = <c>Development</c>,默认后端 <c>http://127.0.0.1:7300</c>(与前端 dev 代理一致);
/// - Release 构建 :环境 = <c>Production</c>,默认后端 <c>https://packs.example.com</c>(占位,打包时覆盖);
/// - 打包时覆盖 :<c>dotnet build -c Release -p:ServerBaseUrl=https://你的域名</c>。
///
/// 值由 <c>YuncangTrace.LocalService.csproj</c> 通过 <see cref="AssemblyMetadataAttribute"/> 写进程序集,
/// 因此 exe 自己就带着"它是哪个环境"的信息,不需要额外的配置文件。
/// </summary>
public static class BuildInfo
{
/// <summary>Debug 构建的默认后端(= 前端 dev 代理的后端 127.0.0.1:7300)</summary>
public const string DevServer = "http://127.0.0.1:7300";
/// <summary>Release 构建的默认后端(占位,打包时用 -p:ServerBaseUrl= 覆盖)</summary>
public const string ProdServerPlaceholder = "https://packs.example.com";
/// <summary>环境名:<c>Development</c> / <c>Production</c></summary>
public static string Environment { get; } = ReadMetadata("AppEnvironment", "Development");
/// <summary>当前构建的默认后端地址</summary>
public static string DefaultServer { get; } = Normalize(ReadMetadata("ServerBaseUrl", DevServer));
/// <summary>是不是开发(Debug)构建</summary>
public static bool IsDevelopment =>
Environment.Equals("Development", StringComparison.OrdinalIgnoreCase);
/// <summary>给人看的环境名(登录窗里显示)</summary>
public static string EnvironmentLabel => IsDevelopment ? "开发环境" : "生产环境";
/// <summary><c>--server=...</c> / <c>YUNCANG_SERVER</c> 的运行时覆盖(排在构建默认值之前)</summary>
private static string ReadMetadata(string key, string fallback)
{
try
{
var value = Assembly.GetEntryAssembly()
?.GetCustomAttributes<AssemblyMetadataAttribute>()
.FirstOrDefault(a => string.Equals(a.Key, key, StringComparison.OrdinalIgnoreCase))
?.Value;
return string.IsNullOrWhiteSpace(value) ? fallback : value.Trim();
}
catch
{
return fallback;
}
}
private static string Normalize(string url)
{
var value = url.Trim();
if (!value.Contains("://", StringComparison.Ordinal)) value = "http://" + value;
return value.TrimEnd('/');
}
}