AlicizaX/Client/Assets/Books/EditorExtension/CustomToolbarItems.md

EditorExtension 自定义工具栏项目模块手册

模块概述

ToolBarExtension 目录在 Toolbar 框架之上实现了一组项目级工具栏元素：

• EditorQuickToolBar
• LocalizationDropdownField
• ResourceModeDropdownField
• SwitchSceneToolBar
• BuildSettingWindow（当前源码为注释模板）

适用场景

• 快速切换语言、资源模式与场景。
• 把项目工具统一收口到主工具栏。
• 自动调度 EditorToolFunctionAttribute 标记的方法。

快速上手

这些类型均通过 MainToolbarElementAttribute 自动挂载，无需手动注册。

可调用 API

类型：AlicizaX.Editor.Extension.EditorQuickToolBar

源码：Packages/com.alicizax.unity.editor.extension/Editor/ToolBarExtension/EditorQuickToolBar.cs

• InitializeElement()：初始化工具下拉按钮。

类型：LocalizationDropdownField

源码：Packages/com.alicizax.unity.editor.extension/Editor/ToolBarExtension/LocalizationDropdownField.cs

• InitializeElement()：初始化语言切换下拉框。
• InvokeOnValidateInScene()：强制刷新场景中所有 UXTextMeshPro 的编辑器预览。

类型：AlicizaX.Editor.Extension.ResourceModeDropdownField

源码：Packages/com.alicizax.unity.editor.extension/Editor/ToolBarExtension/ResourceModeDropdownField.cs

• InitializeElement()：初始化资源模式下拉框。

类型：SwitchSceneToolBar

源码：Packages/com.alicizax.unity.editor.extension/Editor/ToolBarExtension/SwitchSceneToolBar.cs

• InitializeElement()：初始化场景切换按钮并监听场景切换。

类型：BuildSettingWindow

• 说明：当前源码整体注释，无生效公开 API，可作为未来扩展模板。

详细使用说明

EditorQuickToolBar

• 从 EditorToolFunctionAttributeCollector.Attributes 读取菜单项。
• 点击菜单后通过反射执行静态方法。

LocalizationDropdownField

• 读取语言列表并写入 EditorPrefs。
• 切换后会刷新场景里的 UXTextMeshPro 文本预览。

ResourceModeDropdownField

• 提供 Editor / Offline / Host / Webgl 四种模式。
• 模式结果通过 EditorPrefs 持久化。

SwitchSceneToolBar

• 默认扫描 Assets/Bundles/ 与 Assets/Scenes/ 下的场景。
• 切换前会检查当前场景未保存状态。