mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-07 00:39:00 +08:00
ca82b2701c
- 实现基于 YAML 的静态游戏内容配置管理 - 集成 JSON Schema 结构描述与校验功能 - 提供一对象一文件的目录组织方式 - 支持运行时只读查询与类型安全访问 - 添加 Source Generator 自动生成配置类型和表包装 - 实现 VS Code 插件提供配置浏览与编辑功能 - 添加热重载支持开发期实时配置更新 - 提供官方启动帮助器简化初始化流程 - 支持跨表引用校验与关联表联动重载 - 实现强类型查询辅助方法提升开发效率
GFramework.SourceGenerators
Core 侧通用源码生成器模块。
Context Get 注入
当类本身是上下文感知类型时，可以通过字段特性生成一个手动调用的注入方法：
[GetService][GetServices][GetSystem][GetSystems][GetModel][GetModels][GetUtility][GetUtilities][GetAll]
上下文感知类满足以下任一条件即可：
- 类上带有
[ContextAware] - 继承
ContextAwareBase - 实现
IContextAware
生成器会生成 __InjectContextBindings_Generated()，需要在合适的生命周期中手动调用。在 Godot 中通常放在 _Ready()：
using GFramework.SourceGenerators.Abstractions.Rule;
[ContextAware]
public partial class InventoryPanel
{
[GetModel]
private IInventoryModel _inventory = null!;
[GetServices]
private IReadOnlyList<IInventoryStrategy> _strategies = null!;
public override void _Ready()
{
__InjectContextBindings_Generated();
}
}
[GetAll] 作用于类本身，会自动扫描字段并推断 Model、System、Utility 相关的 GetX 调用；已显式标记字段的优先级更高。
Service 和 Services 绑定不会在 [GetAll] 下自动推断。对于普通引用类型字段，请显式使用 [GetService] 或
[GetServices]，避免将非上下文服务字段误判为服务依赖。
[GetAll] 会跳过 const、static 和 readonly 字段。若某个字段本来会被 [GetAll] 推断为
Model、System 或 Utility 绑定，但因为是不可赋值的 static 或 readonly 字段而被跳过，生成器会发出警告提示该字段不会参与生成。
注册分析器
包现在同时包含一个注册可见性分析器，用于检查 Model、System、Utility 的使用点是否能在所属架构中找到静态可见注册。
- 覆盖字段特性注入：
[GetModel]、[GetModels]、[GetSystem]、[GetSystems]、[GetUtility]、[GetUtilities] - 覆盖手写调用：
GetModel<T>()、GetModels<T>()、GetSystem<T>()、GetSystems<T>()、GetUtility<T>()、GetUtilities<T>() - 默认报告
Warning - 当前只分析静态可见的注册路径，例如
OnInitialize()、InstallModules()、InstallModule(new Module())
对于反射、运行时条件分支、外部程序集动态注册等路径，分析器不会强行推断；当无法唯一确定组件所属架构时，也会选择不报，优先降低误报。