AndroidStation(原中控改造为纯设备端) - 只做三件事:UDP 48899 被桌面端发现、TCP 8087 推送 USB 扫码结果、离线语音播报 - 扫码不再经过 UI:去掉逐键重绘,50ms 自动提交,同一码重复扫码也一律上报 - 离线语音种子(数字/字母/“开始打包”/欢迎语)随包安装,MediaPlayer 播放,启动把音量拉满 - 启动播报「欢迎使用溯源系统,初始化已经完成,扫码即可开始打包」 - 移除 Device Owner / 设备管理员 / lock task / 网络与 IP 设置等非普通应用能力(仅保留开机自启) - 正式签名 keystore + release 签名配置,versionName/versionCode 可由打包脚本覆盖 发布脚手架 - backend/android_client:Android 正式包构建(build.ps1 + package.config.json) - backend/scripts/deploy/publish-android.cjs + npm run android:build / android:publish - 桌面端安装包改为 download/desktop,Android 为 download/android_client; version.json 仍走 /download/version.json(老客户端写死),新增 /download/android_client/version.json - 谷歌插件随桌面端 MSI 安装到 <安装目录>\extension,工具菜单新增「复制谷歌插件地址」 - git-safety-check 增加仓库级禁区(keystore.properties / *.jks / local.properties) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
268 lines
11 KiB
C#
268 lines
11 KiB
C#
using System;
|
||
using System.IO;
|
||
using System.Text.Encodings.Web;
|
||
using System.Text.Json;
|
||
|
||
namespace YuncangTrace.LocalService.Services;
|
||
|
||
/// <summary>
|
||
/// 本机设置:`%LOCALAPPDATA%\YuncangTrace\settings.json`
|
||
///
|
||
/// 目前只有「服务器地址」(登录用的后端)和「记住账号」。
|
||
/// 服务器地址的**默认值**来自构建环境(<see cref="BuildInfo"/>),用户没改过就不落盘,
|
||
/// 这样 Debug / Release 两个构建各自连自己的后端,不会互相污染。
|
||
/// </summary>
|
||
public sealed class AppSettings
|
||
{
|
||
/// <summary>当前构建的默认后端地址(Debug = 本地 7300,Release = 正式站点)</summary>
|
||
public static string DefaultServer => BuildInfo.DefaultServer;
|
||
|
||
/// <summary>后端 API 根地址(登录、校验令牌都走它)</summary>
|
||
public string ServerBaseUrl { get; set; } = DefaultServer;
|
||
|
||
/// <summary>地址来自命令行/环境变量的临时覆盖(不落盘)</summary>
|
||
[System.Text.Json.Serialization.JsonIgnore]
|
||
public bool ServerIsVolatile { get; private set; }
|
||
|
||
/// <summary>上次登录的账号(只在「记住账号」勾选时保存)</summary>
|
||
public string LastAccount { get; set; } = string.Empty;
|
||
|
||
/// <summary>是否记住账号</summary>
|
||
public bool RememberAccount { get; set; } = true;
|
||
|
||
// ---------------- 主体(租户) ----------------
|
||
|
||
/// <summary>上次选择的主体 id(0 = 未选)</summary>
|
||
public int SubjectId { get; set; }
|
||
|
||
/// <summary>上次选择的主体名称(仅界面展示)</summary>
|
||
public string SubjectName { get; set; } = string.Empty;
|
||
|
||
/// <summary>我在该主体里的角色(1 管理员 / 2 成员):非管理员看不到「开启设备服务」</summary>
|
||
public int SubjectRole { get; set; } = 2;
|
||
|
||
// ---------------- 设备服务(本机作为扫码中控上报;**默认关闭**) ----------------
|
||
|
||
/// <summary>是否已开启设备服务</summary>
|
||
public bool DeviceServiceEnabled { get; set; }
|
||
|
||
/// <summary>本机设备 id(服务端 scanners.id)</summary>
|
||
public int DeviceId { get; set; }
|
||
|
||
/// <summary>本机设备 SN(默认用机器名,可手工指定)</summary>
|
||
public string DeviceSn { get; set; } = string.Empty;
|
||
|
||
/// <summary>设备长期 JWT(上报用;关闭服务时清空)</summary>
|
||
public string DeviceToken { get; set; } = string.Empty;
|
||
|
||
/// <summary>设备刷新令牌(服务用它自动续期访问令牌;关闭服务时清空)</summary>
|
||
public string DeviceRefreshToken { get; set; } = string.Empty;
|
||
|
||
/// <summary>设备令牌到期时间(展示用)</summary>
|
||
public string DeviceTokenExpiresAt { get; set; } = string.Empty;
|
||
|
||
// ---------------- 录像存储 ----------------
|
||
|
||
/// <summary>
|
||
/// 录像根目录(空 = 默认 <c>~/packVideo</c>)
|
||
///
|
||
/// 实际放在这里的文件按 <c>年/月/日</c> 分子目录(见 <see cref="VideoStorage.FolderFor"/>),
|
||
/// 例如 <c>~/packVideo/2026/03/11/7915…_合并_20260311_101500.mp4</c>。
|
||
/// </summary>
|
||
public string VideoRoot { get; set; } = string.Empty;
|
||
|
||
/// <summary>解析后的录像根目录(没设置就是默认值)</summary>
|
||
[System.Text.Json.Serialization.JsonIgnore]
|
||
public string VideoRootResolved => string.IsNullOrWhiteSpace(VideoRoot)
|
||
? VideoStorage.DefaultRoot
|
||
: VideoRoot;
|
||
|
||
// ---------------- NTP 校时(本机系统时钟) ----------------
|
||
|
||
/// <summary>是否启用 NTP 校时(总开关;关闭后启动/定时都不再校时)</summary>
|
||
public bool NtpEnabled { get; set; } = true;
|
||
|
||
/// <summary>NTP 服务器(域名或 IP)</summary>
|
||
public string NtpServer { get; set; } = "ntp.aliyun.com";
|
||
|
||
/// <summary>启动时是否自动校时</summary>
|
||
public bool NtpSyncOnStartup { get; set; } = true;
|
||
|
||
/// <summary>
|
||
/// 运行期间的自动校时间隔(分钟;0 = 只在启动时校一次)
|
||
/// 本机会持续漂移,定时校一次能避免「跑一天又差几秒」。
|
||
/// </summary>
|
||
public int NtpSyncIntervalMinutes { get; set; } = 30;
|
||
|
||
/// <summary>上次校时时间(展示用,格式 yyyy-MM-dd HH:mm:ss)</summary>
|
||
public string NtpLastSyncAt { get; set; } = string.Empty;
|
||
|
||
/// <summary>上次校时前的本机偏差(秒,正数 = 本机慢了)</summary>
|
||
public double NtpLastOffsetSeconds { get; set; }
|
||
|
||
private static string Dir => Path.Combine(
|
||
Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "YuncangTrace");
|
||
|
||
private static string FilePath => Path.Combine(Dir, "settings.json");
|
||
|
||
private static readonly JsonSerializerOptions Options = new()
|
||
{
|
||
WriteIndented = true,
|
||
Encoder = JavaScriptEncoder.UnsafeRelaxedJsonEscaping,
|
||
};
|
||
|
||
/// <summary>读设置(读不到就用默认值,绝不抛)</summary>
|
||
public static AppSettings Load()
|
||
{
|
||
try
|
||
{
|
||
if (!File.Exists(FilePath)) return new AppSettings();
|
||
|
||
var settings = JsonSerializer.Deserialize<AppSettings>(File.ReadAllText(FilePath));
|
||
if (settings is null) return new AppSettings();
|
||
|
||
// 文件里存的是空串 = 用户没改过,用当前构建的默认值;
|
||
// 老版本会把默认地址直接落盘,所以「等于任何已知默认值」也当作没改过,跟随当前构建。
|
||
// 同一个域名只换了协议(http → https 强制跳转后 POST 会被降级成 GET)也按默认值处理。
|
||
var stored = Normalize(settings.ServerBaseUrl);
|
||
settings.ServerBaseUrl = IsKnownDefault(stored) || IsSameHostAsDefault(stored) ? DefaultServer : stored;
|
||
return settings;
|
||
}
|
||
catch (Exception ex)
|
||
{
|
||
AppLog.Write($"读取设置失败(用默认值):{ex.Message}");
|
||
return new AppSettings();
|
||
}
|
||
}
|
||
|
||
/// <summary>运行时指定后端地址(<c>--server=</c> / <c>YUNCANG_SERVER</c>),只影响本次运行</summary>
|
||
public void UseServer(string? url)
|
||
{
|
||
var value = (url ?? string.Empty).Trim();
|
||
if (value.Length == 0) return;
|
||
|
||
ServerBaseUrl = Normalize(value);
|
||
ServerIsVolatile = true;
|
||
AppLog.Write($"后端地址已被临时覆盖:{ServerBaseUrl}(不保存)");
|
||
}
|
||
|
||
/// <summary>存设置(失败只记日志)</summary>
|
||
public void Save()
|
||
{
|
||
try
|
||
{
|
||
ServerBaseUrl = Normalize(ServerBaseUrl);
|
||
if (!RememberAccount) LastAccount = string.Empty;
|
||
|
||
Directory.CreateDirectory(Dir);
|
||
|
||
// 等于构建默认值(或只是临时覆盖)就写空串:换环境构建时能自动跟随,只有用户手改的地址才落盘
|
||
var stored = ServerIsVolatile || ServerBaseUrl == DefaultServer ? string.Empty : ServerBaseUrl;
|
||
var payload = new StoredSettings
|
||
{
|
||
ServerBaseUrl = stored,
|
||
LastAccount = LastAccount,
|
||
RememberAccount = RememberAccount,
|
||
SubjectId = SubjectId,
|
||
SubjectName = SubjectName,
|
||
SubjectRole = SubjectRole,
|
||
DeviceServiceEnabled = DeviceServiceEnabled,
|
||
DeviceId = DeviceId,
|
||
DeviceSn = DeviceSn,
|
||
DeviceToken = DeviceToken,
|
||
DeviceTokenExpiresAt = DeviceTokenExpiresAt,
|
||
DeviceRefreshToken = DeviceRefreshToken,
|
||
|
||
NtpEnabled = NtpEnabled,
|
||
NtpServer = NtpServer,
|
||
NtpSyncOnStartup = NtpSyncOnStartup,
|
||
NtpSyncIntervalMinutes = NtpSyncIntervalMinutes,
|
||
NtpLastSyncAt = NtpLastSyncAt,
|
||
NtpLastOffsetSeconds = NtpLastOffsetSeconds,
|
||
};
|
||
|
||
File.WriteAllText(FilePath, JsonSerializer.Serialize(payload, Options));
|
||
}
|
||
catch (Exception ex)
|
||
{
|
||
AppLog.Write($"保存设置失败:{ex.Message}");
|
||
}
|
||
}
|
||
|
||
/// <summary>统一成 `http://host:port` 形式(去掉末尾斜杠,没写协议就补 http://)</summary>
|
||
public static string Normalize(string? url)
|
||
{
|
||
var value = (url ?? string.Empty).Trim();
|
||
if (value.Length == 0) return DefaultServer;
|
||
|
||
if (!value.Contains("://", StringComparison.Ordinal)) value = "http://" + value;
|
||
return value.TrimEnd('/');
|
||
}
|
||
|
||
/// <summary>是不是"内置默认地址"之一(老版本落盘过这些值,不该当成用户自定义)</summary>
|
||
private static bool IsKnownDefault(string url)
|
||
{
|
||
return url.Equals(DefaultServer, StringComparison.OrdinalIgnoreCase)
|
||
|| url.Equals(Normalize(BuildInfo.DevServer), StringComparison.OrdinalIgnoreCase)
|
||
|| url.Equals(Normalize(BuildInfo.ProdServerPlaceholder), StringComparison.OrdinalIgnoreCase);
|
||
}
|
||
|
||
/// <summary>和默认地址是同一台服务器,只是协议不同(例如强制 HTTPS 之前落盘的 http 地址)</summary>
|
||
public static bool IsSameHostAsDefault(string? url)
|
||
{
|
||
if (!Uri.TryCreate(Normalize(url), UriKind.Absolute, out var stored)
|
||
|| !Uri.TryCreate(DefaultServer, UriKind.Absolute, out var current))
|
||
{
|
||
return false;
|
||
}
|
||
|
||
if (!string.Equals(stored.Host, current.Host, StringComparison.OrdinalIgnoreCase)) return false;
|
||
if (current.Scheme != Uri.UriSchemeHttps || stored.Scheme != Uri.UriSchemeHttp) return false;
|
||
|
||
// 只认「默认端口」的旧地址(http://host 与 https://host),不碰用户自己加的端口
|
||
return stored.Port == current.Port || (stored.Port == 80 && current.Port == 443);
|
||
}
|
||
|
||
/// <summary>落盘用的结构(和本类的可读属性一一对应)</summary>
|
||
private sealed class StoredSettings
|
||
{
|
||
public string ServerBaseUrl { get; set; } = string.Empty;
|
||
|
||
public string LastAccount { get; set; } = string.Empty;
|
||
|
||
public bool RememberAccount { get; set; } = true;
|
||
|
||
public int SubjectId { get; set; }
|
||
|
||
public string SubjectName { get; set; } = string.Empty;
|
||
|
||
public int SubjectRole { get; set; } = 2;
|
||
|
||
public bool DeviceServiceEnabled { get; set; }
|
||
|
||
public int DeviceId { get; set; }
|
||
|
||
public string DeviceSn { get; set; } = string.Empty;
|
||
|
||
public string DeviceToken { get; set; } = string.Empty;
|
||
|
||
public string DeviceTokenExpiresAt { get; set; } = string.Empty;
|
||
|
||
public string DeviceRefreshToken { get; set; } = string.Empty;
|
||
|
||
// ---------------- NTP 校时 ----------------
|
||
|
||
public bool NtpEnabled { get; set; } = true;
|
||
|
||
public string NtpServer { get; set; } = "ntp.aliyun.com";
|
||
|
||
public bool NtpSyncOnStartup { get; set; } = true;
|
||
|
||
public int NtpSyncIntervalMinutes { get; set; } = 30;
|
||
|
||
public string NtpLastSyncAt { get; set; } = string.Empty;
|
||
|
||
public double NtpLastOffsetSeconds { get; set; }
|
||
}
|
||
}
|