常见问题
本页面整理Fink Framework 在使用过程中可能遇到的常见问题与解决方案。
1. 该框架支持哪些 Unity 版本?
目前推荐使用 Unity 2022.3 LTS 及以上版本。
框架在实现上兼容 Unity 2021,但部分模块(如 URP UI Camera Stack)更适用于 2022+。
2. 调用了 GetPanel 但返回为空?
GetPanel 只会返回已经创建或正在加载的面板。
要使用面板前必须先调用:
UIManager.Instance.ShowPanel<SomePanel>();
未显示过的面板不会通过 GetPanel 自动创建。
3. 面板已经隐藏,再次显示没有刷新?
面板的刷新逻辑应写在:
public override void OnShow()
而不是 ShowMe。
ShowMe 只在首次实例化时执行一次。
4. 框架是否适用于 VR 项目?
是的。且部分功能基于VR项目定制开发,例如:
- WorldSpace UI 管线完整支持
- XR EventSystem 自动切换
- 多 Canvas(HUD、HandMenu、WorldPanel)管理
其余模块如 TimerManager/EventManager/ResManager 等都与 VR 完全兼容。
5. 为什么表格无法自动生成数据文件?
检查以下情况:
- 表头是否有空字段名
- 字段类型是否拼写错误
- Excel 文件是否放在指定目录
- Excel 文件是否处于打开状态导致无法读取
ExcelTool 通常会在日志中标明具体问题。
6. 是否可以商用?是否可以二开?
可以商用,可以二次开发。Fink Framework 以 MIT License 完全开源,允许自由地使用、修改、分发与商用框架代码。
MIT 协议的唯一要求是:在二次分发框架代码时,需保留原始的 LICENSE 文件与版权声明。
除此之外,没有任何限制。你可以放心进行二次开发、扩展功能或将其集成到商业项目中。
7. 是否需要赞助?有没有支持方式?
目前框架完全免费,且持续更新维护。
如果你希望支持框架发展,可以通过:
支持方式与反馈渠道详情请见支持与致谢。
8. 如果想加入开发与贡献怎么办?
你可以:
- 提交 Pull Request
- 贡献文档
- 分享示例项目
- 在 Issue 中提出建设性建议
作者非常欢迎所有贡献者参与完善框架。
支持方式与反馈渠道详情请见支持与致谢。
9. 框架的未来规划有哪些?
未来版本计划:
- 完整 Addressables 支持
- 框架示例项目
- 优化已有的模块功能