gewuyou/GFramework
1
0
Fork 0
mirror of https://github.com/GeWuYou/GFramework.git synced 2026-05-07 08:44:29 +08:00
Code Issues Packages Projects Releases Wiki Activity
GFramework/GFramework.SourceGenerators.Common
History
gewuyou 1d5404e206 docs(documentation-governance): 收口数据与 UI 文档措辞 
- 更新 Game 数据与存储页面、Godot UI 页面中的 reader-facing 说明，移除内部证据口吻、外部项目指代和生硬导流

- 更新 CQRS 抽象层与 SourceGenerators.Common README 的标签表述，避免暴露源文件路径列表和实现级打包术语

- 补充 documentation-full-coverage-governance 的 RP-050 恢复点、验证结果与 origin/main stop-condition 计量
2026-04-29 13:36:07 +08:00
..
Constants
docs(source-generators): 添加源代码生成器文档和相关常量定义
2026-04-16 21:40:47 +08:00
Diagnostics
feat(generator): 添加 BindNodeSignal 和 GetNode 源代码生成器
2026-03-31 11:11:23 +08:00
Extensions
feat(generator): 添加 BindNodeSignal 和 GetNode 源代码生成器
2026-03-31 11:11:23 +08:00
Generator
docs(style): 更新文档中的命名空间导入格式
2026-03-10 07:18:49 +08:00
Info
feat(generator): 添加上下文感知注入源码生成器
2026-03-28 11:29:40 +08:00
Internals
feat(generator): 添加上下文感知注入源码生成器
2026-03-28 11:29:40 +08:00
AnalyzerReleases.Shipped.md
refactor(godot): 重构源代码生成器依赖结构
2025-12-28 08:54:52 +08:00
AnalyzerReleases.Unshipped.md
feat(generator): 添加 BindNodeSignal 和 GetNode 源代码生成器
2026-03-31 11:11:23 +08:00
Directory.Build.props
feat(build): 修改项目构建配置和依赖管理
2026-04-17 21:11:56 +08:00
GFramework.SourceGenerators.Common.csproj
feat(build): 修改项目构建配置和依赖管理
2026-04-17 21:11:56 +08:00
GlobalUsings.cs
refactor(generators): 统一添加必要的命名空间引用
2026-03-31 12:09:47 +08:00
README.md
docs(documentation-governance): 收口数据与 UI 文档措辞
2026-04-29 13:36:07 +08:00

README.md

GFramework.SourceGenerators.Common

GFramework.SourceGenerators.Common 是 GFramework 多个源码生成器共享的公共支撑目录。它不是独立推广的运行时或 生成器采用入口，而是跟随各个 *.SourceGenerators 模块一起演化的内部基础设施。

目录定位

这个目录当前主要承载三类公共能力：

  • 生成器基类
    • 例如 AttributeClassGeneratorBase、AttributeEnumGeneratorBase、MetadataAttributeClassGeneratorBase
  • 共享诊断
    • 例如 Diagnostics/CommonDiagnostics.cs
  • 共享符号与冲突处理
    • 例如 Extensions/GeneratedMethodConflictExtensions.cs

如果你在 Core、CQRS、Game、Godot 侧生成器里看到相似的诊断或生成冲突语义，通常就是这里在统一约束。

与相邻模块的关系

  • GFramework.Core.SourceGenerators
    • 复用这里的生成器基类和部分通用 diagnostics。
  • GFramework.Cqrs.SourceGenerators
    • 以这里作为编译期公共依赖，并把公共 DLL 一起打进 analyzer 包。
  • GFramework.Godot.SourceGenerators
    • 同样复用这里的公共实现和共享约束。

这个目录不会单独作为消费包提供。对 NuGet 使用者来说，更实际的入口仍然是具体的 GeWuYou.GFramework.*.SourceGenerators 包。

什么时候需要读这里

  • 你在排查多个生成器共有的 diagnostics
  • 你想确认“为什么不同生成器对命名冲突采用同一套规则”
  • 你在扩展或维护生成器，而不是只消费它们

如果你的目标只是“选包并开始使用”，优先回到对应生成器模块 README 和文档专题页。

继续阅读