gewuyou/GFramework
1
0
Fork 0
mirror of https://github.com/GeWuYou/GFramework.git synced 2026-05-07 00:39:00 +08:00
Code Issues Packages Projects Releases Wiki Activity
GFramework/docs/zh-CN/getting-started/index.md
gewuyou 979db3b5a5 docs(reader-facing): 统一站内入口与公开术语 
- 更新入口页的 reader-facing 骨架，统一起步路线、阅读顺序与站内导航
- 收口公开 README 与 Godot 页面中的内部口吻、文件名式表述和术语噪音
- 移除 docs/zh-CN 中残留的 GitHub README 外链，并同步刷新文档治理恢复状态
2026-04-27 08:55:18 +08:00

3.1 KiB
Raw Blame History

title, description
title description
入门指南 概览 GFramework 的模块组成、最小接入路径与继续阅读入口。

入门指南

如果你第一次接触 GFramework，或者还在判断“应该先装哪些包、先看哪一组文档”，先从这里开始最省时间。

这组页面的目标只有一个：帮你用最短路径找到适合当前项目的运行时入口、安装组合和下一步阅读顺序。

适合谁先读本栏

  • 第一次接入 GFramework，还没决定该从 Core、Game、Godot 还是 CQRS 开始
  • 想先确认最小安装组合，再决定是否追加源码生成器
  • 想先跑通一个可运行骨架，再深入某个专题页

按目标选择起步路线

基础运行时起步

从 Core 开始：

  • GeWuYou.GFramework.Core
  • GeWuYou.GFramework.Core.Abstractions

这组包提供：

  • Architecture
  • Model / System / Utility
  • 旧版 Command / Query 执行器
  • 事件、属性、状态机、状态管理、资源、日志、协程等基础设施

对应文档：

新版 CQRS 请求流

在 Core 基础上补：

  • GeWuYou.GFramework.Cqrs
  • GeWuYou.GFramework.Cqrs.Abstractions

这组包提供：

  • 统一 request dispatcher
  • notification publish
  • pipeline behaviors
  • handler 注册与反射回退机制

对应文档：

游戏运行时与内容配置

在 Core 基础上按需补：

  • GeWuYou.GFramework.Game
  • GeWuYou.GFramework.Game.Abstractions

这组包提供：

  • 内容配置系统
  • 数据存取与设置
  • Scene / UI / Routing 抽象与运行时
  • 文件存储和序列化

对应文档：

Godot 项目接入

继续叠加：

  • GeWuYou.GFramework.Godot

对应文档：

什么时候追加源码生成器

只在需要编译期生成代码时再装：

  • GeWuYou.GFramework.Core.SourceGenerators
  • GeWuYou.GFramework.Game.SourceGenerators
  • GeWuYou.GFramework.Cqrs.SourceGenerators
  • GeWuYou.GFramework.Godot.SourceGenerators

典型场景：

  • 自动生成日志、上下文绑定、模块注册代码
  • 从 schema 生成游戏配置类型
  • 为 CQRS handlers 生成注册表
  • 生成 Godot 节点、场景和 UI 包装代码

继续阅读：

建议阅读顺序

  1. 快速开始
  2. 安装配置
  3. 按你的目标进入 基础运行时、游戏运行时、Godot 集成 或 源码生成器
  4. 需要完整示例时，再进入 教程总览