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 的恢复点与验证记录
113 lines
2.8 KiB
Markdown
113 lines
2.8 KiB
Markdown
---
|
|
title: 入门指南
|
|
description: 概览 GFramework 的模块组成、最小接入路径与继续阅读入口。
|
|
---
|
|
|
|
# 入门指南
|
|
|
|
这一部分只回答三个问题：
|
|
|
|
1. `GFramework` 由哪些模块组成
|
|
2. 第一次接入应该从哪个包开始
|
|
3. 最小可运行路径是什么
|
|
|
|
如果你还没决定具体用法，先阅读本栏目；如果你已经明确要用某个模块，直接进入对应模块的说明页会更快。
|
|
|
|
## 推荐起步路径
|
|
|
|
### 只想先把架构跑起来
|
|
|
|
从 `Core` 开始：
|
|
|
|
- `GeWuYou.GFramework.Core`
|
|
- `GeWuYou.GFramework.Core.Abstractions`
|
|
|
|
这组包提供：
|
|
|
|
- `Architecture`
|
|
- `Model` / `System` / `Utility`
|
|
- 旧版 `Command` / `Query` 执行器
|
|
- 事件、属性、状态机、状态管理、资源、日志、协程等基础设施
|
|
|
|
对应文档：
|
|
|
|
- [Core 模块总览](../core/index.md)
|
|
- [快速开始](./quick-start.md)
|
|
|
|
### 想用新版 CQRS
|
|
|
|
在 `Core` 基础上补：
|
|
|
|
- `GeWuYou.GFramework.Cqrs`
|
|
- `GeWuYou.GFramework.Cqrs.Abstractions`
|
|
|
|
这组包提供：
|
|
|
|
- 统一 request dispatcher
|
|
- notification publish
|
|
- pipeline behaviors
|
|
- handler 注册与反射回退机制
|
|
|
|
对应文档：
|
|
|
|
- [CQRS 运行时](../core/cqrs.md)
|
|
- 模块说明：[CQRS 运行时说明](https://github.com/GeWuYou/GFramework/blob/main/GFramework.Cqrs/README.md)
|
|
|
|
### 想做游戏运行时
|
|
|
|
在 `Core` 基础上按需补：
|
|
|
|
- `GeWuYou.GFramework.Game`
|
|
- `GeWuYou.GFramework.Game.Abstractions`
|
|
|
|
这组包提供：
|
|
|
|
- 内容配置系统
|
|
- 数据存取与设置
|
|
- Scene / UI / Routing 抽象与运行时
|
|
- 文件存储和序列化
|
|
|
|
对应文档：
|
|
|
|
- [Game 模块总览](../game/index.md)
|
|
- 模块说明：[Game 运行时说明](https://github.com/GeWuYou/GFramework/blob/main/GFramework.Game/README.md)
|
|
|
|
### 想接入 Godot
|
|
|
|
继续叠加：
|
|
|
|
- `GeWuYou.GFramework.Godot`
|
|
|
|
对应文档：
|
|
|
|
- [Godot 模块总览](../godot/index.md)
|
|
- 模块说明：[Godot 运行时说明](https://github.com/GeWuYou/GFramework/blob/main/GFramework.Godot/README.md)
|
|
|
|
## Source Generators 什么时候装
|
|
|
|
只在需要编译期生成代码时再装：
|
|
|
|
- `GeWuYou.GFramework.Core.SourceGenerators`
|
|
- `GeWuYou.GFramework.Game.SourceGenerators`
|
|
- `GeWuYou.GFramework.Cqrs.SourceGenerators`
|
|
- `GeWuYou.GFramework.Godot.SourceGenerators`
|
|
|
|
典型场景：
|
|
|
|
- 自动生成日志、上下文绑定、模块注册代码
|
|
- 从 `schema` 生成游戏配置类型
|
|
- 为 CQRS handlers 生成注册表
|
|
- 生成 Godot 节点、场景和 UI 包装代码
|
|
|
|
## 建议阅读顺序
|
|
|
|
1. [快速开始](./quick-start.md)
|
|
2. 你准备使用的模块说明页
|
|
3. 对应栏目页，例如 `core`、`game`、`godot`
|
|
4. 需要更完整示例时，再进入 `tutorials/`
|
|
|
|
## 注意
|
|
|
|
- 旧文档里有一些早期示例已经和当前 API 漂移。本栏目以后只保留经过代码或测试核对的最小路径。
|
|
- 若根 README、模块 README 与某篇专题页冲突，以模块 README 和当前代码为准。
|