GFramework/GFramework.Godot.SourceGenerators
GeWuYou 5b996d8618 feat(generator): 添加 BindNodeSignal 源生成器实现
- 实现 BindNodeSignalGenerator 源生成器,用于自动生成 Godot 节点事件绑定与解绑逻辑
- 添加 BindNodeSignalAttribute 特性,标记需要生成绑定逻辑的事件处理方法
- 实现完整的诊断系统,包括嵌套类型、静态方法、字段类型等错误检查
- 添加生命周期方法调用检查,在 _Ready 和 _ExitTree 中验证生成方法的调用
- 支持方法签名与事件委托的兼容性验证
- 实现单元测试覆盖各种使用场景和错误情况
2026-03-31 09:39:06 +08:00
..
2026-03-23 08:28:07 +08:00

GFramework.Godot.SourceGenerators

面向 Godot 场景的源码生成扩展模块,减少模板代码。

主要功能

  • 与 Godot 场景相关的编译期生成能力
  • 基于 Roslyn 的增量生成器实现
  • [GetNode] 字段注入,减少 _Ready() 里的 GetNode<T>() 样板代码

使用建议

  • 仅在 Godot + C# 项目中启用
  • 非 Godot 项目可只使用 GFramework.SourceGenerators

GetNode 用法

using GFramework.Godot.SourceGenerators.Abstractions;
using Godot;

public partial class TopBar : HBoxContainer
{
    [GetNode]
    private HBoxContainer _leftContainer = null!;

    [GetNode]
    private HBoxContainer _rightContainer = null!;

    public override void _Ready()
    {
        __InjectGetNodes_Generated();
        OnReadyAfterGetNode();
    }

    private void OnReadyAfterGetNode()
    {
    }
}

当未显式填写路径时,生成器会默认将字段名推导为唯一名路径:

  • _leftContainer -> %LeftContainer
  • m_rightContainer -> %RightContainer