3

Shared/KBLocalizationManager.m

@@ -7,6 +7,20 @@
 #import <Security/Security.h>
 #import "KBConfig.h"
 
+/// 语言常量定义
+KBLanguageCode const KBLanguageCodeEnglish           = @"en";
+KBLanguageCode const KBLanguageCodeSimplifiedChinese = @"zh-Hans";
+
+/// 默认支持语言列表（集中配置）
+NSArray<KBLanguageCode> *KBDefaultSupportedLanguageCodes(void) {
+    static NSArray<KBLanguageCode> *codes;
+    static dispatch_once_t onceToken;
+    dispatch_once(&onceToken, ^{
+        codes = @[KBLanguageCodeEnglish, KBLanguageCodeSimplifiedChinese];
+    });
+    return codes;
+}
+
 /// 语言变更通知名称
 NSString * const KBLocalizationDidChangeNotification = @"KBLocalizationDidChangeNotification";
 
@@ -15,7 +29,7 @@ static NSString * const kKBLocService = @"com.loveKey.nyx.loc";
 static NSString * const kKBLocAccount = @"lang"; // 保存 UTF8 的语言代码
 
 @interface KBLocalizationManager ()
-@property (nonatomic, copy, readwrite) NSString *currentLanguageCode; // 当前语言代码
+@property (nonatomic, copy, readwrite) KBLanguageCode currentLanguageCode; // 当前语言代码
 @property (nonatomic, strong) NSBundle *langBundle; // 对应语言的 .lproj 资源包
 @end
 
@@ -37,11 +51,11 @@ static inline NSMutableDictionary *KBLocBaseKCQuery(void) {
     static KBLocalizationManager *m; static dispatch_once_t onceToken; dispatch_once(&onceToken, ^{
         m = [KBLocalizationManager new];
         // 默认支持语言；可在启动时由外部重置
-        m.supportedLanguageCodes = @[ @"en", @"zh-Hans" ];
+        m.supportedLanguageCodes = KBDefaultSupportedLanguageCodes();
         // 启动读取：先取共享钥匙串，再按系统偏好回退
         NSString *saved = [[self class] kc_read];
         if (saved.length == 0) {
-            saved = [m bestSupportedLanguageForPreferred:[NSLocale preferredLanguages]] ?: @"en";
+            saved = [m bestSupportedLanguageForPreferred:[NSLocale preferredLanguages]] ?: KBLanguageCodeEnglish;
         }
         [m applyLanguage:saved];
     });
@@ -56,7 +70,7 @@ static inline NSMutableDictionary *KBLocBaseKCQuery(void) {
     for (NSString *c in supportedLanguageCodes) {
         if (c.length) { [set addObject:c]; }
     }
-    _supportedLanguageCodes = set.array.count ? set.array : @[ @"en" ];
+    _supportedLanguageCodes = set.array.count ? (NSArray<KBLanguageCode> *)set.array : @[ KBLanguageCodeEnglish ];
     // 若当前语言不再受支持，则按最佳匹配切回（不持久化，仅内存），并广播变更
     if (self.currentLanguageCode.length && ![set containsObject:self.currentLanguageCode]) {
         NSString *best = [self bestSupportedLanguageForPreferred:@[self.currentLanguageCode]];
@@ -74,7 +88,7 @@ static inline NSMutableDictionary *KBLocBaseKCQuery(void) {
 }
 
 - (void)resetToSystemLanguage {
-    NSString *best = [self bestSupportedLanguageForPreferred:[NSLocale preferredLanguages]] ?: @"en";
+    NSString *best = [self bestSupportedLanguageForPreferred:[NSLocale preferredLanguages]] ?: KBLanguageCodeEnglish;
     [self setCurrentLanguageCode:best persist:NO];
 }
 
@@ -92,7 +106,7 @@ static inline NSMutableDictionary *KBLocBaseKCQuery(void) {
 }
 
 - (NSString *)bestSupportedLanguageForPreferred:(NSArray<NSString *> *)preferred {
-    if (self.supportedLanguageCodes.count == 0) return @"en";
+    if (self.supportedLanguageCodes.count == 0) return KBLanguageCodeEnglish;
     // 1) 完全匹配
     for (NSString *p in preferred) {
         NSString *pLC = p.lowercaseString;
@@ -129,7 +143,7 @@ static inline NSMutableDictionary *KBLocBaseKCQuery(void) {
         }
     }
     // 4) 兜底：取第一个受支持语言
-    return self.supportedLanguageCodes.firstObject ?: @"en";
+    return self.supportedLanguageCodes.firstObject ?: KBLanguageCodeEnglish;
 }
 
 #pragma mark - 内部实现