feat(i18n): 统一国际化系统架构,支持插件独立翻译 (#301)
* feat(i18n): 统一国际化系统架构,支持插件独立翻译 ## 主要改动 ### 核心架构 - 增强 LocaleService,支持插件命名空间翻译扩展 - 新增 editor-runtime/i18n 模块,提供 createPluginLocale/createPluginTranslator - 新增 editor-core/tokens.ts,定义 LocaleServiceToken 等服务令牌 - 改进 PluginAPI 类型安全,使用 ServiceToken<T> 替代 any ### 编辑器本地化 - 扩展 en.ts/zh.ts 翻译文件,覆盖所有 UI 组件 - 新增 es.ts 西班牙语支持 - 重构 40+ 组件使用 useLocale() hook ### 插件本地化系统 - behavior-tree-editor: 新增 locales/ 和 useBTLocale hook - material-editor: 新增 locales/ 和 useMaterialLocale hook - particle-editor: 新增 locales/ 和 useParticleLocale hook - tilemap-editor: 新增 locales/ 和 useTilemapLocale hook - ui-editor: 新增 locales/ 和 useUILocale hook ### 类型安全改进 - 修复 Debug 工具使用公共接口替代 as any - 修复 ChunkStreamingSystem 添加 forEachChunk 公共方法 - 修复 blueprint-editor 移除不必要的向后兼容代码 * fix(behavior-tree-editor): 使用 ServiceToken 模式修复服务解析 - 创建 BehaviorTreeServiceToken 遵循"谁定义接口,谁导出Token"原则 - 使用 ServiceToken.id (symbol) 注册服务到 ServiceContainer - 更新 PluginSDKRegistry.resolveService 支持 ServiceToken 检测 - BehaviorTreeEditorPanel 现在使用类型安全的 PluginAPI.resolve * fix(behavior-tree-editor): 使用 ServiceContainer.resolve 获取类注册的服务 * fix: 修复多个包的依赖和类型问题 - core: EntityDataCollector.getEntityDetails 使用 HierarchySystem 获取父实体 - ui-editor: 添加 @esengine/editor-runtime 依赖 - tilemap-editor: 添加 @esengine/editor-runtime 依赖 - particle-editor: 添加 @esengine/editor-runtime 依赖
This commit is contained in:
@@ -15,6 +15,7 @@
|
||||
*/
|
||||
|
||||
import { Core } from '@esengine/ecs-framework';
|
||||
import type { ServiceToken } from '@esengine/engine-core';
|
||||
import {
|
||||
EntityStoreService,
|
||||
MessageHub,
|
||||
@@ -71,8 +72,13 @@ export interface IPluginAPI {
|
||||
getEntityStore(): EntityStoreService;
|
||||
/** 获取 MessageHub | Get MessageHub */
|
||||
getMessageHub(): MessageHub;
|
||||
/** 解析服务 | Resolve service */
|
||||
resolveService<T>(serviceType: any): T;
|
||||
/**
|
||||
* 解析服务 | Resolve service
|
||||
*
|
||||
* 支持 ServiceToken<T>(推荐)或传统的 class/symbol。
|
||||
* Supports ServiceToken<T> (recommended) or legacy class/symbol.
|
||||
*/
|
||||
resolveService<T>(serviceType: ServiceToken<T> | symbol | (new (...args: any[]) => T)): T;
|
||||
/** 获取 Core 实例 | Get Core instance */
|
||||
getCore(): typeof Core;
|
||||
}
|
||||
@@ -185,7 +191,16 @@ export class PluginSDKRegistry {
|
||||
}
|
||||
return messageHubInstance;
|
||||
},
|
||||
resolveService: <T>(serviceType: any): T => Core.services.resolve(serviceType) as T,
|
||||
resolveService: <T>(serviceType: ServiceToken<T> | symbol | (new (...args: any[]) => T)): T => {
|
||||
// 检测是否是 ServiceToken(具有 id: symbol 属性)
|
||||
// Detect if this is a ServiceToken (has id: symbol property)
|
||||
if (serviceType && typeof serviceType === 'object' && 'id' in serviceType && typeof serviceType.id === 'symbol') {
|
||||
return Core.services.resolve(serviceType.id) as T;
|
||||
}
|
||||
// 传统方式:直接使用 class 或 symbol
|
||||
// Legacy: use class or symbol directly
|
||||
return Core.services.resolve(serviceType as symbol) as T;
|
||||
},
|
||||
getCore: () => Core,
|
||||
};
|
||||
}
|
||||
|
||||
@@ -93,14 +93,17 @@ export class SettingsService {
|
||||
/**
|
||||
* 支持的脚本编辑器类型
|
||||
* Supported script editor types
|
||||
*
|
||||
* 使用 nameKey 作为翻译键,如果没有 nameKey 则使用 name 作为显示名称
|
||||
* Use nameKey as translation key, fallback to name if no nameKey
|
||||
*/
|
||||
public static readonly SCRIPT_EDITORS = [
|
||||
{ id: 'system', name: 'System Default', nameZh: '系统默认', command: '' },
|
||||
{ id: 'vscode', name: 'Visual Studio Code', nameZh: 'Visual Studio Code', command: 'code' },
|
||||
{ id: 'cursor', name: 'Cursor', nameZh: 'Cursor', command: 'cursor' },
|
||||
{ id: 'webstorm', name: 'WebStorm', nameZh: 'WebStorm', command: 'webstorm' },
|
||||
{ id: 'sublime', name: 'Sublime Text', nameZh: 'Sublime Text', command: 'subl' },
|
||||
{ id: 'custom', name: 'Custom', nameZh: '自定义', command: '' }
|
||||
{ id: 'system', name: 'System Default', nameKey: 'settings.scriptEditor.systemDefault', command: '' },
|
||||
{ id: 'vscode', name: 'Visual Studio Code', command: 'code' },
|
||||
{ id: 'cursor', name: 'Cursor', command: 'cursor' },
|
||||
{ id: 'webstorm', name: 'WebStorm', command: 'webstorm' },
|
||||
{ id: 'sublime', name: 'Sublime Text', command: 'subl' },
|
||||
{ id: 'custom', name: 'Custom', nameKey: 'settings.scriptEditor.custom', command: '' }
|
||||
];
|
||||
|
||||
/**
|
||||
|
||||
@@ -16,6 +16,14 @@ export interface IDialogExtended extends IDialog {
|
||||
setLocale(locale: string): void;
|
||||
}
|
||||
|
||||
const dialogTranslations = {
|
||||
en: { confirm: 'Confirm', cancel: 'Cancel' },
|
||||
zh: { confirm: '确定', cancel: '取消' },
|
||||
es: { confirm: 'Confirmar', cancel: 'Cancelar' }
|
||||
} as const;
|
||||
|
||||
type LocaleKey = keyof typeof dialogTranslations;
|
||||
|
||||
@singleton()
|
||||
export class TauriDialogService implements IDialogExtended {
|
||||
private showConfirmCallback?: (data: ConfirmDialogData) => void;
|
||||
@@ -70,8 +78,10 @@ export class TauriDialogService implements IDialogExtended {
|
||||
}
|
||||
};
|
||||
|
||||
const confirmText = this.locale === 'zh' ? '确定' : 'Confirm';
|
||||
const cancelText = this.locale === 'zh' ? '取消' : 'Cancel';
|
||||
const localeKey = (this.locale in dialogTranslations ? this.locale : 'en') as LocaleKey;
|
||||
const texts = dialogTranslations[localeKey];
|
||||
const confirmText = texts.confirm;
|
||||
const cancelText = texts.cancel;
|
||||
|
||||
this.showConfirmCallback({
|
||||
title,
|
||||
|
||||
Reference in New Issue
Block a user