mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-07 00:39:00 +08:00
8209d7a29f
- 修复公开 README 与 docs 页面中的反问式标题、维护者口吻和裸文件名链接标签 - 补充 AGENTS.md 与 gframework-doc-refresh 的 reader-facing 文档输出约束 - 更新 documentation-full-coverage-governance 的恢复点与验证记录
2.8 KiB
2.8 KiB
title, description
| title | description |
|---|---|
| 入门指南 | 概览 GFramework 的模块组成、最小接入路径与继续阅读入口。 |
入门指南
这一部分只回答三个问题：
GFramework由哪些模块组成- 第一次接入应该从哪个包开始
- 最小可运行路径是什么
如果你还没决定具体用法，先阅读本栏目；如果你已经明确要用某个模块，直接进入对应模块的说明页会更快。
推荐起步路径
只想先把架构跑起来
从 Core 开始：
GeWuYou.GFramework.CoreGeWuYou.GFramework.Core.Abstractions
这组包提供：
ArchitectureModel/System/Utility- 旧版
Command/Query执行器 - 事件、属性、状态机、状态管理、资源、日志、协程等基础设施
对应文档：
想用新版 CQRS
在 Core 基础上补：
GeWuYou.GFramework.CqrsGeWuYou.GFramework.Cqrs.Abstractions
这组包提供：
- 统一 request dispatcher
- notification publish
- pipeline behaviors
- handler 注册与反射回退机制
对应文档：
- CQRS 运行时
- 模块说明：CQRS 运行时说明
想做游戏运行时
在 Core 基础上按需补：
GeWuYou.GFramework.GameGeWuYou.GFramework.Game.Abstractions
这组包提供：
- 内容配置系统
- 数据存取与设置
- Scene / UI / Routing 抽象与运行时
- 文件存储和序列化
对应文档：
- Game 模块总览
- 模块说明：Game 运行时说明
想接入 Godot
继续叠加：
GeWuYou.GFramework.Godot
对应文档：
- Godot 模块总览
- 模块说明：Godot 运行时说明
Source Generators 什么时候装
只在需要编译期生成代码时再装：
GeWuYou.GFramework.Core.SourceGeneratorsGeWuYou.GFramework.Game.SourceGeneratorsGeWuYou.GFramework.Cqrs.SourceGeneratorsGeWuYou.GFramework.Godot.SourceGenerators
典型场景：
- 自动生成日志、上下文绑定、模块注册代码
- 从
schema生成游戏配置类型 - 为 CQRS handlers 生成注册表
- 生成 Godot 节点、场景和 UI 包装代码
建议阅读顺序
- 快速开始
- 你准备使用的模块说明页
- 对应栏目页，例如
core、game、godot - 需要更完整示例时，再进入
tutorials/
注意
- 旧文档里有一些早期示例已经和当前 API 漂移。本栏目以后只保留经过代码或测试核对的最小路径。
- 若根 README、模块 README 与某篇专题页冲突，以模块 README 和当前代码为准。