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
History
gewuyou ff553977e3 chore(license): 补齐 Apache-2.0 文件头治理 
- 新增许可证文件头检查与修复脚本

- 补充维护者手动修复 PR 工作流和 CI 校验

- 更新贡献指南中的文件头说明

- 补齐仓库维护源码和配置文件的许可证声明
2026-05-03 19:39:49 +08:00
..
Architectures
chore(license): 补齐 Apache-2.0 文件头治理
2026-05-03 19:39:49 +08:00
Bases
chore(license): 补齐 Apache-2.0 文件头治理
2026-05-03 19:39:49 +08:00
Enums
chore(license): 补齐 Apache-2.0 文件头治理
2026-05-03 19:39:49 +08:00
Logging
chore(license): 补齐 Apache-2.0 文件头治理
2026-05-03 19:39:49 +08:00
Rule
chore(license): 补齐 Apache-2.0 文件头治理
2026-05-03 19:39:49 +08:00
Directory.Build.props
chore(license): 补齐 Apache-2.0 文件头治理
2026-05-03 19:39:49 +08:00
GFramework.Core.SourceGenerators.Abstractions.csproj
chore(license): 补齐 Apache-2.0 文件头治理
2026-05-03 19:39:49 +08:00
GlobalUsings.cs
docs: 添加 CQRS 架构模式和游戏配置系统文档
2026-04-16 20:36:15 +08:00
README.md
docs(documentation): 扩展项目功能文档覆盖
2026-04-25 17:10:37 +08:00

README.md

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 栏目。

继续阅读