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]