GFramework/GFramework.Godot.SourceGenerators.Abstractions
gewuyou b96565ffa3 docs(documentation): 扩展项目功能文档覆盖
- 更新 meta-package 与安装入口,明确聚合范围、当前运行时基线和首页选包路径
- 补充 Game 配置工具文档与导航,把 VS Code config workflow 纳入 reader-facing 采用链路
- 修正文档与实现不一致的 source-generator 与 CQRS 契约说明,补充 support module 边界
- 记录 RP-038 批处理恢复点、委派结论和本轮验证结果
2026-04-25 17:10:37 +08:00
..
2026-04-15 15:34:14 +08:00

GFramework.Godot.SourceGenerators.Abstractions

GFramework.Godot.SourceGenerators.Abstractions 存放 Godot 侧源码生成器公开使用的 attribute 和最小辅助类型。 它不是单独推广的消费包,而是 GFramework.Godot.SourceGenerators 的支撑层。

目录定位

这里当前主要提供:

  • 节点与信号相关特性
    • GetNodeAttribute
    • BindNodeSignalAttribute
  • 场景 / UI / 集合注册相关特性
    • AutoSceneAttribute
    • AutoUiPageAttribute
    • AutoRegisterExportedCollectionsAttribute
    • RegisterExportedCollectionAttribute
  • Godot 项目级辅助类型
    • AutoLoadAttribute
    • GodotModuleMarker
    • NodeLookupMode

这些类型负责定义“消费端项目可以声明哪些特性与参数”而具体的生成逻辑、diagnostics 和生命周期约束仍在 GFramework.Godot.SourceGenerators 中。

与相邻模块的关系

  • GFramework.Godot.SourceGenerators
    • 实际消费这里定义的 attribute并生成节点注入、信号绑定、Scene / UI 包装与项目元数据辅助代码。
  • GFramework.SourceGenerators.Common
    • 为 Godot 侧生成器提供共享基础设施和通用约束。
  • GFramework.Godot
    • 提供运行时宿主与集成层;生成器只负责编译期辅助。

当前目录本身 IsPackable=false。对 NuGet 使用者来说,更实际的入口仍然是 GeWuYou.GFramework.Godot.SourceGenerators;这个 abstractions DLL 会跟随对应 analyzer 包一起交付。

什么时候需要读这里

  • 你在确认 [GetNode][BindNodeSignal][AutoScene] 等特性的公开参数语义
  • 你在排查生成器文档是否和 attribute 契约一致
  • 你在扩展 Godot 侧生成器,想先看清契约层边界

如果你的目标只是把生成器接进项目,优先回到 Godot.SourceGenerators README 和专题页。

继续阅读