常见问题

本页面整理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. 是否需要赞助?有没有支持方式?

目前框架完全免费,且持续更新维护。
如果你希望支持框架发展,可以通过:

  • 爱发电
  • GitHub 点 Star
  • 分享该框架给更多使用 Unity 的朋友

支持方式与反馈渠道详情请见支持与致谢


8. 如果想加入开发与贡献怎么办?

你可以:

  • 提交 Pull Request
  • 贡献文档
  • 分享示例项目
  • 在 Issue 中提出建设性建议

作者非常欢迎所有贡献者参与完善框架。

支持方式与反馈渠道详情请见支持与致谢


9. 框架的未来规划有哪些?

未来版本计划:

  • 完整 Addressables 支持
  • 框架示例项目
  • 优化已有的模块功能