gewuyou/GFramework
1
0
Fork 0
mirror of https://github.com/GeWuYou/GFramework.git synced 2026-05-07 00:39:00 +08:00
Code Issues Packages Projects Releases Wiki Activity
GFramework/GFramework.Core.SourceGenerators.Abstractions/README.md
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

2.1 KiB
Raw Blame History

GFramework.Core.SourceGenerators.Abstractions

GFramework.Core.SourceGenerators.Abstractions 存放 Core 侧源码生成器公开使用的 attribute 和最小契约定义。 它不是单独推广的生成器包，而是 GFramework.Core.SourceGenerators 的支撑层。

目录定位

这里当前主要提供：

  • 架构注册相关特性
    • AutoRegisterModuleAttribute
    • RegisterModelAttribute
    • RegisterSystemAttribute
    • RegisterUtilityAttribute
  • 规则与上下文注入特性
    • ContextAwareAttribute
    • GetModelAttribute
    • GetModelsAttribute
    • GetSystemAttribute
    • GetSystemsAttribute
    • GetUtilityAttribute
    • GetUtilitiesAttribute
    • GetServiceAttribute
    • GetServicesAttribute
    • GetAllAttribute
  • 其他通用生成器特性
    • LogAttribute
    • PriorityAttribute
    • GenerateEnumExtensionsAttribute

这些类型定义“消费端代码可以写什么 attribute”，而实际生成逻辑和 diagnostics 仍在 GFramework.Core.SourceGenerators 中。

与相邻模块的关系

  • GFramework.Core.SourceGenerators
    • 实际读取这里定义的 attribute，并生成代码或 diagnostics。
  • GFramework.SourceGenerators.Common
    • 为 Core 侧生成器提供共享基类和公共约束。

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

什么时候需要读这里

  • 你在确认某个 Core 侧 attribute 的可用参数和命名
  • 你在排查“文档写法”和 attribute 实际公开面是否一致
  • 你在扩展 Core.SourceGenerators，需要先确认契约层边界

如果你的目标只是开始使用生成器，优先回到 Core.SourceGenerators README 和 source-generators 栏目。

继续阅读