快速上手:2 分钟做出第一张图
本章目标:按 EasyChart 推荐的最快路径跑通“编辑 → 导出 → 在 UI 中使用”的闭环。
打开编辑器窗口
在 Unity 菜单栏选择:
EasyChart/Library Editor
你会看到一个类似“资源库/配置面板/预览区”的窗口(后续章节会解释每个区域)。
克隆一个 Library(推荐)
如果你想快速开始并保持风格一致,建议:
- 先在窗口顶部工具栏选择一个已有 Library(例如内置 Demo 库)
- 点击工具栏的 Clone,克隆出你的个人库(例如
MyLibrary)
这样你后续所有修改都发生在自己的库里,避免污染原始示例。
克隆一个 ChartProfile(推荐)
在资源树里找到一个接近你目标效果的图表(ChartProfile),右键:
Clone
克隆后,你会得到一个新的 Profile(用于做“同款变体”)。选中它,右侧 Inspector 会显示你可以直接修改的所有配置。
修改配置并保存
最少改动建议:
coordinateSystem:确保与你要的 Series 匹配(例如 Line/Bar/Scatter 用Cartesian2D)series:确认type正确,并填充seriesDataaxes:最少保证 X/Y 轴类型与数据含义匹配
完成修改后,点击窗口顶部工具栏的保存按钮(如果你的版本有),或等待 Unity 自动保存资产。
导出 UXML(用于 UI Builder 复用)
推荐做法是把 Profile 导出为可复用的 .uxml:
- 在资源树里右键你的 Profile
- 选择
Export to UXML
导出的 UXML 会进入:
Assets/EasyChart/LibraryUxml/(Mirror/Backup 相关操作也会在这个根目录下管理导出物)
在 QuickStart 场景里用 UIDocument + UI Builder 使用
打开示例场景:
Assets/EasyChart/Demo/Scenes/EasyChart_QuickStart.unity
然后在 Project 中找到:
Assets/EasyChart/Demo/UIToolKit/NewUXMLTemplate.uxml
双击它打开(或在 UI Builder 中打开)。接下来:
- 从 Project 里把你刚导出的图表
.uxml拖入到NewUXMLTemplate.uxml的层级中 - 保存 UXML
- 确认场景里的
UIDocument引用了你编辑后的NewUXMLTemplate.uxml
运行场景,你会看到图表渲染在 UI Toolkit 页面中。
备选:导出为 UGUI 预制体并使用
如果你希望用 UGUI(Canvas/RectTransform)工作流,也可以在 Library Editor 中把选中的 Profile 导出为 UGUI 预制体并直接放进场景 UI(具体入口与细节取决于你当前版本提供的菜单项)。
下一步你应该看什么
- 你要系统理解 UI Toolkit 推荐工作流:
00-WorkflowAndLibrary.md - 你要用 UGUI(Canvas/RectTransform)把图表用起来:
33-UGUIWorkflow.md