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:
@@ -1,29 +1,63 @@
|
||||
/**
|
||||
* Plugin API - 为插件提供简洁的访问接口
|
||||
* Plugin API - Provides simple access interface for plugins
|
||||
*
|
||||
* 使用方式:
|
||||
* 使用方式 | Usage:
|
||||
* ```typescript
|
||||
* import { PluginAPI } from '@esengine/editor-runtime';
|
||||
*
|
||||
* const scene = PluginAPI.scene;
|
||||
* const entityStore = PluginAPI.entityStore;
|
||||
* const messageHub = PluginAPI.messageHub;
|
||||
*
|
||||
* // 使用 ServiceToken 获取服务(类型安全)| Get service with ServiceToken (type-safe)
|
||||
* import { AssetManagerToken } from '@esengine/asset-system';
|
||||
* const assetManager = PluginAPI.resolve(AssetManagerToken);
|
||||
* ```
|
||||
*
|
||||
* 这个 API 会自动从全局 __ESENGINE__ 获取正确的实例,
|
||||
* 避免模块实例不一致的问题。
|
||||
* This API automatically gets correct instances from global __ESENGINE__,
|
||||
* avoiding module instance inconsistency issues.
|
||||
*/
|
||||
|
||||
import type { EntityStoreService, MessageHub } from '@esengine/editor-core';
|
||||
import type { Scene, ServiceContainer } from '@esengine/ecs-framework';
|
||||
import type { ServiceToken } from '@esengine/engine-core';
|
||||
|
||||
// 内部 API 接口定义
|
||||
/**
|
||||
* 核心服务接口
|
||||
* Core service interface
|
||||
*
|
||||
* 定义内部 Core 提供的服务访问接口。
|
||||
* Defines service access interface provided by internal Core.
|
||||
*/
|
||||
interface ICoreServices {
|
||||
services: ServiceContainer;
|
||||
}
|
||||
|
||||
/**
|
||||
* 内部 API 接口定义
|
||||
* Internal API interface definition
|
||||
*
|
||||
* 定义全局 __ESENGINE__.api 提供的方法。
|
||||
* Defines methods provided by global __ESENGINE__.api.
|
||||
*/
|
||||
interface IPluginAPIInternal {
|
||||
/** 获取当前场景 | Get current scene */
|
||||
getScene(): Scene | null;
|
||||
/** 获取实体存储服务 | Get entity store service */
|
||||
getEntityStore(): EntityStoreService;
|
||||
/** 获取消息总线 | Get message hub */
|
||||
getMessageHub(): MessageHub;
|
||||
resolveService<T>(serviceType: any): T;
|
||||
getCore(): any;
|
||||
/**
|
||||
* 解析服务(类型安全)
|
||||
* Resolve service (type-safe)
|
||||
* @param token 服务令牌 | Service token
|
||||
*/
|
||||
resolveService<T>(token: ServiceToken<T>): T;
|
||||
/** 获取核心实例 | Get core instance */
|
||||
getCore(): ICoreServices;
|
||||
}
|
||||
|
||||
// 声明全局类型
|
||||
@@ -93,11 +127,24 @@ export const PluginAPI = {
|
||||
},
|
||||
|
||||
/**
|
||||
* 解析服务
|
||||
* @param serviceType 服务类型
|
||||
* 解析服务(类型安全)
|
||||
* Resolve service (type-safe)
|
||||
*
|
||||
* 使用 ServiceToken 获取服务实例,提供完整的类型推断。
|
||||
* Use ServiceToken to get service instance with full type inference.
|
||||
*
|
||||
* @param token 服务令牌 | Service token
|
||||
* @returns 服务实例 | Service instance
|
||||
*
|
||||
* @example
|
||||
* ```typescript
|
||||
* import { AssetManagerToken } from '@esengine/asset-system';
|
||||
* const assetManager = PluginAPI.resolve(AssetManagerToken);
|
||||
* // assetManager 类型自动推断为 IAssetManager
|
||||
* ```
|
||||
*/
|
||||
resolve<T>(serviceType: any): T {
|
||||
return getInternalAPI().resolveService<T>(serviceType);
|
||||
resolve<T>(token: ServiceToken<T>): T {
|
||||
return getInternalAPI().resolveService<T>(token);
|
||||
},
|
||||
|
||||
/**
|
||||
|
||||
Reference in New Issue
Block a user