using System;
using System.Collections.Generic;
using System.Runtime.InteropServices;
using NewLife;
using NewLife.XCoder.Services;
namespace NewLife.XCoder.Tools.Platform;
/// <summary>平台能力项</summary>
/// <param name="Key">能力键,如 serial / can / audio</param>
/// <param name="Title">能力名称</param>
/// <param name="Supported">当前平台是否支持</param>
/// <param name="Reason">不支持时的原因说明,界面直接展示给用户</param>
public sealed record PlatformCapability(String Key, String Title, Boolean Supported, String Reason = "");
/// <summary>平台能力声明:把「哪些能力在当前平台可用」集中声明,界面据此置灰并给出原因</summary>
/// <remarks>
/// 各平台实现目录约定:Windows 走 netsh/WMI/厂商 DLL,Linux 走 sysfs/nmcli/ALSA/SocketCAN,
/// macOS 走 system_profiler/networksetup/CoreAudio。未实现的能力显式声明为不支持,
/// 避免用户点了没反应。
/// </remarks>
public static class PlatformCapabilities
{
/// <summary>是否 Windows</summary>
public static Boolean IsWindows => RuntimeInformation.IsOSPlatform(OSPlatform.Windows);
/// <summary>是否 Linux</summary>
public static Boolean IsLinux => RuntimeInformation.IsOSPlatform(OSPlatform.Linux);
/// <summary>是否 macOS</summary>
public static Boolean IsMacOS => RuntimeInformation.IsOSPlatform(OSPlatform.OSX);
/// <summary>平台标识</summary>
public static String PlatformName => IsWindows ? "Windows" : IsMacOS ? "macOS" : IsLinux ? "Linux" : "Unknown";
/// <summary>当前平台能力清单</summary>
public static IReadOnlyList<PlatformCapability> Current => Build(IsWindows, IsLinux, IsMacOS);
/// <summary>按平台构造能力清单,便于测试与文档对齐</summary>
/// <param name="isWindows">是否 Windows</param>
/// <param name="isLinux">是否 Linux</param>
/// <param name="isMacOS">是否 macOS</param>
/// <returns>能力清单</returns>
public static IReadOnlyList<PlatformCapability> Build(Boolean isWindows, Boolean isLinux, Boolean isMacOS)
{
var list = new List<PlatformCapability>();
list.Add(new("serial", LocalizationService.T("Serial communication"), true, isLinux ? LocalizationService.T("Linux requires adding the user to the dialout group") : ""));
list.Add(new("network", "TCP/UDP/MQTT/SSH", true));
list.Add(new("modbus", "Modbus TCP/RTU", true));
list.Add(new("usb", LocalizationService.T("USB device enumeration"), true, isLinux ? LocalizationService.T("Read from sysfs") : isMacOS ? LocalizationService.T("Call system_profiler") : LocalizationService.T("Read from WMI")));
list.Add(new("audio", LocalizationService.T("Audio device enumeration and playback"), true, isLinux ? LocalizationService.T("Depends on ALSA/PulseAudio") : isMacOS ? LocalizationService.T("Depends on CoreAudio") : ""));
list.Add(new("netconfig", LocalizationService.T("NIC address configuration"), true, isLinux ? LocalizationService.T("Depends on NetworkManager (nmcli)") : isMacOS ? LocalizationService.T("netsh equivalent is networksetup") : ""));
// CAN 依赖硬件与驱动:无适配层时显式说明
if (isLinux)
list.Add(new("can", LocalizationService.T("CAN bus"), true, LocalizationService.T("SocketCAN adapters are auto-detected; vendor channels pending")));
else if (isWindows)
list.Add(new("can", LocalizationService.T("CAN bus"), true, LocalizationService.T("Virtual loopback available; ZLG/PCAN vendor DLLs pending")));
else if (isMacOS)
list.Add(new("can", LocalizationService.T("CAN bus"), false, LocalizationService.T("Vendor driver required for real channels on macOS")));
list.Add(new("credential", LocalizationService.T("Credential storage"), true, isWindows ? LocalizationService.T("AES local-bound encryption (DPAPI pending)") : LocalizationService.T("AES local-bound encryption (keychain/Secret Service pending)")));
list.Add(new("tray", LocalizationService.T("Tray resident"), true));
list.Add(new("single-instance", LocalizationService.T("Single instance"), true));
return list;
}
/// <summary>查询某项能力</summary>
/// <param name="key">能力键</param>
/// <returns>能力项;未声明返回 null</returns>
public static PlatformCapability? Find(String? key)
{
if (key.IsNullOrEmpty()) return null;
foreach (var item in Current)
{
if (String.Equals(item.Key, key, StringComparison.OrdinalIgnoreCase)) return item;
}
return null;
}
/// <summary>能力是否可用;未声明的能力按不可用处理</summary>
/// <param name="key">能力键</param>
public static Boolean IsSupported(String? key) => Find(key)?.Supported == true;
}
|