多轮审查和修复

2026-05-12 15:34:08 +08:00
parent f55d2a57c3
commit ebbbb7332e
805 changed files with 838724 additions and 1905 deletions
--- a/Assets/Scripts/Support/Localization/LocalizationManager.cs
+++ b/Assets/Scripts/Support/Localization/LocalizationManager.cs
@@ -0,0 +1,59 @@
+using System;
+using UnityEngine;
+
+namespace BaseGames.Localization
+{
+    /// <summary>
+    /// 本地化字符串访问工具类（架构 16_SupportingModules §4）。
+    /// 当 Unity Localization 包（com.unity.localization）安装后使用 LocalizationSettings 实现完整功能；
+    /// 未安装时退回到 Key 直传（返回 entryKey 本身）。
+    /// </summary>
+    public static class LocalizationManager
+    {
+#if UNITY_LOCALIZATION
+        private const string DefaultTable = "UI";
+
+        /// <summary>从指定表中获取本地化字符串。</summary>
+        public static string Get(string entryKey, string tableName = DefaultTable)
+        {
+            try
+            {
+                var op = UnityEngine.Localization.Settings.LocalizationSettings
+                    .StringDatabase.GetLocalizedStringAsync(tableName, entryKey);
+                return op.IsDone ? op.Result : entryKey;
+            }
+            catch (Exception e)
+            {
+                Debug.LogWarning($"[Localization] Key '{entryKey}' in table '{tableName}' 读取失败: {e.Message}");
+                return entryKey;
+            }
+        }
+
+        /// <summary>带格式化参数的本地化字符串。</summary>
+        public static string GetFormat(string entryKey, string tableName, params object[] args)
+        {
+            string template = Get(entryKey, tableName);
+            try   { return string.Format(template, args); }
+            catch (Exception e)
+            {
+                Debug.LogWarning($"[Localization] GetFormat '{entryKey}' 格式化失败: {e.Message}");
+                return template;
+            }
+        }
+#else
+        /// <summary>Unity Localization 包未安装：直接返回 Key。</summary>
+        public static string Get(string entryKey, string tableName = "UI")
+            => entryKey;
+
+        public static string GetFormat(string entryKey, string tableName, params object[] args)
+        {
+            try   { return string.Format(entryKey, args); }
+            catch (Exception e)
+            {
+                Debug.LogWarning($"[Localization] GetFormat '{entryKey}' 格式化失败: {e.Message}");
+                return entryKey;
+            }
+        }
+#endif
+    }
+}