将Feature/XP.Common和Feature/XP.Hardware分支合并至Develop/XP.forHardwareAndCommon，完善XPapp注册和相关硬件类库通用类库功能。

2026-04-16 17:31:13 +08:00
parent 6ec4c3ddaa
commit 2bd6e566c3
581 changed files with 74600 additions and 222 deletions
@@ -0,0 +1,57 @@
+using System.Globalization;
+using System.Resources;
+using XP.Common.Localization.Interfaces;
+using XP.Common.Resources;
+
+namespace XP.Common.Localization
+{
+    /// <summary>
+    /// 静态本地化帮助类 | Static localization helper
+    /// 用法：Loc.Get("ResourceKey") 或 Loc.Get("ResourceKey", param1, param2)
+    /// Usage: Loc.Get("ResourceKey") or Loc.Get("ResourceKey", param1, param2)
+    /// </summary>
+    public static class LocalizationHelper
+    {
+        private static ILocalizationService? _localizationService;
+
+        /// <summary>
+        /// 初始化本地化帮助类（由 CommonModule 或 App 启动时调用）
+        /// Initialize the localization helper (called by CommonModule or App at startup)
+        /// </summary>
+        /// <param name="localizationService">本地化服务实例 | Localization service instance</param>
+        public static void Initialize(ILocalizationService localizationService)
+        {
+            _localizationService = localizationService;
+        }
+
+        /// <summary>
+        /// 获取本地化字符串（使用当前 UI 语言）| Get localized string (using current UI culture)
+        /// </summary>
+        /// <param name="key">资源键 | Resource key</param>
+        /// <returns>本地化字符串，找不到时返回键本身 | Localized string, returns key itself if not found</returns>
+        public static string Get(string key)
+        {
+            if (string.IsNullOrEmpty(key))
+                return string.Empty;
+
+            if (_localizationService != null)
+                return _localizationService.GetString(key);
+
+            // 兼容回退：未初始化时仍使用原始 ResourceManager
+            // Fallback: use original ResourceManager when not initialized
+            return Resources.Resources.ResourceManager.GetString(key, CultureInfo.CurrentUICulture) ?? key;
+        }
+
+        /// <summary>
+        /// 获取本地化字符串并格式化 | Get localized string with formatting
+        /// </summary>
+        /// <param name="key">资源键 | Resource key</param>
+        /// <param name="args">格式化参数 | Format arguments</param>
+        /// <returns>格式化后的本地化字符串 | Formatted localized string</returns>
+        public static string Get(string key, params object[] args)
+        {
+            var template = Get(key);
+            return args.Length > 0 ? string.Format(template, args) : template;
+        }
+    }
+}