From 9f9a421b6cf9b3236e3c08ef485e1344fe70ed68 Mon Sep 17 00:00:00 2001 From: GeWuYou <95328647+GeWuYou@users.noreply.github.com> Date: Thu, 16 Apr 2026 21:16:23 +0800 Subject: [PATCH] =?UTF-8?q?docs(source-generators):=20=E6=B7=BB=E5=8A=A0?= =?UTF-8?q?=E6=BA=90=E4=BB=A3=E7=A0=81=E7=94=9F=E6=88=90=E5=99=A8=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E5=92=8C=E6=8A=BD=E8=B1=A1=E5=8C=85=E9=A1=B9=E7=9B=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 新增完整的 GFramework.SourceGenerators 文档,涵盖所有生成器功能 - 添加 Log 属性生成器、ContextAware 属性生成器、Config Schema 生成器等详细说明 - 包含 Godot 专用生成器如 GetNode、BindNodeSignal、AutoUiPage 等使用指南 - 提供诊断信息、性能优势、使用示例和最佳实践章节 - 创建 Core.SourceGenerators.Abstractions 项目文件和配置 - 集成 Meziantou.Analyzer 和 Meziantou.Polyfill 包引用 - 配置项目构建属性和命名空间引入设置 --- ....Core.SourceGenerators.Abstractions.csproj | 2 +- docs/zh-CN/source-generators/index.md | 22 +++++++++---------- 2 files changed, 12 insertions(+), 12 deletions(-) diff --git a/GFramework.Core.SourceGenerators.Abstractions/GFramework.Core.SourceGenerators.Abstractions.csproj b/GFramework.Core.SourceGenerators.Abstractions/GFramework.Core.SourceGenerators.Abstractions.csproj index 86fe2d35..03d4dd42 100644 --- a/GFramework.Core.SourceGenerators.Abstractions/GFramework.Core.SourceGenerators.Abstractions.csproj +++ b/GFramework.Core.SourceGenerators.Abstractions/GFramework.Core.SourceGenerators.Abstractions.csproj @@ -12,7 +12,7 @@ - + diff --git a/docs/zh-CN/source-generators/index.md b/docs/zh-CN/source-generators/index.md index 224ed96a..c1d65128 100644 --- a/docs/zh-CN/source-generators/index.md +++ b/docs/zh-CN/source-generators/index.md @@ -167,7 +167,7 @@ Config Schema 生成器会扫描 `*.schema.json` 文件,并生成: ### 基础使用 ```csharp -using GFramework.SourceGenerators.Abstractions.Logging; +using GFramework.Core.SourceGenerators.Abstractions.Logging; [Log] public partial class PlayerController @@ -246,7 +246,7 @@ public static partial class MathHelper ```csharp using GFramework.Core.Abstractions.Controller; -using GFramework.SourceGenerators.Abstractions.Rule; +using GFramework.Core.SourceGenerators.Abstractions.Rule; [ContextAware] public partial class PlayerController : IController @@ -354,8 +354,8 @@ public async Task TestPlayerController() ```csharp using GFramework.Core.Abstractions.Controller; -using GFramework.SourceGenerators.Abstractions.Logging; -using GFramework.SourceGenerators.Abstractions.Rule; +using GFramework.Core.SourceGenerators.Abstractions.Logging; +using GFramework.Core.SourceGenerators.Abstractions.Rule; [Log] [ContextAware] @@ -381,7 +381,7 @@ public partial class AdvancedController : IController ### 基础使用 ```csharp -using GFramework.SourceGenerators.Abstractions.Enums; +using GFramework.Core.SourceGenerators.Abstractions.Enums; [GenerateEnumExtensions] public enum GameState @@ -560,7 +560,7 @@ AutoRegisterModule 生成器面向 GFramework 模块安装场景,为类上的 ### 基础示例 ```csharp -using GFramework.SourceGenerators.Abstractions.Architectures; +using GFramework.Core.SourceGenerators.Abstractions.Architectures; [AutoRegisterModule] [RegisterModel(typeof(RunStateModel))] @@ -863,8 +863,8 @@ public class InefficientController : IController ```csharp using GFramework.Core.Abstractions.Controller; -using GFramework.SourceGenerators.Abstractions.Logging; -using GFramework.SourceGenerators.Abstractions.Rule; +using GFramework.Core.SourceGenerators.Abstractions.Logging; +using GFramework.Core.SourceGenerators.Abstractions.Rule; [Log] [ContextAware] @@ -953,8 +953,8 @@ public enum CharacterState } using GFramework.Core.Abstractions.Controller; -using GFramework.SourceGenerators.Abstractions.Logging; -using GFramework.SourceGenerators.Abstractions.Rule; +using GFramework.Core.SourceGenerators.Abstractions.Logging; +using GFramework.Core.SourceGenerators.Abstractions.Rule; [Log] [ContextAware] @@ -1235,7 +1235,7 @@ public partial class ServiceComponent : IService ```mermaid graph TD - A[GFramework.SourceGenerators] --> B[GFramework.SourceGenerators.Abstractions] + A[GFramework.SourceGenerators] --> B[GFramework.Core.SourceGenerators.Abstractions] A --> C[GFramework.SourceGenerators.Common] A --> D[GFramework.Core.Abstractions] A --> E[Microsoft.CodeAnalysis.CSharp]